1PCAP_LIST_DATALINKS(3PCAP)                          PCAP_LIST_DATALINKS(3PCAP)
2
3
4

NAME

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

SYNOPSIS

10       #include <pcap/pcap.h>
11
12       int pcap_list_datalinks(pcap_t *p, int **dlt_buf);
13       void pcap_free_datalinks(int *dlt_list);
14

DESCRIPTION

16       pcap_list_datalinks() is used to get a list of the supported link-layer
17       header  types  of  the  interface  associated with the pcap descriptor.
18       pcap_list_datalinks() allocates an array to  hold  the  list  and  sets
19       *dlt_buf to point to that array.
20
21       The    caller    is    responsible   for   freeing   the   array   with
22       pcap_free_datalinks(), which frees the list of link-layer header  types
23       pointed to by dlt_list.
24
25       It   must   not   be   called   on   a   pcap   descriptor  created  by
26       pcap_create(3PCAP)   that   has   not    yet    been    activated    by
27       pcap_activate(3PCAP).
28

RETURN VALUE

30       pcap_list_datalinks()  returns the number of link-layer header types in
31       the array on success, PCAP_ERROR_NOT_ACTIVATED if called on  a  capture
32       handle that has been created but not activated, and PCAP_ERROR on other
33       errors.    If   PCAP_ERROR   is   returned,    pcap_geterr(3PCAP)    or
34       pcap_perror(3PCAP) may be called with p as an argument to fetch or dis‐
35       play the error text.
36

SEE ALSO

38       pcap(3PCAP), pcap_datalink_val_to_name(3PCAP), pcap-linktype(7)
39
40
41
42                                 25 July 2018       PCAP_LIST_DATALINKS(3PCAP)
Impressum