CREDITS

This is a small library build on top of JNetPcap library (www.jnetpcap.org).
JNetPcap is created and maintained by Sly Technologies, Inc. so all credits
should go to them.

This library, JNetBridge, is developed by Gremwell (www.gremwell.com). Please
use the following email for all enquiries and bug reports: info@gremwell.com.

LICENCE

The library is licenced under LGPL, like jnetpcap.

You are free to use it the way you like. If you have used it in your software,
please drop me a line.

INTENDED USE

It is intended to be used by applications that need to send and receive
network packets from multiple network interfaces simultaneously. It uses
jnetpcap in a thread-safe way and offers an easy to use API.

REQUIREMENTS

The library relies on libpcap 1.0.0, the latest version of libpcap library
as of time of writing. One way to check the version of libpcap library is
to run 'tcpdump -V':

	$ tcpdump -V
	tcpdump version 4.0.0
	libpcap version 1.0.0

In theory, older versions of libpcap can be supported with minor performance
degradation. Drop me a line if you need it.

The library was tested on Ubuntu Linux 10.04 LTS. You may encounter library
dependency problems on other Linux flavours. Have a look here at this post
on jnetpcap forum http://jnetpcap.com/node/717 or contact me for help.

The library is distributed with .so files for Linux only. I expect it to
work on Windows without modification, like jnetpcap supposedly does. Try to
install winpcap and grab necessary DLL files from jnetpcap if you need to
use it on Windows. Contact me if you need help with it.

EXAMPLE

See src/com/gremwell/jnetbridge/TransparentBridge.java for a simple
implementation of a transparent bridge. It can be run as following:

$ sudo jnetbridge-0.1/jnetbridge.sh vmnet11 vmnet12
port0: received=0, sent=0, receiveError=0, sendError=0, egQueue=0, pcapDrop=0, pcapIfDrop=0, pcapRecv=0
port1: received=0, sent=0, receiveError=0, sendError=0, egQueue=0, pcapDrop=0, pcapIfDrop=0, pcapRecv=0
port0: received=0, sent=0, receiveError=0, sendError=0, egQueue=0, pcapDrop=0, pcapIfDrop=0, pcapRecv=0