a library version of FreeBSD's TCP/IP stack plus extras
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
lib
mk When using clang, add -Wno-error-shift-negative-value to compiler Jan 6, 2016
sys
.gitignore
LAYOUT Updated LAYOUT and README Feb 16, 2014
Makefile Increase Makefile consistency. Sep 25, 2014
README Updated README. Mar 24, 2016
cflags.mk Only build sysctl, vmstat, and related libraries on FreeBSD. Sep 25, 2014
lib.mk Fix TOPDIR-relative paths (this is TOPDIR from wanproxy's May 10, 2014

README

UINET (User INET)
=============================================================================

This is a user-space port of the FreeBSD TCP/IP stack, begun with the
FreeBSD 9.1-RELEASE sources and many pieces of Kip Macy's user-space
port of an earlier version of the FreeBSD stack, libplebnet.

Unlike the stock FreeBSD TCP/IP stack, this stack can initiate and
terminate arbitrary TCP/IP connections, including those on
arbitrarily-nested VLANs.  Listen sockets can be bound to a wildcard
IP address (across everything on the wire, not just local interfaces),
wildcard port, and specific VLAN tag stacks.  L2 information for
accepted connections is available to the application.  Outbound
connections can be bound to any IP and port, as well as any MAC
address and VLAN tag stack.

This stack can also passively reconstruct TCP streams using a copy of
those streams' bidirectional packet flow.  Reconstruction can continue
even in the face of packet loss (in which case zero-filled holes in
the affected streams are reported to the application).

Packet I/O is currently accomplished via netmap or libpcap (although
the latter interface is relatively new and untested).


Branches
=============================================================================

The most up-to-date sources are on master.

A large merge to master was performed on 24 March 2016, which includes
API churn.  The pre-merge point was tagged as master_20160324.


Building libuinet and the sample programs
=============================================================================

GNU make is used to build libuinet and its sample programs.  Under
Linux, this is simply 'make', while under FreeBSD, this is available
as gmake.  The instructions that follow refer to 'gmake'.

To build everything after a clean checkout:

gmake 

To rebuild everything from scratch at any point:

gmake clean config all

If your netmap includes are not in the system include path,

gmake NETMAP_INCLUDES=<path to netmap includes> [targets...]

The make variable DEBUG_FLAGS provides a quick way to adjust the
optimization level and debug symbol generation.  For example:

gmake DEBUG_FLAGS="-O2 -ggdb" clean config all

The core of the demo programs are implemented in lib/libuinet_demo.
They can be run via the single front-end bin/multitool.

The currently functioning demo programs are:

connscale       A TCP connection generator/terminator
echo            A loopback server
passive         A passive reconstructor
passive_extract A passive reconstructor that extracts file from HTTP streams

Still waiting to be updated is:

echo++	        A C++ loopback server
tproxy          A transparent proxy


Notes
=============================================================================

The sysctl code (and likely more over time) uses libnv from
FreeBSD-HEAD to serialise data between processes.

Currently, the sysctl and vmstat tools that interact with a libuinet
instance are only buildable on FreeBSD hosts.