pcap_datalink_val_to_description(3)

pcap_datalink_val_to_description3

Get a name or description for a link-layer header type value

Part of pcap_datalink_val_to_name(3).

Usage

#include <pcap.h>

const char *pcap_datalink_val_to_name(int dlt); const char *pcap_datalink_val_to_description(int dlt); const char *pcap_datalink_val_to_description_or_dlt(int dlt);

Overview

pcap_datalink_val_to_name() translates a link-layer header type value to the corresponding link-layer header type name, which is the DLT_ name for the link-layer header type value with the DLT_ removed. NULL is returned if the type value does not correspond to a known DLT_ value.

pcap_datalink_val_to_description() translates a link-layer header type value to a short description of that link-layer header type. NULL is returned if the type value does not correspond to a known DLT_ value.

pcap_datalink_val_to_description_or_dlt() translates a link-layer header type value to a short description of that link-layer header type just like pcap_datalink_val_to_description(). If the type value does not correspond to a known DLT_ value, the string "DLT n" is returned, where n is the value of the dlt argument.

Backward compatibility

The pcap_datalink_val_to_description_or_dlt() function first became available in libpcap release 1.9.1. In previous releases, pcap_datalink_val_to_description() would have to be called and, if it returned NULL, a default string would have to be constructed.

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 8 times.

  1. 8.0–8.4
  2. 9.0
  3. 9.1–10.4
  4. 11.0
  5. 11.1–11.3
  6. 11.4
  7. 12.0–12.1
  8. 12.2–13.4
  9. 13.5–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's man source.