summaryrefslogtreecommitdiff
path: root/static/freebsd/man1/pcap-config.1
diff options
context:
space:
mode:
Diffstat (limited to 'static/freebsd/man1/pcap-config.1')
-rw-r--r--static/freebsd/man1/pcap-config.1132
1 files changed, 132 insertions, 0 deletions
diff --git a/static/freebsd/man1/pcap-config.1 b/static/freebsd/man1/pcap-config.1
new file mode 100644
index 00000000..66af140b
--- /dev/null
+++ b/static/freebsd/man1/pcap-config.1
@@ -0,0 +1,132 @@
+.\" Copyright (c) 1987, 1988, 1989, 1990, 1991, 1992, 1994, 1995, 1996, 1997
+.\" The Regents of the University of California. All rights reserved.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that: (1) source code distributions
+.\" retain the above copyright notice and this paragraph in its entirety, (2)
+.\" distributions including binary code include the above copyright notice and
+.\" this paragraph in its entirety in the documentation or other materials
+.\" provided with the distribution, and (3) all advertising materials mentioning
+.\" features or use of this software display the following acknowledgement:
+.\" ``This product includes software developed by the University of California,
+.\" Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
+.\" the University nor the names of its contributors may be used to endorse
+.\" or promote products derived from this software without specific prior
+.\" written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
+.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.TH PCAP\-CONFIG 1 "17 April 2023"
+.SH NAME
+pcap-config \- write libpcap compiler and linker flags to standard output
+.SH SYNOPSIS
+.na
+.B pcap-config
+[
+.B \-\-help
+]
+[
+.B \-\-version
+]
+[
+.B \-\-cflags
+]
+.ti +12
+[
+.B \-\-libs
+|
+.B \-\-additional\-libs
+]
+.ti +12
+[
+.B \-\-static
+|
+.B \-\-static\-pcap\-only
+]
+.ad
+
+.SH DESCRIPTION
+.LP
+.I pcap\-config
+writes to the standard output various compiler and linker flags required to
+build a user program with libpcap. By default, it writes flags appropriate
+for building with a dynamically\-linked version of libpcap; see below
+for static linking. Depending on the manner of libpcap installation, some
+options or their combinations may produce empty output \- this is by design.
+
+.SH OPTIONS
+.TP
+.B \-\-help
+Produce a help message and exit.
+
+.TP
+.B \-\-version
+Produce libpcap version and exit. The version is the contents of
+.I VERSION
+file in libpcap source tree rather than the result of
+.BR \%pcap_lib_version (3PCAP).
+
+.TP
+.B \-\-cflags
+Produce the
+.B \-I
+compiler flag required to include libpcap's header files.
+
+.TP
+.B \-\-libs
+Produce the
+.B \-L
+and
+.B \-l
+linker flags required to link with libpcap, including
+.B \-l
+flags for libraries required by libpcap.
+
+.TP
+.B \-\-additional\-libs
+Produce the
+.B \-L
+and
+.B \-l
+linker flags for libraries required by libpcap, but not the
+.B \-l
+flag to link with libpcap itself.
+
+.TP
+.B \-\-static
+This option causes
+.B \-\-libs
+and
+.B \-\-additional\-libs
+to produce linker flags appropriate for static linking with libpcap.
+
+.TP
+.B \-\-static\-pcap\-only
+This option causes
+.B \-\-libs
+and
+.B \-\-additional\-libs
+to produce linker flags appropriate for static linking with libpcap and
+dynamic linking with all other libraries, including libraries required by
+libpcap.
+
+.SH EXIT STATUS
+.I pcap\-config
+exits with a non-zero status when invoked with an invalid command\-line
+option, and with status 0 otherwise.
+
+.SH BACKWARD COMPATIBILITY
+.PP
+Before libpcap release 1.10.2
+.I pcap\-config
+did not treat invalid command\-line options as an error. The
+.B \-\-static\-pcap\-only
+flag became available in libpcap release 1.10.2. The
+.B \-\-static
+flag became available in libpcap release 1.1.0.
+
+.SH SEE ALSO
+.BR pkg\-config (1),
+.BR pcap (3PCAP)