|
|
PCAP_LOOKUPDEV(3PCAP) PCAP_LOOKUPDEV(3PCAP)
pcap_lookupdev - find the default device on which to capture
#include <pcap/pcap.h>
char errbuf[PCAP_ERRBUF_SIZE];
[DEPRECATED] char *pcap_lookupdev(char *errbuf);
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
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 error message. errbuf is assumed to be able to hold
at least PCAP_ERRBUF_SIZE chars.
pcap(3PCAP), pcap_create(3PCAP), pcap_activate(3PCAP),
pcap_open_live(3PCAP), pcap_lookupnet(3PCAP)
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.
This page is part of the libpcap (packet capture library) project.
Information about the project can be found at
⟨http://www.tcpdump.org/⟩. If you have a bug report for this manual
page, see ⟨http://www.tcpdump.org/#patches⟩. This page was obtained
from the project's upstream Git repository
⟨https://github.com/the-tcpdump-group/libpcap.git⟩ on 2018-02-02.
(At that time, the date of the most recent commit that was found in
the repository was 2018-01-31.) If you discover any rendering prob‐
lems in this HTML version of the page, or you believe there is a bet‐
ter 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 man-pages@man7.org
3 January 2014 PCAP_LOOKUPDEV(3PCAP)
|
HTML rendering created 2018-02-02 by Michael Kerrisk, author of The Linux Programming Interface, maintainer of the Linux man-pages project. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.
|
|