Blame doc/DLT_ALLOCATE_HOWTO.md

Packit 209cc3
DLT and LINKTYPE allocation
Packit 209cc3
===========================
Packit 209cc3
Packit 209cc3
DLT_ types live in pcap/dlt.h.  They can be requested by the community on a
Packit 209cc3
First-Come First-Served basis [i.e. https://tools.ietf.org/html/rfc8126#section-4.4 ]
Packit 209cc3
(Although libpcap is not at this time an IETF specification, there have been
Packit 209cc3
some as yet-incomplete efforts to do this).
Packit 209cc3
Packit 209cc3
The Tcpdump Group prefers to link to an open specification on the new DLT_
Packit 209cc3
type,  but they are available for closed, proprietary projects as well.
Packit 209cc3
In that case, a stable email address suffices so that someone who finds
Packit 209cc3
an unknown DLT_ type can investigate.
Packit 209cc3
We prefer to give out unambiguous numbers, and we try to do it as quickly
Packit 209cc3
as possible, but DLT_USERx is available while you wait.
Packit 209cc3
Packit 209cc3
Note that DLT_ types are, in theory, private to the capture mechanism and can
Packit 209cc3
in some cases be operating system specific, and so a second set of values,
Packit 209cc3
LINKTYPE_ is allocated for actually writing to pcap files.  As much as
Packit 209cc3
possible going forward, the DLT_ and LINKTYPE_ value are identical, however,
Packit 209cc3
this was not always the case.  See pcap-common.c.
Packit 209cc3
Packit 209cc3
The LINKTYPE_ values are not exported, but are in pcap-common.c only.
Packit 209cc3
Packit 209cc3
DEVELOPER NOTES
Packit 209cc3
---------------
Packit 209cc3
Packit 209cc3
When allocating a new DLT_ value, a corresponding value needs to be
Packit 209cc3
added to pcap-common.c.
Packit 209cc3
It is not necessary to copy the comments from dlt.h to pcap-common.c.