PCAP_LOOKUPDEV(3PCAP)                                  PCAP_LOOKUPDEV(3PCAP)

NAME         top

       pcap_lookupdev - find the default device on which to capture

SYNOPSIS         top

       #include <pcap/pcap.h>

       char errbuf[PCAP_ERRBUF_SIZE];

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

DESCRIPTION         top

       This interface is obsoleted by pcap_findalldevs(3PCAP).  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

       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 error message.  errbuf is assumed to be able to hold
       at least PCAP_ERRBUF_SIZE chars.

SEE ALSO         top

       pcap(3PCAP), pcap_create(3PCAP), pcap_activate(3PCAP),
       pcap_open_live(3PCAP), pcap_lookupnet(3PCAP)

BUGS         top

       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.

COLOPHON         top

       This page is part of the libpcap (packet capture library) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this manual
       page, see ⟨⟩.  This page was obtained
       from the project's upstream Git repository 
       ⟨⟩ on 2017-09-15.  If
       you discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information in
       this COLOPHON (which is not part of the original manual page), send a
       mail to

                               3 January 2014          PCAP_LOOKUPDEV(3PCAP)