manpagez: man pages & more
man pcap_lookupdev(3)
Home | html | info | man
pcap_lookupdev(3)                                    pcap_lookupdev(3)




NAME

       pcap_lookupdev - find the default device on which to capture


SYNOPSIS

       #include <pcap/pcap.h>

       char errbuf[PCAP_ERRBUF_SIZE];

       pcap_lookupdev(3) *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(3)  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
       error  message.   errbuf  is  assumed  to  be  able  to  hold  at least
       PCAP_ERRBUF_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(3) points to a static buffer;
       subsequent calls to pcap_lookupdev(3) in the same thread,  or  calls  to
       pcap_lookupdev(3) 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.




                               8 September 2017          pcap_lookupdev(3)

libpcap 1.9.0 - Generated Sat Jul 28 16:14:26 CDT 2018
© manpagez.com 2000-2018
Individual documents may contain additional copyright information.