freebsd-dev/share/man
Christian S.J. Peron 4d621040ff Introduce support for zero-copy BPF buffering, which reduces the
overhead of packet capture by allowing a user process to directly "loan"
buffer memory to the kernel rather than using read(2) to explicitly copy
data from kernel address space.

The user process will issue new BPF ioctls to set the shared memory
buffer mode and provide pointers to buffers and their size. The kernel
then wires and maps the pages into kernel address space using sf_buf(9),
which on supporting architectures will use the direct map region. The
current "buffered" access mode remains the default, and support for
zero-copy buffers must, for the time being, be explicitly enabled using
a sysctl for the kernel to accept requests to use it.

The kernel and user process synchronize use of the buffers with atomic
operations, avoiding the need for system calls under load; the user
process may use select()/poll()/kqueue() to manage blocking while
waiting for network data if the user process is able to consume data
faster than the kernel generates it. Patchs to libpcap are available
to allow libpcap applications to transparently take advantage of this
support. Detailed information on the new API may be found in bpf(4),
including specific atomic operations and memory barriers required to
synchronize buffer use safely.

These changes modify the base BPF implementation to (roughly) abstrac
the current buffer model, allowing the new shared memory model to be
added, and add new monitoring statistics for netstat to print. The
implementation, with the exception of some monitoring hanges that break
the netstat monitoring ABI for BPF, will be MFC'd.

Zerocopy bpf buffers are still considered experimental are disabled
by default. To experiment with this new facility, adjust the
net.bpf.zerocopy_enable sysctl variable to 1.

Changes to libpcap will be made available as a patch for the time being,
and further refinements to the implementation are expected.

Sponsored by:		Seccuris Inc.
In collaboration with:	rwatson
Tested by:		pwood, gallatin
MFC after:		4 months [1]

[1] Certain portions will probably not be MFCed, specifically things
    that can break the monitoring ABI.
2008-03-24 13:49:17 +00:00
..
man1 Fix markup. 2006-12-26 22:25:58 +00:00
man3 Install manpage links for RB_PREV and RB_FOREACH_REVERSE. 2008-03-07 22:29:53 +00:00
man4 Introduce support for zero-copy BPF buffering, which reduces the 2008-03-24 13:49:17 +00:00
man5 Use the new command file feature of ddb(8) to support setting ddb(4) 2008-03-05 18:32:58 +00:00
man6 - We don't install USD docs for games anymore since the games with docs 2005-11-29 17:11:09 +00:00
man7 The config-recursive target is not run during the normal install process, move 2008-01-22 12:23:30 +00:00
man8 o Add a note that checkyesno takes a variable by its name, not value. 2007-10-26 09:38:54 +00:00
man9 Bah, missed one instance in the previous commit. Correct bpf 2008-03-17 16:37:35 +00:00
Makefile Reimplementation of world/kernel build options. For details, see: 2006-03-17 18:54:44 +00:00