pcap_datalink(3PCAP) man page

pcap_datalink(3PCAP) man page

Updated: 7 April 2014 • View in plain text • Return to Main Contents

NAME

pcap_datalink - get the link-layer header type

SYNOPSIS

#include <pcap/pcap.h>

int pcap_datalink(pcap_t *p);

DESCRIPTION

pcap_datalink() returns the link-layer header type for the live capture or ``savefile'' specified by p.

It must not be called on a pcap descriptor created by pcap_create(3PCAP) that has not yet been activated by pcap_activate(3PCAP).

<https://www.tcpdump.org/linktypes.html> lists the values pcap_datalink() can return and describes the packet formats that correspond to those values.

Do NOT assume that the packets for a given capture or savefile will have any given link-layer header type, such as DLT_EN10MB for Ethernet. For example, the “any” device on Linux will have a link-layer header type of DLT_LINUX_SLL or DLT_LINUX_SLL2 even if all devices on the system at the time the “any” device is opened have some other data link type, such as DLT_EN10MB for Ethernet.

RETURN VALUE

pcap_datalink() returns the link-layer header type on success and PCAP_ERROR_NOT_ACTIVATED if called on a capture handle that has been created but not activated.

SEE ALSO

pcap(3PCAP), pcap_datalink_val_to_name(3PCAP), pcap_set_datalink(3PCAP), pcap_list_datalinks(3PCAP), pcap-linktype(7)

COLOPHON

This HTML man page was generated at 15:15:19 GMT, September 13, 2026 from a source man page in “The Tcpdump Group” git repositories using man2html and other tools.