]> The Tcpdump Group git mirrors - libpcap/commitdiff
added notes about DLT allocation
authorMichael Richardson <[email protected]>
Sun, 24 Jun 2018 18:39:35 +0000 (14:39 -0400)
committerMichael Richardson <[email protected]>
Sun, 24 Jun 2018 18:39:35 +0000 (14:39 -0400)
doc/DLT_ALLOCATE_HOWTO.md [new file with mode: 0644]

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