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

RETURN VALUE

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

SEE ALSO

37       pcap(3PCAP),    pcap_geterr(3PCAP),   pcap_datalink_val_to_name(3PCAP),
38       pcap-linktype(7)
39
40
41
42                                22 August 2010      PCAP_LIST_DATALINKS(3PCAP)
Impressum