Module org.jnetpcap

Package org.jnetpcap.internal

Class StandardPcapDispatcher

java.lang.Object

org.jnetpcap.internal.StandardPcapDispatcher

All Implemented Interfaces:

AutoCloseable, PcapDispatcher, PcapHandler, PcapHandler.NativeCallback

public class StandardPcapDispatcher
extends Object
implements PcapDispatcher

A proxy PcapHandler, which receives packets from native pcap handle and forwards all packets to the sink java PcapHandler.

Nested Class Summary

Nested classes/interfaces inherited from interface org.jnetpcap.PcapHandler

PcapHandler.NativeCallback, PcapHandler.OfArray<U>, PcapHandler.OfByteBuffer<U>, PcapHandler.OfMemorySegment<U>

Field Summary

Fields

Modifier and Type	Field	Description
protected final Arena	arena	The arena.

Constructor Summary

Constructors

Constructor	Description
StandardPcapDispatcher(MemorySegment pcapHandle, PcapHeaderABI abi, Runnable breakDispatch)	Instantiates a new standard pcap dispatcher.

Method Summary

Modifier and Type	Method	Description
int	captureLength(MemorySegment headerAddress)	Capture length.
void	close()	Close.
final int	dispatchNative(int count, PcapHandler.NativeCallback handler, MemorySegment user)	Dispatch native.
final int	dispatchRaw(int count, MemorySegment callbackFunc, MemorySegment userData)	Dispatch raw.
final String	geterr()	Gets the last pcap error string.
protected String	getErrorString(int error)	Dynamic non-pcap utility method to convert libpcap error code to a string, by various fallback methods with an active pcap handle.
final RuntimeException	getUncaughtException()	Gets the uncaught exception.
int	headerLength(MemorySegment headerAddress)	Header length.
final void	interrupt()	Interrupt.
final int	loopNative(int count, PcapHandler.NativeCallback handler, MemorySegment user)	Loop native.
final int	loopRaw(int count, MemorySegment callbackFunc, MemorySegment userData)	Loop raw.
final void	nativeCallback(MemorySegment user, MemorySegment header, MemorySegment packet)	Native callback.
PcapPacketRef	next()	Next.
PcapPacketRef	nextEx()	Next ex.
final void	onNativeCallbackException(RuntimeException e)	Called on a native callback exception within the user handler.
PcapHeaderABI	pcapHeaderABI()	Pcap header ABI.
final void	setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler exceptionHandler)	Sets the uncaught exception handler.

Methods inherited from class java.lang.Object

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

Field Details

arena

protected final Arena arena

The arena.

Constructor Details

StandardPcapDispatcher

public StandardPcapDispatcher(MemorySegment pcapHandle,
 PcapHeaderABI abi,
 Runnable breakDispatch)

Instantiates a new standard pcap dispatcher.

Parameters:

pcapHandle - the pcap handle

abi - the abi

breakDispatch - the break dispatch

Method Details

geterr

public final String geterr()

Gets the last pcap error string.

Returns:

the err

captureLength

public int captureLength(MemorySegment headerAddress)

Capture length.

Specified by:

captureLength in interface PcapDispatcher

Parameters:

headerAddress - the header address

Returns:

the int

See Also:

• PcapDispatcher.captureLength(java.lang.foreign.MemorySegment)

close

public void close()

Close.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface PcapDispatcher

See Also:

• AutoCloseable.close()

dispatchNative

public final int dispatchNative(int count,
 PcapHandler.NativeCallback handler,
 MemorySegment user)

Description copied from interface: PcapDispatcher

Dispatch native.

Specified by:

dispatchNative in interface PcapDispatcher

Parameters:

count - the count

handler - the handler

user - the user

Returns:

the int

See Also:

• PcapDispatcher.dispatchNative(int, org.jnetpcap.PcapHandler.NativeCallback, java.lang.foreign.MemorySegment)

dispatchRaw

public final int dispatchRaw(int count,
 MemorySegment callbackFunc,
 MemorySegment userData)

Dispatch raw.

Specified by:

dispatchRaw in interface PcapDispatcher

Parameters:

count - the count

callbackFunc - the callback func

userData - the user data

Returns:

the int

getUncaughtException

public final RuntimeException getUncaughtException()

Gets the uncaught exception.

Specified by:

getUncaughtException in interface PcapDispatcher

Returns:

the uncaughtException

headerLength

public int headerLength(MemorySegment headerAddress)

Header length.

Specified by:

headerLength in interface PcapDispatcher

Parameters:

headerAddress - the header address

Returns:

the int

See Also:

• PcapDispatcher.headerLength(java.lang.foreign.MemorySegment)

interrupt

public final void interrupt()

Description copied from interface: PcapDispatcher

Interrupt.

Specified by:

interrupt in interface PcapDispatcher

See Also:

• PcapDispatcher.interrupt()

loopNative

public final int loopNative(int count,
 PcapHandler.NativeCallback handler,
 MemorySegment user)

Description copied from interface: PcapDispatcher

Loop native.

Specified by:

loopNative in interface PcapDispatcher

Parameters:

count - the count

handler - the handler

user - the user

Returns:

the int

See Also:

• PcapDispatcher.loopNative(int, org.jnetpcap.PcapHandler.NativeCallback, java.lang.foreign.MemorySegment)

loopRaw

public final int loopRaw(int count,
 MemorySegment callbackFunc,
 MemorySegment userData)

Loop raw.

Specified by:

loopRaw in interface PcapDispatcher

Parameters:

count - the count

callbackFunc - the callback func

userData - the user data

Returns:

the int

nativeCallback

public final void nativeCallback(MemorySegment user,
 MemorySegment header,
 MemorySegment packet)

Native callback.

Specified by:

nativeCallback in interface PcapHandler.NativeCallback

Parameters:

user - the user

header - the header

packet - the packet

See Also:

• invalid reference

  org.jnetpcap.Pcap0_4.MemorySegmentCallback#nativeCallback(java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment)

onNativeCallbackException

public final void onNativeCallbackException(RuntimeException e)

Called on a native callback exception within the user handler.

Specified by:

onNativeCallbackException in interface PcapDispatcher

Parameters:

e - the exception

setUncaughtExceptionHandler

public final void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler exceptionHandler)

Description copied from interface: PcapDispatcher

Sets the uncaught exception handler.

Specified by:

setUncaughtExceptionHandler in interface PcapDispatcher

Parameters:

exceptionHandler - the new uncaught exception handler

See Also:

• PcapDispatcher.setUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler)

pcapHeaderABI

public PcapHeaderABI pcapHeaderABI()

Pcap header ABI.

Specified by:

pcapHeaderABI in interface PcapDispatcher

Returns:

the pcap header ABI

See Also:

• PcapDispatcher.pcapHeaderABI()

getErrorString

protected String getErrorString(int error)

Dynamic non-pcap utility method to convert libpcap error code to a string, by various fallback methods with an active pcap handle.

Parameters:

error - the code

Returns:

the error string

nextEx

public PcapPacketRef nextEx()
                     throws PcapException,
TimeoutException

Next ex.

Specified by:

nextEx in interface PcapDispatcher

Returns:

the pcap packet ref

Throws:

PcapException - the pcap exception

TimeoutException - the timeout exception

See Also:

• PcapDispatcher.nextEx()

next

public PcapPacketRef next()
                   throws PcapException

Next.

Specified by:

next in interface PcapDispatcher

Returns:

the pcap packet ref

Throws:

PcapException - the pcap exception

See Also:

• PcapDispatcher.next()