pcap_create - create a live capture handle
#include <pcap/pcap.h> char errbuf[PCAP_ERRBUF_SIZE]; pcap_t *pcap_create(const char *source, char *errbuf);
PCAP_CREATE(3pcap) PCAP_CREATE(3pcap)
NAME
pcap_create - create a live capture handle
SYNOPSIS
#include <pcap/pcap.h>
char errbuf[PCAP_ERRBUF_SIZE];
pcap_t *pcap_create(const char *source, char *errbuf);
DESCRIPTION
pcap_create() is used to create a packet capture handle to look at
packets on the network. source is a string that specifies the network
device to open; on Linux systems with 2.2 or later kernels, a source
argument of "any" or NULL can be used to capture packets from all
interfaces.
The returned handle must be activated with pcap_activate(3PCAP) before
packets can be captured with it; options for the capture, such as pro-
miscuous mode, can be set on the handle before activating it.
RETURN VALUE
pcap_create() returns a pcap_t * on success and NULL on failure. If
NULL is returned, errbuf is filled in with an appropriate error mes-
sage. errbuf is assumed to be able to hold at least PCAP_ERRBUF_SIZE
chars.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------------+
|Availability | system/library/libpcap |
+---------------+------------------------+
|Stability | Uncommitted |
+---------------+------------------------+
SEE ALSO
pcap(3PCAP)
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://www.tcpdump.org/release/libp-
cap-1.9.1.tar.gz.
Further information about this software can be found on the open source
community website at https://www.tcpdump.org/.
3 January 2014 PCAP_CREATE(3pcap)