Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  in-
       terfaces.   errbuf  is  a buffer	large enough to	hold at	least PCAP_ER-
       RBUF_SIZE chars.

       The returned handle must	be activated with pcap_activate(3PCAP)	before
       packets	can  be	 captured  with	 it;  options for the capture, such as
       promiscuous 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.

SEE ALSO
       pcap(3PCAP)

			       30 November 2023		    PCAP_CREATE(3PCAP)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pcap_create&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help