summaryrefslogtreecommitdiff
path: root/INSTALL.md
diff options
context:
space:
mode:
authorJoseph Mingrone <jrm@FreeBSD.org>2024-09-05 16:46:35 -0300
committerJoseph Mingrone <jrm@FreeBSD.org>2024-09-05 16:46:35 -0300
commit025be3f592b920ff0a3e602e5aa8b60a34e5e617 (patch)
tree4f33277584e4a38c8bad5c2788584a00cf830ea4 /INSTALL.md
parent6b96668d5b49eea57b7551349eca70928cc199ce (diff)
Import libpcap 1.10.5vendor/libpcap/1.10.5
Diffstat (limited to 'INSTALL.md')
-rw-r--r--INSTALL.md84
1 files changed, 78 insertions, 6 deletions
diff --git a/INSTALL.md b/INSTALL.md
index d0a19d811a8b..2787580767fc 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -4,10 +4,18 @@ with CMake and any build system supported by CMake.
To build libpcap with the configure script and `make`:
+* If you build from a git clone rather than from a release archive,
+run `./autogen.sh` (a shell script). The autogen.sh script will
+build the `configure` and `config.h.in` files.
+
+On some system, you may need to set the `AUTORECONF` variable, like:
+`AUTORECONF=autoreconf-2.69 ./autogen.sh`
+to select the `autoreconf` version you want to use.
+
* Run `./configure` (a shell script). The configure script will
determine your system attributes and generate an appropriate `Makefile`
from `Makefile.in`. The configure script has a number of options to
-control the configuration of libpcap; `./configure --help`` will show
+control the configuration of libpcap; `./configure --help` will show
them.
* Next, run `make`. If everything goes well, you can
@@ -15,6 +23,10 @@ them.
libpcap if you just want to build tcpdump; just make sure the tcpdump
and libpcap directory trees have the same parent directory.
+On OpenBSD, you may need to set, before the `make`, the `AUTOCONF_VERSION`
+variable like:
+`AUTOCONF_VERSION=2.69 make`
+
To build libpcap with CMake and the build system of your choice, from
the command line:
@@ -62,7 +74,7 @@ forget to include an autoconf fragment suitable for use in
`configure.ac`.
It is possible to override the default packet capture type with the
-`--with-pcap`` option to `./configure` or the `-DPCAP_TYPE` option to
+`--with-pcap` option to `./configure` or the `-DPCAP_TYPE` option to
CMake, although the circumstances where this works are limited. One
possible reason to do that would be to force a supported packet capture
type in the case where the configure or CMake scripts fails to detect
@@ -186,37 +198,44 @@ in `/usr/include/sys/dlpi.h`, and find the corresponding value.
CONTRIBUTING.md - guidelines for contributing
CREDITS - people that have helped libpcap along
INSTALL.md - this file
- LICENSE - the license under which tcpdump is distributed
+ LICENSE - the license under which libpcap is distributed
Makefile.in - compilation rules (input to the configure script)
README.md - description of distribution
doc/README.aix - notes on using libpcap on AIX
doc/README.dag - notes on using libpcap to capture on Endace DAG devices
+ doc/README.haiku.md - notes on using libpcap on Haiku
doc/README.hpux - notes on using libpcap on HP-UX
doc/README.linux - notes on using libpcap on Linux
doc/README.macos - notes on using libpcap on macOS
doc/README.septel - notes on using libpcap to capture on Intel/Septel devices
doc/README.sita - notes on using libpcap to capture on SITA devices
doc/README.solaris.md - notes on using libpcap on Solaris
- doc/README.Win32.md - notes on using libpcap on Win32 systems (with Npcap)
+ doc/README.windows.md - notes on using libpcap on Windows systems (with Npcap)
VERSION - version of this release
aclocal.m4 - autoconf macros
arcnet.h - ARCNET definitions
atmuni31.h - ATM Q.2931 definitions
+ autogen.sh - build configure and config.h.in (run this first)
bpf_dump.c - BPF program printing routines
bpf_filter.c - BPF filtering routines
bpf_image.c - BPF disassembly routine
+ charconv.c - Windows Unicode routines
+ charconv.h - Windows Unicode prototypes
config.guess - autoconf support
- config.h.in - autoconf input
config.sub - autoconf support
- configure - configure script (run this first)
configure.ac - configure script source
+ diag-control.h - compiler diagnostics control macros
dlpisubs.c - DLPI-related functions for pcap-dlpi.c and pcap-libdlpi.c
dlpisubs.h - DLPI-related function declarations
etherent.c - /etc/ethers support routines
+ extract.h - Alignment definitions
ethertype.h - Ethernet protocol types and names definitions
fad-getad.c - pcap_findalldevs() for systems with getifaddrs()
fad-gifc.c - pcap_findalldevs() for systems with only SIOCGIFLIST
fad-glifc.c - pcap_findalldevs() for systems with SIOCGLIFCONF
+ fmtutils.c - error message formatting routines
+ fmtutils.h - error message formatting prototypes
+ ftmacros.h - feature test macros
testprogs/filtertest.c - test program for BPF compiler
testprogs/findalldevstest.c - test program for pcap_findalldevs()
gencode.c - BPF code generation routines
@@ -224,54 +243,107 @@ in `/usr/include/sys/dlpi.h`, and find the corresponding value.
grammar.y - filter string grammar
ieee80211.h - 802.11 definitions
install-sh - BSD style install script
+ instrument-functions.c - functions instrumentation calls for entry/exit
lbl/os-*.h - OS-dependent defines and prototypes
llc.h - 802.2 LLC SAP definitions
missing/* - replacements for missing library functions
mkdep - construct Makefile dependency list
msdos/* - drivers for MS-DOS capture support
nametoaddr.c - hostname to address routines
+ nametoaddr.h - hostname to address prototypes
nlpid.h - OSI network layer protocol identifier definitions
optimize.c - BPF optimization routines
+ optimize.h - BPF optimization prototypes
pcap/bluetooth.h - public definition of DLT_BLUETOOTH_HCI_H4_WITH_PHDR header
pcap/bpf.h - BPF definitions
+ pcap/can_socketcan.h - SocketCAN header
+ pcap/compiler-tests.h - compiler version comparison and other macros
+ pcap/dlt.h - Link-layer header type codes.
+ pcap/funcattrs.h - function attribute macros
+ pcap/ipnet.h - Solaris IPnet definitions
pcap/namedb.h - public libpcap name database definitions
+ pcap/nflog.h - NFLOG-related definitions
pcap/pcap.h - public libpcap definitions
+ pcap/pcap-inttypes.h - header for OS-specific integer type includes
pcap/sll.h - public definitions of DLT_LINUX_SLL and DLT_LINUX_SLL2 headers
+ pcap/socket.h - IP sockets support for various OSes
pcap/usb.h - public definition of DLT_USB header
+ pcap/vlan.h - VLAN-specific definitions
+ pcap-airpcap.c - AirPcap device capture support
+ pcap-airpcap.h - AirPcap device capture support
pcap-bpf.c - BSD Packet Filter support
pcap-bpf.h - header for backwards compatibility
pcap-bt-linux.c - Bluetooth capture support for Linux
pcap-bt-linux.h - Bluetooth capture support for Linux
+ pcap-bt-monitor-linux.c - Bluetooth monitor capture support for Linux
+ pcap-bt-monitor-linux.h - Bluetooth monitor capture support for Linux
+ pcap-common.c - common code for pcap and pcapng files
+ pcap-common.h - common code for pcap and pcapng files
pcap-dag.c - Endace DAG device capture support
pcap-dag.h - Endace DAG device capture support
+ pcap-dbus.c - D-Bus capture support
+ pcap-dbus.h - D-Bus capture support
pcap-dlpi.c - Data Link Provider Interface support
pcap-dos.c - MS-DOS capture support
pcap-dos.h - headers for MS-DOS capture support
+ pcap-dpdk.c - DPDK device support
+ pcap-dpdk.h - DPDK device support
pcap-enet.c - enet support
+ pcap-haiku.c - Haiku capture support
pcap-int.h - internal libpcap definitions
pcap-libdlpi.c - Data Link Provider Interface support for systems with libdlpi
pcap-linux.c - Linux packet socket support
pcap-namedb.h - header for backwards compatibility
+ pcap-netfilter-linux.c - Linux netfilter support
+ pcap-netfilter-linux.h - Linux netfilter support
+ pcap-netmap.c - netmap support
+ pcap-netmap.h - netmap support
pcap-nit.c - SunOS Network Interface Tap support
pcap-npf.c - Npcap capture support
pcap-null.c - dummy monitor support (allows offline use of libpcap)
pcap-pf.c - Ultrix and Digital/Tru64 UNIX Packet Filter support
+ pcap-rdmasniff.c - RDMA/InfiniBand capture support
+ pcap-rdmasniff.h - RDMA/InfiniBand capture support
+ pcap-rpcap.c - RPCAP protocol capture support
+ pcap-rpcap.h - RPCAP protocol capture support
pcap-septel.c - Intel/Septel device capture support
pcap-septel.h - Intel/Septel device capture support
pcap-sita.c - SITA device capture support
pcap-sita.h - SITA device capture support
pcap-sita.html - SITA device capture documentation
+ pcap-snf.c - Myricom SNF device capture support
+ pcap-snf.h - Myricom SNF device capture support
pcap-snit.c - SunOS 4.x STREAMS-based Network Interface Tap support
pcap-snoop.c - IRIX Snoop network monitoring support
+ pcap-tc.c - TurboCap device capture support
+ pcap-tc.h - TurboCap device capture support
+ pcap-types.h - header for OS-specific type includes
pcap-usb-linux.c - USB capture support for Linux
pcap-usb-linux.h - USB capture support for Linux
+ pcap-usb-linux-common.c - Linux USB common routines
+ pcap-usb-linux-common.h - Linux USB common prototypes
+ pcap-util.c - common code for various files
+ pcap-util.h - common code for various files
pcap.3pcap - manual entry for the library
pcap.c - pcap utility routines
pcap.h - header for backwards compatibility
pcap_*.3pcap - manual entries for library functions
pcap-filter.manmisc.in - manual entry for filter syntax
pcap-linktype.manmisc.in - manual entry for link-layer header types
+ pflog.h - header for DLT_PFLOG handling in filter code
+ portability.h - Portability declarations/definitions
ppp.h - Point to Point Protocol definitions
+ rpcap-protocol.c - RPCAP client/server common routines
+ rpcap-protocol.h - RPCAP client/server common prototypes
savefile.c - offline support
scanner.l - filter string scanner
+ sf-pcap.c - routines for .pcap savefiles
+ sf-pcap.h - prototypes for .pcap savefiles
+ sf-pcapng.c - routines for .pcapng savefiles
+ sf-pcapng.h - prototypes for .pcapng savefiles
+ sockutils.c - socket and name lookup API routines
+ sockutils.h - socket and name lookup API prototypes
+ sslutils.c - OpenSSL interface routines
+ sslutils.h - OpenSSL interface prototypes
sunatmpos.h - definitions for SunATM capturing
+ varattrs.h - variable attribute macros