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()
       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_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-link-
       type(@MAN_MISC_INFO@)

				 8 March 2015		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+12.1-RELEASE+and+Ports>

home | help