Package pcap.api

Class Pcaps

java.lang.Object

pcap.api.Pcaps

Direct Known Subclasses:

PcapLive, PcapOffline

@Inclubating
public abstract class Pcaps
extends java.lang.Object

Author:

Ardika Rommy Sanjaya

Constructor Summary

Constructors

Constructor	Description
Pcaps()

Method Summary

Modifier and Type	Method	Description
static Pcap	live(PcapLive pcapLive)	Open live capture handle.
static Inet4Address	lookupInet4Address(Interface source)	Lookup Inet4Address from Interface.
static Inet6Address	lookupInet6Address(Interface source)	Lookup Inet6Address from Interface.
static Interface	lookupInterface()	Lookup interface can be used to open Pcap live handle.
static Interface	lookupInterface(java.lang.String name)	Find interface by name.
static Interface	lookupInterfaces()	Find all interfaces on your system.
static MacAddress	lookupMacAddress(Interface source)	Get mac address for given Interface.
static Pcap	offline(PcapOffline pcapOffline)	Open offline handle.
static java.lang.String	version()	Get native pcap library version.

Methods inherited from class java.lang.Object

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

Constructor Details

Pcaps

public Pcaps()

Method Details

offline

public static Pcap offline(PcapOffline pcapOffline) throws ErrorException

Open offline handle.

Parameters:

pcapOffline - pcap offline option.

Returns:

returns Pcap live handle.

Throws:

ErrorException - generic exeception.

live

public static Pcap live(PcapLive pcapLive) throws InterfaceNotSupportTimestampTypeException, InterfaceNotUpException, RadioFrequencyModeNotSupportedException, ActivatedException, PermissionDeniedException, NoSuchDeviceException, PromiscuousModePermissionDeniedException, ErrorException, TimestampPrecisionNotSupportedException

Open live capture handle.

Parameters:

pcapLive - pcap live option.

Returns:

returns Pcap offline handle.

Throws:

InterfaceNotSupportTimestampTypeException - timestamp type not supported by interface.

InterfaceNotUpException - interface is not up.

RadioFrequencyModeNotSupportedException - radio frequency mode is not supported.

ActivatedException - a handle is already activated or need to activated.

PermissionDeniedException - you have no permission to open live handle with current user.

NoSuchDeviceException - no such device can be use to open live handle.

PromiscuousModePermissionDeniedException - you have no permission to enable promiscuous mode.

ErrorException - generic error.

TimestampPrecisionNotSupportedException - timestamp precision not supported.

lookupInterfaces

public static Interface lookupInterfaces() throws ErrorException

Find all interfaces on your system.

Returns:

returns iterable Interface's.

Throws:

ErrorException - generic error.

lookupInterface

public static Interface lookupInterface(java.lang.String name) throws ErrorException

Find interface by name.

Parameters:

name - interface name.

Returns:

returns Interface.

Throws:

ErrorException - interface not found.

lookupInterface

public static Interface lookupInterface() throws ErrorException

Lookup interface can be used to open Pcap live handle.

Returns:

returns Interface.

Throws:

ErrorException - generic error.

lookupMacAddress

public static MacAddress lookupMacAddress(Interface source) throws ErrorException

Get mac address for given Interface.

Parameters:

source - interface.

Returns:

returns MacAddress for given interface.

Throws:

ErrorException - error occured.

lookupInet4Address

public static Inet4Address lookupInet4Address(Interface source) throws ErrorException

Lookup Inet4Address from Interface.

Parameters:

source - Interface.

Returns:

returns Inet4Address.

Throws:

ErrorException - address not found.

lookupInet6Address

public static Inet6Address lookupInet6Address(Interface source) throws ErrorException

Lookup Inet6Address from Interface.

Parameters:

source - Interface.

Returns:

returns Inet6Address.

Throws:

ErrorException - address not found.

version

public static java.lang.String version()

Get native pcap library version.

Returns:

returns native pcap library version.