pcap_list_datalinks(3pcap) — Linux manual page



NAME         top

       pcap_list_datalinks, pcap_free_datalinks - get a list of link-
       layer header types supported by a capture device, and free that

SYNOPSIS         top

       #include <pcap/pcap.h>

       int pcap_list_datalinks(pcap_t *p, int **dlt_buf);
       void pcap_free_datalinks(int *dlt_list);

DESCRIPTION         top

       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(3PCAP) that has not yet been activated by

RETURN VALUE         top

       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 on other errors.  If PCAP_ERROR is returned,
       pcap_geterr(3PCAP) or pcap_perror(3PCAP) may be called with p as
       an argument to fetch or display the error text.

SEE ALSO         top

       pcap(3PCAP), pcap_datalink_val_to_name(3PCAP), pcap-linktype(7)

COLOPHON         top

       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 2022-12-17.
       (At that time, the date of the most recent commit that was found
       in the repository was 2022-12-13.)  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

                              25 July 2018    PCAP_LIST_DATALINKS(3PCAP)