+----------------------------------------------------------------------------+ | | | This man page documents libpcap version 1.10.2. | | | | Your system may have a different version installed, possibly with some | | local modifications. To achieve the best results, please make sure this | | version of this man page suits your needs. If necessary, try to look for | | a different version on this web site or in the man pages available in your | | installation. | | | +----------------------------------------------------------------------------+ PCAP_CREATE(3PCAP) PCAP_CREATE(3PCAP) NAME pcap_create - create a live capture handle SYNOPSIS #include 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 in- terfaces. 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. SEE ALSO pcap(3PCAP) 3 January 2014 PCAP_CREATE(3PCAP)