Module org.pcap4j.core

Package org.pcap4j.core

Class Pcaps

java.lang.Object

org.pcap4j.core.Pcaps

public final class Pcaps
extends Object

Since:

pcap4j 0.9.1

Field Summary

Fields

Modifier and Type	Field	Description
private static final Object	lock
private static final org.slf4j.Logger	logger

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Pcaps()

Method Summary

Modifier and Type	Method	Description
static BpfProgram	compileFilter(int snaplen, DataLinkType dlt, String bpfExpression, BpfProgram.BpfCompileMode mode, Inet4Address netmask)
static DataLinkType	dataLinkNameToVal(String name)
static String	dataLinkTypeToDescription(DataLinkType dlt)
static String	dataLinkTypeToName(DataLinkType dlt)
static String	dataLinkValToDescription(int dataLinkVal)
static String	dataLinkValToName(int dataLinkVal)
static List<PcapNetworkInterface>	findAllDevs()	Gets all devices.
static PcapNetworkInterface	getDevByAddress(InetAddress addr)	Gets a device by IP address.
static PcapNetworkInterface	getDevByName(String name)	Gets a device by name.
static String	libVersion()
static String	lookupDev()
static Inet4NetworkAddress	lookupNet(String devName)
static PcapHandle	openDead(DataLinkType dlt, int snaplen)
static PcapHandle	openDead(DataLinkType dlt, int snaplen, PcapHandle.TimestampPrecision precision)
static PcapHandle	openOffline(String filePath)
static PcapHandle	openOffline(String filePath, PcapHandle.TimestampPrecision precision)
static String	strError(int error)
static String	toBpfString(InetAddress inetAddr)
static String	toBpfString(MacAddress macAddr)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

logger

private static final org.slf4j.Logger logger

lock

private static final Object lock

Constructor Details

Pcaps

private Pcaps()

Method Details

findAllDevs

public static List<PcapNetworkInterface> findAllDevs()
                                              throws PcapNativeException

Gets all devices.

Returns:

a list of PcapNetworkInterfaces.

Throws:

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

getDevByAddress

public static PcapNetworkInterface getDevByAddress(InetAddress addr)
                                            throws PcapNativeException

Gets a device by IP address.

Parameters:

addr - addr

Returns:

a PcapNetworkInterface.

Throws:

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

getDevByName

public static PcapNetworkInterface getDevByName(String name)
                                         throws PcapNativeException

Gets a device by name.

Parameters:

name - name

Returns:

a PcapNetworkInterface.

Throws:

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

lookupDev

public static String lookupDev()
                        throws PcapNativeException

Returns:

a name of a network interface.

Throws:

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

lookupNet

public static Inet4NetworkAddress lookupNet(String devName)
                                     throws PcapNativeException

Parameters:

devName - devName

Returns:

an Inet4NetworkAddress object.

Throws:

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

openOffline

public static PcapHandle openOffline(String filePath)
                              throws PcapNativeException

Parameters:

filePath - "-" means stdin

Returns:

a new PcapHandle object.

Throws:

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

openOffline

public static PcapHandle openOffline(String filePath,
 PcapHandle.TimestampPrecision precision)
                              throws PcapNativeException

Parameters:

filePath - "-" means stdin

precision - precision

Returns:

a new PcapHandle object.

Throws:

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

openDead

public static PcapHandle openDead(DataLinkType dlt,
 int snaplen)
                           throws PcapNativeException

Parameters:

dlt - dlt

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

Returns:

a new PcapHandle object.

Throws:

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

openDead

public static PcapHandle openDead(DataLinkType dlt,
 int snaplen,
 PcapHandle.TimestampPrecision precision)
                           throws PcapNativeException

Parameters:

dlt - dlt

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

precision - precision

Returns:

a new PcapHandle object.

Throws:

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

compileFilter

public static BpfProgram compileFilter(int snaplen,
 DataLinkType dlt,
 String bpfExpression,
 BpfProgram.BpfCompileMode mode,
 Inet4Address netmask)
                                throws PcapNativeException

Parameters:

snaplen - snaplen

dlt - dlt

bpfExpression - bpfExpression

mode - mode

netmask - netmask

Returns:

a BpfProgram object.

Throws:

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

dataLinkNameToVal

public static DataLinkType dataLinkNameToVal(String name)
                                      throws PcapNativeException

Parameters:

name - a data link type name, which is a DLT_ name with the DLT_ removed.

Returns:

a DataLinkType object.

Throws:

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

dataLinkTypeToName

public static String dataLinkTypeToName(DataLinkType dlt)
                                 throws PcapNativeException

Parameters:

dlt - dlt

Returns:

data link type name

Throws:

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

dataLinkValToName

public static String dataLinkValToName(int dataLinkVal)
                                throws PcapNativeException

Parameters:

dataLinkVal - dataLinkVal

Returns:

data link type name

Throws:

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

dataLinkTypeToDescription

public static String dataLinkTypeToDescription(DataLinkType dlt)
                                        throws PcapNativeException

Parameters:

dlt - dlt

Returns:

a short description of that data link type.

Throws:

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

dataLinkValToDescription

public static String dataLinkValToDescription(int dataLinkVal)
                                       throws PcapNativeException

Parameters:

dataLinkVal - dataLinkVal

Returns:

a short description of that data link type.

Throws:

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

strError

public static String strError(int error)

Parameters:

error - error

Returns:

an error message.

libVersion

public static String libVersion()

Returns:

a string giving information about the version of the libpcap library being used; note that it contains more information than just a version number.

toBpfString

public static String toBpfString(InetAddress inetAddr)

Parameters:

inetAddr - Inet4Address or Inet6Address

Returns:

a string representation of an InetAddress for BPF.

toBpfString

public static String toBpfString(MacAddress macAddr)

Parameters:

macAddr - macAddr

Returns:

a string representation of a MAC address for BPF.