NAME

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

SYNOPSIS

       #include <pcap/pcap.h>

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

DESCRIPTION

       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().

RETURN VALUE

       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.

SEE ALSO

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

                                          22 August 2010               PCAP_LIST_DATALINKS(3PCAP)