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

FreeBSD Manual Pages

  
 
  

home | help
PCAP_LOOKUPDEV(3)	   Library Functions Manual	     PCAP_LOOKUPDEV(3)

NAME
       pcap_lookupdev -	find the default device	on which to capture

SYNOPSIS
       #include	<pcap/pcap.h>

       char errbuf[PCAP_ERRBUF_SIZE];

       [DEPRECATED] char *pcap_lookupdev(char *errbuf);

DESCRIPTION
       This  interface is obsoleted by pcap_findalldevs(3).  To	find a default
       device on which to capture, call	pcap_findalldevs() and,	if the list it
       returns	is  not	empty, use the first device in the list.  (If the list
       is empty, there are no devices on which capture is possible.)

       pcap_lookupdev()	returns	a pointer to a string giving  the  name	 of  a
       network device suitable for use with pcap_create() and pcap_activate(),
       or with pcap_open_live(), and with pcap_lookupnet().  If	 there	is  an
       error, NULL is returned and errbuf is filled in with an appropriate er-
       ror message.  errbuf is assumed to be able to hold  at  least  PCAP_ER-
       RBUF_SIZE chars.

SEE ALSO
       pcap(3),	    pcap_create(3),    pcap_activate(3),    pcap_open_live(3),
       pcap_lookupnet(3)

BUGS
       The pointer returned by pcap_lookupdev()	points	to  a  static  buffer;
       subsequent  calls  to  pcap_lookupdev() in the same thread, or calls to
       pcap_lookupdev()	in another thread, may overwrite that buffer.

       In WinPcap, this	function may return a UTF-16  string  rather  than  an
       ASCII or	UTF-8 string.

				3 January 2014		     PCAP_LOOKUPDEV(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pcap_lookupdev&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help