|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON |
|
|
|
PCAP_INIT(3PCAP) PCAP_INIT(3PCAP)
pcap_init - initialize the library
#include <pcap/pcap.h>
char errbuf[PCAP_ERRBUF_SIZE];
int pcap_init(unsigned int opts, char *errbuf);
pcap_init() is used to initialize the Packet Capture library.
opts specifies options for the library; currently, the options
are:
PCAP_CHAR_ENC_LOCAL
Treat all strings supplied as arguments, and return all
strings to the caller, as being in the local character
encoding.
PCAP_CHAR_ENC_UTF_8
Treat all strings supplied as arguments, and return all
strings to the caller, as being in UTF-8.
On UNIX-like systems, the local character encoding is assumed to
be UTF-8, so no character encoding transformations are done.
On Windows, the local character encoding is the local ANSI code
page.
If pcap_init() is not called, strings are treated as being in the
local ANSI code page on Windows, pcap_lookupdev(3PCAP) will
succeed if there is a device on which to capture, and
pcap_create(3PCAP) makes an attempt to check whether the string
passed as an argument is a UTF-16LE string - note that this
attempt is unsafe, as it may run past the end of the string - to
handle pcap_lookupdev() returning a UTF-16LE string. Programs
that don't call pcap_init() should, on Windows, call
pcap_wsockinit() to initialize Winsock; this is not necessary if
pcap_init() is called, as pcap_init() will initialize Winsock
itself on Windows.
pcap_init() returns 0 on success and -1 on failure. If -1 is
returned, 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)
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 2020-12-18.
(At that time, the date of the most recent commit that was found
in the repository was 2020-12-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
man-pages@man7.org
11 April 2020 PCAP_INIT(3PCAP)
|
HTML rendering created 2020-12-21 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. |
|