|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON |
PCAP_LIST_DATALINKS(3PCAP) PCAP_LIST_DATALINKS(3PCAP)
pcap_list_datalinks, pcap_free_datalinks - get a list of link-layer
header types supported by a capture device, and free that list
#include <pcap/pcap.h>
int pcap_list_datalinks(pcap_t *p, int **dlt_buf);
void pcap_free_datalinks(int *dlt_list);
pcap_list_datalinks() is used to get a list of the supported link-
layer header types of the interface associated with the pcap
descriptor. pcap_list_datalinks() allocates an array to hold the
list and sets *dlt_buf to point to that array.
The caller is responsible for freeing the array with
pcap_free_datalinks(), which frees the list of link-layer header
types pointed to by dlt_list.
It must not be called on a pcap descriptor created by pcap_create()
that has not yet been activated by pcap_activate().
pcap_list_datalinks() returns the number of link-layer header types
in the array on success, PCAP_ERROR_NOT_ACTIVATED if called on a
capture handle that has been created but not activated, and
PCAP_ERROR (-1) on other errors. If PCAP_ERROR is returned,
pcap_geterr() or pcap_perror() may be called with p as an argument to
fetch or display the error text.
pcap(3PCAP), pcap_geterr(3PCAP), pcap_datalink_val_to_name(3PCAP),
pcap-linktype(7)
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 2017-07-05. 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
8 March 2015 PCAP_LIST_DATALINKS(3PCAP)