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

FreeBSD Manual Pages

  
 
  

home | help
PCAP_LIST_DATALINKS(3)	   Library Functions Manual	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>

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

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(3) or	pcap_perror(3)
       may be called with p as an argument to fetch or display the error text.

SEE ALSO
       pcap(3),	pcap_datalink_val_to_name(3), pcap-linktype(7)

				 25 July 2018		PCAP_LIST_DATALINKS(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

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

home | help