1PCAP_LIST_DATALINKS(3PCAP) PCAP_LIST_DATALINKS(3PCAP)
2
3
4
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
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
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
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
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)