Module org.jnetpcap

Package org.jnetpcap

Class PcapDumper

java.lang.Object

org.jnetpcap.PcapDumper

All Implemented Interfaces:

Flushable, AutoCloseable

public class PcapDumper
extends Object
implements AutoCloseable, Flushable

Dump packets to a capture file.

Author:

Sly Technologies Inc, repos@slytechs.com, mark

Method Summary

Modifier and Type	Method	Description
void	close()	Close a savefile being written to.
void	dump(MemorySegment header, MemorySegment packet)	Write a packet to a capture file.
MemorySegment	dumpFile()	Get the OS standard I/O stream for a savefile being written.
void	flush()	Flush to a savefile packets dumped.
String	toString()	Information about this pcap dumper.

Methods inherited from class java.lang.Object

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

Method Details

close

public void close()

Close a savefile being written to.

Closes the ``savefile.''

Specified by:

close in interface AutoCloseable

Since:

libpcap 0.4

See Also:

• AutoCloseable.close()

dump

public void dump(MemorySegment header,
 MemorySegment packet)
          throws IOException

Write a packet to a capture file.

pcap_dump() outputs a packet to the ``savefile'' opened with pcap_dump_open(3PCAP). Note that its calling arguments are suitable for use with pcap_dispatch(3PCAP) or pcap_loop(3PCAP). If called directly, the user parameter is of type pcap_dumper_t as returned by pcap_dump_open().

Parameters:

header - the header

packet - the packet

Throws:

IOException - Signals that an I/O exception has occurred.

Since:

libpcap 0.4

dumpFile

public MemorySegment dumpFile()

Get the OS standard I/O stream for a savefile being written.

Returns:

address to OS's stream I/O handle

Since:

libpcap 0.8

See Also:

• FILE *pcap_dump_file(pcap_dumper_t *p)

flush

public void flush()
           throws IOException

Flush to a savefile packets dumped.

pcap_dump_flush() flushes the output buffer to the ``savefile,'' so that any packets written with pcap_dump(3PCAP) but not yet written to the ``savefile'' will be written.

Specified by:

flush in interface Flushable

Throws:

IOException - Signals that an I/O exception has occurred.

Since:

libpcap 0.8

See Also:

• Flushable.flush()

toString

public String toString()

Information about this pcap dumper.

Overrides:

toString in class Object

Returns:

the formatted string