Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
PCAP_LIST_DATALINKS(3PCAP)			      PCAP_LIST_DATALINKS(3PCAP)

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

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 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
     pcap(3PCAP), pcap_datalink_val_to_name(3PCAP), pcap-linktype(7)

				  25 July 2018	      PCAP_LIST_DATALINKS(3PCAP)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pcap_list_datalinks&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help