org.pcap4j.core

Class Pcaps

java.lang.Object

org.pcap4j.core.Pcaps

public final class Pcaps
extends Object

Since:

pcap4j 0.9.1

Author:

Kaito Yamada

Method Summary

Methods

Modifier and Type	Method and 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()
static PcapNetworkInterface	getDevByAddress(InetAddress addr)
static PcapNetworkInterface	getDevByName(String 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

Method Detail

findAllDevs

public static List<PcapNetworkInterface> findAllDevs()
                                              throws PcapNativeException

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

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

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.