Module org.pcap4j.core

Package org.pcap4j.core

Class PcapNetworkInterface

java.lang.Object

org.pcap4j.core.PcapNetworkInterface

public final class PcapNetworkInterface
extends Object

Since:

pcap4j 0.9.1

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	PcapNetworkInterface.PromiscuousMode

Field Summary

Fields

Modifier and Type	Field	Description
private final List<PcapAddress>	addresses
private final String	description
private final List<LinkLayerAddress>	linkLayerAddresses
private final boolean	local
private static final org.slf4j.Logger	logger
private final boolean	loopBack
private final String	name
private static final int	PCAP_IF_LOOPBACK
private static final int	PCAP_IF_RUNNING
private static final int	PCAP_IF_UP
private final boolean	running
private final boolean	up

Constructor Summary

Constructors

Modifier	Constructor	Description
private	PcapNetworkInterface(NativeMappings.pcap_if pif, boolean local)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
List<PcapAddress>	getAddresses()
String	getDescription()
ArrayList<LinkLayerAddress>	getLinkLayerAddresses()
private MacAddress	getMacAddress(String nifName)
String	getName()
int	hashCode()
boolean	isLocal()
boolean	isLoopBack()	Returns if this network interface is loopback.
boolean	isRunning()	Returns if this network interface is running.
boolean	isUp()	Returns if this network interface is up.
(package private) static PcapNetworkInterface	newInstance(NativeMappings.pcap_if pif, boolean local)
PcapHandle	openLive(int snaplen, PcapNetworkInterface.PromiscuousMode mode, int timeoutMillis)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

logger

private static final org.slf4j.Logger logger

PCAP_IF_LOOPBACK

private static final int PCAP_IF_LOOPBACK

See Also:

• Constant Field Values

PCAP_IF_UP

private static final int PCAP_IF_UP

See Also:

• Constant Field Values

PCAP_IF_RUNNING

private static final int PCAP_IF_RUNNING

See Also:

• Constant Field Values

name

private final String name

description

private final String description

addresses

private final List<PcapAddress> addresses

linkLayerAddresses

private final List<LinkLayerAddress> linkLayerAddresses

loopBack

private final boolean loopBack

up

private final boolean up

running

private final boolean running

local

private final boolean local

Constructor Details

PcapNetworkInterface

private PcapNetworkInterface(NativeMappings.pcap_if pif,
 boolean local)

Method Details

newInstance

static PcapNetworkInterface newInstance(NativeMappings.pcap_if pif,
 boolean local)

getName

public String getName()

Returns:

name

getDescription

public String getDescription()

Returns:

description

getAddresses

public List<PcapAddress> getAddresses()

Returns:

inet addresses

getLinkLayerAddresses

public ArrayList<LinkLayerAddress> getLinkLayerAddresses()

Returns:

link layer addresses

isLoopBack

public boolean isLoopBack()

Returns if this network interface is loopback. This method may always return false on some environments.

Returns:

true if the network interface represented by this object is a loop back interface; false otherwise.

isUp

public boolean isUp()

Returns if this network interface is up. This method may always return false on some environments.

Returns:

true if the network interface represented by this object is up; false otherwise.

isRunning

public boolean isRunning()

Returns if this network interface is running. This method may always return false on some environments.

Returns:

true if the network interface represented by this object is running; false otherwise.

isLocal

public boolean isLocal()

Returns:

true if the network interface represented by this object is a local interface; false otherwise.

openLive

public PcapHandle openLive(int snaplen,
 PcapNetworkInterface.PromiscuousMode mode,
 int timeoutMillis)
                    throws PcapNativeException

Parameters:

snaplen - Snapshot length, which is the number of bytes captured for each packet.

mode - mode

timeoutMillis - Read timeout. Most OSs buffer packets. The OSs pass the packets to Pcap4j after the buffer gets full or the read timeout expires. Must be non-negative. May be ignored by some OSs. 0 means disable buffering on Solaris. 0 means infinite on the other OSs. 1 through 9 means infinite on Solaris.

Returns:

a new PcapHandle object.

Throws:

PcapNativeException - if an error occurs in the pcap native library.

getMacAddress

private MacAddress getMacAddress(String nifName)

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object