freebsd-dev/contrib/libpcap
Bill Fenner 4c6f72b0be Merge libpcap 0.3
Update FREEBSD-upgrade to mention bumping library version number.

Suggested-by:	Chris Timmons <skynyrd@opus.cts.cwu.edu>
1997-05-27 00:05:23 +00:00
..
bpf/net Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
lbl Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
acsite.m4 Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
bpf_image.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
CHANGES Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
config.guess Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
config.sub Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
configure Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
configure.in Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
etherent.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
ethertype.h
FILES Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
FREEBSD-upgrade Merge libpcap 0.3 1997-05-27 00:05:23 +00:00
gencode.c Merge libpcap 0.3 1997-05-27 00:05:23 +00:00
gencode.h
grammar.y Merge libpcap 0.3 1997-05-27 00:05:23 +00:00
inet.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
INSTALL Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
install-sh Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
Makefile.in Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
mkdep
nametoaddr.c Merge libpcap 0.3 1997-05-27 00:05:23 +00:00
nlpid.h
optimize.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-bpf.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-dlpi.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-enet.c
pcap-int.h Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-linux.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-namedb.h
pcap-nit.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-nit.h
pcap-null.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-pf.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-pf.h
pcap-snit.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap-snoop.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap.3 Merge libpcap 0.3 1997-05-27 00:05:23 +00:00
pcap.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
pcap.h
README Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
savefile.c Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00
scanner.l Merge libpcap 0.3 1997-05-27 00:05:23 +00:00
VERSION Virgin import of libpcap 0.3 1997-05-27 00:01:12 +00:00

@(#) $Header: README,v 1.17 96/11/29 01:14:24 leres Exp $ (LBL)

LIBPCAP 0.3
Lawrence Berkeley National Laboratory
Network Research Group
libpcap@ee.lbl.gov
ftp://ftp.ee.lbl.gov/libpcap.tar.Z

This directory contains source code for libpcap, a system-independent
interface for user-level packet capture.  libpcap provides a portable
framework for low-level network monitoring.  Applications include
network statistics collection, security monitoring, network debugging,
etc.  Since almost every system vendor provides a different interface
for packet capture, and since we've developed several tools that
require this functionality, we've created this system-independent API
to ease in porting and to alleviate the need for several
system-dependent packet capture modules in each application.

Note well: this interface is new and is likely to change.

The libpcap interface supports a filtering mechanism based on the
architecture in the BSD packet filter.  BPF is described in the 1993
Winter Usenix paper ``The BSD Packet Filter: A New Architecture for
User-level Packet Capture''.  A compressed postscript version is in:

	ftp://ftp.ee.lbl.gov/papers/bpf-usenix93.ps.Z.

Although most packet capture interfaces support in-kernel filtering,
libpcap utilizes in-kernel filtering only for the BPF interface.
On systems that don't have BPF, all packets are read into user-space
and the BPF filters are evaluated in the libpcap library, incurring
added overhead (especially, for selective filters).  Ideally, libpcap
would translate BPF filters into a filter program that is compatible
with the underlying kernel subsystem, but this is not yet implemented.

BPF is standard in 4.4BSD, BSD/386, NetBSD, and FreeBSD.  DEC OSF/1
uses the packetfilter interface but has been extended to accept BPF
filters (which libpcap utilizes).  Also, you can add BPF filter support
to Ultrix using the kernel source and/or object patches available in:

	ftp://gatekeeper.dec.com/pub/DEC/net/bpfext42.tar.Z.

Problems, bugs, questions, desirable enhancements, source code
contributions, etc., should be sent to the email address
"libpcap@ee.lbl.gov".

 - Steve McCanne
   Craig Leres
   Van Jacobson