manpagez: man pages & more
man pcap_list_datalinks(3)
Home | html | info | man
pcap_list_datalinks(3)                          pcap_list_datalinks(3)




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>

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


DESCRIPTION

       pcap_list_datalinks(3) is used to get a list of the supported link-layer
       header  types  of  the  interface  associated with the pcap descriptor.
       pcap_list_datalinks(3) 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(3) 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_per-
       ror() may be called with p as an argument to fetch or display the error
       text.


SEE ALSO

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



                               17 September 2013    pcap_list_datalinks(3)

libpcap 1.7.2 - Generated Sat Mar 14 06:32:40 CDT 2015
© manpagez.com 2000-2017
Individual documents may contain additional copyright information.