xref: /dragonfly/contrib/libpcap/pcap-common.c (revision e75ef36f1332e115895388cede9dfd24ca1a806c)
1 /*
2  * Copyright (c) 1993, 1994, 1995, 1996, 1997
3  *        The Regents of the University of California.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that: (1) source code distributions
7  * retain the above copyright notice and this paragraph in its entirety, (2)
8  * distributions including binary code include the above copyright notice and
9  * this paragraph in its entirety in the documentation or other materials
10  * provided with the distribution, and (3) all advertising materials mentioning
11  * features or use of this software display the following acknowledgement:
12  * ``This product includes software developed by the University of California,
13  * Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
14  * the University nor the names of its contributors may be used to endorse
15  * or promote products derived from this software without specific prior
16  * written permission.
17  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
18  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
19  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
20  *
21  * pcap-common.c - common code for pcap and pcapng files
22  */
23 
24 #ifdef HAVE_CONFIG_H
25 #include <config.h>
26 #endif
27 
28 #include <pcap-types.h>
29 
30 #include "pcap-int.h"
31 #include "extract.h"
32 #include "pcap/sll.h"
33 #include "pcap/usb.h"
34 #include "pcap/nflog.h"
35 #include "pcap/can_socketcan.h"
36 
37 #include "pcap-common.h"
38 
39 /*
40  * We don't write DLT_* values to capture files, because they're not the
41  * same on all platforms.
42  *
43  * Unfortunately, the various flavors of BSD have not always used the same
44  * numerical values for the same data types, and various patches to
45  * libpcap for non-BSD OSes have added their own DLT_* codes for link
46  * layer encapsulation types seen on those OSes, and those codes have had,
47  * in some cases, values that were also used, on other platforms, for other
48  * link layer encapsulation types.
49  *
50  * This means that capture files of a type whose numerical DLT_* code
51  * means different things on different BSDs, or with different versions
52  * of libpcap, can't always be read on systems other than those like
53  * the one running on the machine on which the capture was made.
54  *
55  * Instead, we define here a set of LINKTYPE_* codes, and map DLT_* codes
56  * to LINKTYPE_* codes when writing a savefile header, and map LINKTYPE_*
57  * codes to DLT_* codes when reading a savefile header.
58  *
59  * For those DLT_* codes that have, as far as we know, the same values on
60  * all platforms (DLT_NULL through DLT_FDDI), we define LINKTYPE_xxx as
61  * DLT_xxx; that way, captures of those types can still be read by
62  * versions of libpcap that map LINKTYPE_* values to DLT_* values, and
63  * captures of those types written by versions of libpcap that map DLT_
64  * values to LINKTYPE_ values can still be read by older versions
65  * of libpcap.
66  *
67  * The other LINKTYPE_* codes are given values starting at 100, in the
68  * hopes that no DLT_* code will be given one of those values.
69  *
70  * In order to ensure that a given LINKTYPE_* code's value will refer to
71  * the same encapsulation type on all platforms, you should not allocate
72  * a new LINKTYPE_* value without consulting
73  * "tcpdump-workers@lists.tcpdump.org".  The tcpdump developers will
74  * allocate a value for you, and will not subsequently allocate it to
75  * anybody else; that value will be added to the "pcap.h" in the
76  * tcpdump.org Git repository, so that a future libpcap release will
77  * include it.
78  *
79  * You should, if possible, also contribute patches to libpcap and tcpdump
80  * to handle the new encapsulation type, so that they can also be checked
81  * into the tcpdump.org Git repository and so that they will appear in
82  * future libpcap and tcpdump releases.
83  *
84  * Do *NOT* assume that any values after the largest value in this file
85  * are available; you might not have the most up-to-date version of this
86  * file, and new values after that one might have been assigned.  Also,
87  * do *NOT* use any values below 100 - those might already have been
88  * taken by one (or more!) organizations.
89  *
90  * Any platform that defines additional DLT_* codes should:
91  *
92  *        request a LINKTYPE_* code and value from tcpdump.org,
93  *        as per the above;
94  *
95  *        add, in their version of libpcap, an entry to map
96  *        those DLT_* codes to the corresponding LINKTYPE_*
97  *        code;
98  *
99  *        redefine, in their "net/bpf.h", any DLT_* values
100  *        that collide with the values used by their additional
101  *        DLT_* codes, to remove those collisions (but without
102  *        making them collide with any of the LINKTYPE_*
103  *        values equal to 50 or above; they should also avoid
104  *        defining DLT_* values that collide with those
105  *        LINKTYPE_* values, either).
106  */
107 #define LINKTYPE_NULL                   DLT_NULL
108 #define LINKTYPE_ETHERNET     DLT_EN10MB          /* also for 100Mb and up */
109 #define LINKTYPE_EXP_ETHERNET DLT_EN3MB /* 3Mb experimental Ethernet */
110 #define LINKTYPE_AX25                   DLT_AX25
111 #define LINKTYPE_PRONET                 DLT_PRONET
112 #define LINKTYPE_CHAOS                  DLT_CHAOS
113 #define LINKTYPE_IEEE802_5    DLT_IEEE802         /* DLT_IEEE802 is used for 802.5 Token Ring */
114 #define LINKTYPE_ARCNET_BSD   DLT_ARCNET          /* BSD-style headers */
115 #define LINKTYPE_SLIP                   DLT_SLIP
116 #define LINKTYPE_PPP                    DLT_PPP
117 #define LINKTYPE_FDDI                   DLT_FDDI
118 
119 /*
120  * LINKTYPE_PPP is for use when there might, or might not, be an RFC 1662
121  * PPP in HDLC-like framing header (with 0xff 0x03 before the PPP protocol
122  * field) at the beginning of the packet.
123  *
124  * This is for use when there is always such a header; the address field
125  * might be 0xff, for regular PPP, or it might be an address field for Cisco
126  * point-to-point with HDLC framing as per section 4.3.1 of RFC 1547 ("Cisco
127  * HDLC").  This is, for example, what you get with NetBSD's DLT_PPP_SERIAL.
128  *
129  * We give it the same value as NetBSD's DLT_PPP_SERIAL, in the hopes that
130  * nobody else will choose a DLT_ value of 50, and so that DLT_PPP_SERIAL
131  * captures will be written out with a link type that NetBSD's tcpdump
132  * can read.
133  */
134 #define LINKTYPE_PPP_HDLC     50                  /* PPP in HDLC-like framing */
135 
136 #define LINKTYPE_PPP_ETHER    51                  /* NetBSD PPP-over-Ethernet */
137 
138 #define LINKTYPE_SYMANTEC_FIREWALL 99             /* Symantec Enterprise Firewall */
139 
140 /*
141  * These correspond to DLT_s that have different values on different
142  * platforms; we map between these values in capture files and
143  * the DLT_ values as returned by pcap_datalink() and passed to
144  * pcap_open_dead().
145  */
146 #define LINKTYPE_ATM_RFC1483  100                 /* LLC/SNAP-encapsulated ATM */
147 #define LINKTYPE_RAW                    101                 /* raw IP */
148 #define LINKTYPE_SLIP_BSDOS   102                 /* BSD/OS SLIP BPF header */
149 #define LINKTYPE_PPP_BSDOS    103                 /* BSD/OS PPP BPF header */
150 
151 /*
152  * Values starting with 104 are used for newly-assigned link-layer
153  * header type values; for those link-layer header types, the DLT_
154  * value returned by pcap_datalink() and passed to pcap_open_dead(),
155  * and the LINKTYPE_ value that appears in capture files, are the
156  * same.
157  *
158  * LINKTYPE_MATCHING_MIN is the lowest such value; LINKTYPE_MATCHING_MAX
159  * is the highest such value.
160  */
161 #define LINKTYPE_MATCHING_MIN 104                 /* lowest value in the "matching" range */
162 
163 #define LINKTYPE_C_HDLC                 104                 /* Cisco HDLC */
164 #define LINKTYPE_IEEE802_11   105                 /* IEEE 802.11 (wireless) */
165 #define LINKTYPE_ATM_CLIP     106                 /* Linux Classical IP over ATM */
166 #define LINKTYPE_FRELAY                 107                 /* Frame Relay */
167 #define LINKTYPE_LOOP                   108                 /* OpenBSD loopback */
168 #define LINKTYPE_ENC                    109                 /* OpenBSD IPSEC enc */
169 
170 /*
171  * These three types are reserved for future use.
172  */
173 #define LINKTYPE_LANE8023     110                 /* ATM LANE + 802.3 */
174 #define LINKTYPE_HIPPI                  111                 /* NetBSD HIPPI */
175 #define LINKTYPE_HDLC                   112                 /* NetBSD HDLC framing */
176 
177 #define LINKTYPE_LINUX_SLL    113                 /* Linux cooked socket capture */
178 #define LINKTYPE_LTALK                  114                 /* Apple LocalTalk hardware */
179 #define LINKTYPE_ECONET                 115                 /* Acorn Econet */
180 
181 /*
182  * Reserved for use with OpenBSD ipfilter.
183  */
184 #define LINKTYPE_IPFILTER     116
185 
186 #define LINKTYPE_PFLOG                  117                 /* OpenBSD DLT_PFLOG */
187 #define LINKTYPE_CISCO_IOS    118                 /* For Cisco-internal use */
188 #define LINKTYPE_IEEE802_11_PRISM 119             /* 802.11 plus Prism II monitor mode radio metadata header */
189 #define LINKTYPE_IEEE802_11_AIRONET 120           /* 802.11 plus FreeBSD Aironet driver radio metadata header */
190 
191 /*
192  * Reserved for Siemens HiPath HDLC.
193  */
194 #define LINKTYPE_HHDLC                  121
195 
196 #define LINKTYPE_IP_OVER_FC   122                 /* RFC 2625 IP-over-Fibre Channel */
197 #define LINKTYPE_SUNATM                 123                 /* Solaris+SunATM */
198 
199 /*
200  * Reserved as per request from Kent Dahlgren <kent@praesum.com>
201  * for private use.
202  */
203 #define LINKTYPE_RIO                    124                 /* RapidIO */
204 #define LINKTYPE_PCI_EXP      125                 /* PCI Express */
205 #define LINKTYPE_AURORA                 126                 /* Xilinx Aurora link layer */
206 
207 #define LINKTYPE_IEEE802_11_RADIOTAP 127          /* 802.11 plus radiotap radio metadata header */
208 
209 /*
210  * Reserved for the TZSP encapsulation, as per request from
211  * Chris Waters <chris.waters@networkchemistry.com>
212  * TZSP is a generic encapsulation for any other link type,
213  * which includes a means to include meta-information
214  * with the packet, e.g. signal strength and channel
215  * for 802.11 packets.
216  */
217 #define LINKTYPE_TZSP                   128                 /* Tazmen Sniffer Protocol */
218 
219 #define LINKTYPE_ARCNET_LINUX 129                 /* Linux-style headers */
220 
221 /*
222  * Juniper-private data link types, as per request from
223  * Hannes Gredler <hannes@juniper.net>.  The corresponding
224  * DLT_s are used for passing on chassis-internal
225  * metainformation such as QOS profiles, etc..
226  */
227 #define LINKTYPE_JUNIPER_MLPPP  130
228 #define LINKTYPE_JUNIPER_MLFR   131
229 #define LINKTYPE_JUNIPER_ES     132
230 #define LINKTYPE_JUNIPER_GGSN   133
231 #define LINKTYPE_JUNIPER_MFR    134
232 #define LINKTYPE_JUNIPER_ATM2   135
233 #define LINKTYPE_JUNIPER_SERVICES 136
234 #define LINKTYPE_JUNIPER_ATM1   137
235 
236 #define LINKTYPE_APPLE_IP_OVER_IEEE1394 138       /* Apple IP-over-IEEE 1394 cooked header */
237 
238 #define LINKTYPE_MTP2_WITH_PHDR         139
239 #define LINKTYPE_MTP2                   140
240 #define LINKTYPE_MTP3                   141
241 #define LINKTYPE_SCCP                   142
242 
243 #define LINKTYPE_DOCSIS                 143                 /* DOCSIS MAC frames */
244 
245 #define LINKTYPE_LINUX_IRDA   144                 /* Linux-IrDA */
246 
247 /*
248  * Reserved for IBM SP switch and IBM Next Federation switch.
249  */
250 #define LINKTYPE_IBM_SP                 145
251 #define LINKTYPE_IBM_SN                 146
252 
253 /*
254  * Reserved for private use.  If you have some link-layer header type
255  * that you want to use within your organization, with the capture files
256  * using that link-layer header type not ever be sent outside your
257  * organization, you can use these values.
258  *
259  * No libpcap release will use these for any purpose, nor will any
260  * tcpdump release use them, either.
261  *
262  * Do *NOT* use these in capture files that you expect anybody not using
263  * your private versions of capture-file-reading tools to read; in
264  * particular, do *NOT* use them in products, otherwise you may find that
265  * people won't be able to use tcpdump, or snort, or Ethereal, or... to
266  * read capture files from your firewall/intrusion detection/traffic
267  * monitoring/etc. appliance, or whatever product uses that LINKTYPE_ value,
268  * and you may also find that the developers of those applications will
269  * not accept patches to let them read those files.
270  *
271  * Also, do not use them if somebody might send you a capture using them
272  * for *their* private type and tools using them for *your* private type
273  * would have to read them.
274  *
275  * Instead, in those cases, ask "tcpdump-workers@lists.tcpdump.org" for a
276  * new DLT_ and LINKTYPE_ value, as per the comment in pcap/bpf.h, and use
277  * the type you're given.
278  */
279 #define LINKTYPE_USER0                  147
280 #define LINKTYPE_USER1                  148
281 #define LINKTYPE_USER2                  149
282 #define LINKTYPE_USER3                  150
283 #define LINKTYPE_USER4                  151
284 #define LINKTYPE_USER5                  152
285 #define LINKTYPE_USER6                  153
286 #define LINKTYPE_USER7                  154
287 #define LINKTYPE_USER8                  155
288 #define LINKTYPE_USER9                  156
289 #define LINKTYPE_USER10                 157
290 #define LINKTYPE_USER11                 158
291 #define LINKTYPE_USER12                 159
292 #define LINKTYPE_USER13                 160
293 #define LINKTYPE_USER14                 161
294 #define LINKTYPE_USER15                 162
295 
296 /*
297  * For future use with 802.11 captures - defined by AbsoluteValue
298  * Systems to store a number of bits of link-layer information
299  * including radio information:
300  *
301  *        http://www.shaftnet.org/~pizza/software/capturefrm.txt
302  */
303 #define LINKTYPE_IEEE802_11_AVS         163       /* 802.11 plus AVS radio metadata header */
304 
305 /*
306  * Juniper-private data link type, as per request from
307  * Hannes Gredler <hannes@juniper.net>.  The corresponding
308  * DLT_s are used for passing on chassis-internal
309  * metainformation such as QOS profiles, etc..
310  */
311 #define LINKTYPE_JUNIPER_MONITOR 164
312 
313 /*
314  * BACnet MS/TP frames.
315  */
316 #define LINKTYPE_BACNET_MS_TP 165
317 
318 /*
319  * Another PPP variant as per request from Karsten Keil <kkeil@suse.de>.
320  *
321  * This is used in some OSes to allow a kernel socket filter to distinguish
322  * between incoming and outgoing packets, on a socket intended to
323  * supply pppd with outgoing packets so it can do dial-on-demand and
324  * hangup-on-lack-of-demand; incoming packets are filtered out so they
325  * don't cause pppd to hold the connection up (you don't want random
326  * input packets such as port scans, packets from old lost connections,
327  * etc. to force the connection to stay up).
328  *
329  * The first byte of the PPP header (0xff03) is modified to accommodate
330  * the direction - 0x00 = IN, 0x01 = OUT.
331  */
332 #define LINKTYPE_PPP_PPPD     166
333 
334 /*
335  * Juniper-private data link type, as per request from
336  * Hannes Gredler <hannes@juniper.net>.  The DLT_s are used
337  * for passing on chassis-internal metainformation such as
338  * QOS profiles, cookies, etc..
339  */
340 #define LINKTYPE_JUNIPER_PPPOE     167
341 #define LINKTYPE_JUNIPER_PPPOE_ATM 168
342 
343 #define LINKTYPE_GPRS_LLC     169                 /* GPRS LLC */
344 #define LINKTYPE_GPF_T                  170                 /* GPF-T (ITU-T G.7041/Y.1303) */
345 #define LINKTYPE_GPF_F                  171                 /* GPF-F (ITU-T G.7041/Y.1303) */
346 
347 /*
348  * Requested by Oolan Zimmer <oz@gcom.com> for use in Gcom's T1/E1 line
349  * monitoring equipment.
350  */
351 #define LINKTYPE_GCOM_T1E1    172
352 #define LINKTYPE_GCOM_SERIAL  173
353 
354 /*
355  * Juniper-private data link type, as per request from
356  * Hannes Gredler <hannes@juniper.net>.  The DLT_ is used
357  * for internal communication to Physical Interface Cards (PIC)
358  */
359 #define LINKTYPE_JUNIPER_PIC_PEER    174
360 
361 /*
362  * Link types requested by Gregor Maier <gregor@endace.com> of Endace
363  * Measurement Systems.  They add an ERF header (see
364  * https://www.endace.com/support/EndaceRecordFormat.pdf) in front of
365  * the link-layer header.
366  */
367 #define LINKTYPE_ERF_ETH      175       /* Ethernet */
368 #define LINKTYPE_ERF_POS      176       /* Packet-over-SONET */
369 
370 /*
371  * Requested by Daniele Orlandi <daniele@orlandi.com> for raw LAPD
372  * for vISDN (http://www.orlandi.com/visdn/).  Its link-layer header
373  * includes additional information before the LAPD header, so it's
374  * not necessarily a generic LAPD header.
375  */
376 #define LINKTYPE_LINUX_LAPD   177
377 
378 /*
379  * Juniper-private data link type, as per request from
380  * Hannes Gredler <hannes@juniper.net>.
381  * The Link Types are used for prepending meta-information
382  * like interface index, interface name
383  * before standard Ethernet, PPP, Frelay & C-HDLC Frames
384  */
385 #define LINKTYPE_JUNIPER_ETHER  178
386 #define LINKTYPE_JUNIPER_PPP    179
387 #define LINKTYPE_JUNIPER_FRELAY 180
388 #define LINKTYPE_JUNIPER_CHDLC  181
389 
390 /*
391  * Multi Link Frame Relay (FRF.16)
392  */
393 #define LINKTYPE_MFR            182
394 
395 /*
396  * Juniper-private data link type, as per request from
397  * Hannes Gredler <hannes@juniper.net>.
398  * The DLT_ is used for internal communication with a
399  * voice Adapter Card (PIC)
400  */
401 #define LINKTYPE_JUNIPER_VP     183
402 
403 /*
404  * Arinc 429 frames.
405  * DLT_ requested by Gianluca Varenni <gianluca.varenni@cacetech.com>.
406  * Every frame contains a 32bit A429 label.
407  * More documentation on Arinc 429 can be found at
408  * http://www.condoreng.com/support/downloads/tutorials/ARINCTutorial.pdf
409  */
410 #define LINKTYPE_A429           184
411 
412 /*
413  * Arinc 653 Interpartition Communication messages.
414  * DLT_ requested by Gianluca Varenni <gianluca.varenni@cacetech.com>.
415  * Please refer to the A653-1 standard for more information.
416  */
417 #define LINKTYPE_A653_ICM       185
418 
419 /*
420  * This used to be "USB packets, beginning with a USB setup header;
421  * requested by Paolo Abeni <paolo.abeni@email.it>."
422  *
423  * However, that header didn't work all that well - it left out some
424  * useful information - and was abandoned in favor of the DLT_USB_LINUX
425  * header.
426  *
427  * This is now used by FreeBSD for its BPF taps for USB; that has its
428  * own headers.  So it is written, so it is done.
429  */
430 #define LINKTYPE_USB_FREEBSD  186
431 
432 /*
433  * Bluetooth HCI UART transport layer (part H:4); requested by
434  * Paolo Abeni.
435  */
436 #define LINKTYPE_BLUETOOTH_HCI_H4       187
437 
438 /*
439  * IEEE 802.16 MAC Common Part Sublayer; requested by Maria Cruz
440  * <cruz_petagay@bah.com>.
441  */
442 #define LINKTYPE_IEEE802_16_MAC_CPS     188
443 
444 /*
445  * USB packets, beginning with a Linux USB header; requested by
446  * Paolo Abeni <paolo.abeni@email.it>.
447  */
448 #define LINKTYPE_USB_LINUX              189
449 
450 /*
451  * Controller Area Network (CAN) v. 2.0B packets.
452  * DLT_ requested by Gianluca Varenni <gianluca.varenni@cacetech.com>.
453  * Used to dump CAN packets coming from a CAN Vector board.
454  * More documentation on the CAN v2.0B frames can be found at
455  * http://www.can-cia.org/downloads/?269
456  */
457 #define LINKTYPE_CAN20B         190
458 
459 /*
460  * IEEE 802.15.4, with address fields padded, as is done by Linux
461  * drivers; requested by Juergen Schimmer.
462  */
463 #define LINKTYPE_IEEE802_15_4_LINUX     191
464 
465 /*
466  * Per Packet Information encapsulated packets.
467  * LINKTYPE_ requested by Gianluca Varenni <gianluca.varenni@cacetech.com>.
468  */
469 #define LINKTYPE_PPI                              192
470 
471 /*
472  * Header for 802.16 MAC Common Part Sublayer plus a radiotap radio header;
473  * requested by Charles Clancy.
474  */
475 #define LINKTYPE_IEEE802_16_MAC_CPS_RADIO         193
476 
477 /*
478  * Juniper-private data link type, as per request from
479  * Hannes Gredler <hannes@juniper.net>.
480  * The DLT_ is used for internal communication with a
481  * integrated service module (ISM).
482  */
483 #define LINKTYPE_JUNIPER_ISM    194
484 
485 /*
486  * IEEE 802.15.4, exactly as it appears in the spec (no padding, no
487  * nothing), and with the FCS at the end of the frame; requested by
488  * Mikko Saarnivala <mikko.saarnivala@sensinode.com>.
489  *
490  * This should only be used if the FCS is present at the end of the
491  * frame; if the frame has no FCS, DLT_IEEE802_15_4_NOFCS should be
492  * used.
493  */
494 #define LINKTYPE_IEEE802_15_4_WITHFCS   195
495 
496 /*
497  * Various link-layer types, with a pseudo-header, for SITA
498  * (https://www.sita.aero/); requested by Fulko Hew (fulko.hew@gmail.com).
499  */
500 #define LINKTYPE_SITA                   196
501 
502 /*
503  * Various link-layer types, with a pseudo-header, for Endace DAG cards;
504  * encapsulates Endace ERF records.  Requested by Stephen Donnelly
505  * <stephen@endace.com>.
506  */
507 #define LINKTYPE_ERF                    197
508 
509 /*
510  * Special header prepended to Ethernet packets when capturing from a
511  * u10 Networks board.  Requested by Phil Mulholland
512  * <phil@u10networks.com>.
513  */
514 #define LINKTYPE_RAIF1                  198
515 
516 /*
517  * IPMB packet for IPMI, beginning with a 2-byte header, followed by
518  * the I2C slave address, followed by the netFn and LUN, etc..
519  * Requested by Chanthy Toeung <chanthy.toeung@ca.kontron.com>.
520  *
521  * XXX - its DLT_ value used to be called DLT_IPMB, back when we got the
522  * impression from the email thread requesting it that the packet
523  * had no extra 2-byte header.  We've renamed it; if anybody used
524  * DLT_IPMB and assumed no 2-byte header, this will cause the compile
525  * to fail, at which point we'll have to figure out what to do about
526  * the two header types using the same DLT_/LINKTYPE_ value.  If that
527  * doesn't happen, we'll assume nobody used it and that the redefinition
528  * is safe.
529  */
530 #define LINKTYPE_IPMB_KONTRON 199
531 
532 /*
533  * Juniper-private data link type, as per request from
534  * Hannes Gredler <hannes@juniper.net>.
535  * The DLT_ is used for capturing data on a secure tunnel interface.
536  */
537 #define LINKTYPE_JUNIPER_ST     200
538 
539 /*
540  * Bluetooth HCI UART transport layer (part H:4), with pseudo-header
541  * that includes direction information; requested by Paolo Abeni.
542  */
543 #define LINKTYPE_BLUETOOTH_HCI_H4_WITH_PHDR       201
544 
545 /*
546  * AX.25 packet with a 1-byte KISS header; see
547  *
548  *        http://www.ax25.net/kiss.htm
549  *
550  * as per Richard Stearn <richard@rns-stearn.demon.co.uk>.
551  */
552 #define LINKTYPE_AX25_KISS    202
553 
554 /*
555  * LAPD packets from an ISDN channel, starting with the address field,
556  * with no pseudo-header.
557  * Requested by Varuna De Silva <varunax@gmail.com>.
558  */
559 #define LINKTYPE_LAPD                   203
560 
561 /*
562  * PPP, with a one-byte direction pseudo-header prepended - zero means
563  * "received by this host", non-zero (any non-zero value) means "sent by
564  * this host" - as per Will Barker <w.barker@zen.co.uk>.
565  */
566 #define LINKTYPE_PPP_WITH_DIR 204       /* Don't confuse with LINKTYPE_PPP_PPPD */
567 
568 /*
569  * Cisco HDLC, with a one-byte direction pseudo-header prepended - zero
570  * means "received by this host", non-zero (any non-zero value) means
571  * "sent by this host" - as per Will Barker <w.barker@zen.co.uk>.
572  */
573 #define LINKTYPE_C_HDLC_WITH_DIR 205    /* Cisco HDLC */
574 
575 /*
576  * Frame Relay, with a one-byte direction pseudo-header prepended - zero
577  * means "received by this host" (DCE -> DTE), non-zero (any non-zero
578  * value) means "sent by this host" (DTE -> DCE) - as per Will Barker
579  * <w.barker@zen.co.uk>.
580  */
581 #define LINKTYPE_FRELAY_WITH_DIR 206    /* Frame Relay */
582 
583 /*
584  * LAPB, with a one-byte direction pseudo-header prepended - zero means
585  * "received by this host" (DCE -> DTE), non-zero (any non-zero value)
586  * means "sent by this host" (DTE -> DCE)- as per Will Barker
587  * <w.barker@zen.co.uk>.
588  */
589 #define LINKTYPE_LAPB_WITH_DIR          207       /* LAPB */
590 
591 /*
592  * 208 is reserved for an as-yet-unspecified proprietary link-layer
593  * type, as requested by Will Barker.
594  */
595 
596 /*
597  * IPMB with a Linux-specific pseudo-header; as requested by Alexey Neyman
598  * <avn@pigeonpoint.com>.
599  */
600 #define LINKTYPE_IPMB_LINUX   209
601 
602 /*
603  * FlexRay automotive bus - http://www.flexray.com/ - as requested
604  * by Hannes Kaelber <hannes.kaelber@x2e.de>.
605  */
606 #define LINKTYPE_FLEXRAY      210
607 
608 /*
609  * Media Oriented Systems Transport (MOST) bus for multimedia
610  * transport - https://www.mostcooperation.com/ - as requested
611  * by Hannes Kaelber <hannes.kaelber@x2e.de>.
612  */
613 #define LINKTYPE_MOST                   211
614 
615 /*
616  * Local Interconnect Network (LIN) bus for vehicle networks -
617  * http://www.lin-subbus.org/ - as requested by Hannes Kaelber
618  * <hannes.kaelber@x2e.de>.
619  */
620 #define LINKTYPE_LIN                    212
621 
622 /*
623  * X2E-private data link type used for serial line capture,
624  * as requested by Hannes Kaelber <hannes.kaelber@x2e.de>.
625  */
626 #define LINKTYPE_X2E_SERIAL   213
627 
628 /*
629  * X2E-private data link type used for the Xoraya data logger
630  * family, as requested by Hannes Kaelber <hannes.kaelber@x2e.de>.
631  */
632 #define LINKTYPE_X2E_XORAYA   214
633 
634 /*
635  * IEEE 802.15.4, exactly as it appears in the spec (no padding, no
636  * nothing), but with the PHY-level data for non-ASK PHYs (4 octets
637  * of 0 as preamble, one octet of SFD, one octet of frame length+
638  * reserved bit, and then the MAC-layer data, starting with the
639  * frame control field).
640  *
641  * Requested by Max Filippov <jcmvbkbc@gmail.com>.
642  */
643 #define LINKTYPE_IEEE802_15_4_NONASK_PHY          215
644 
645 /*
646  * David Gibson <david@gibson.dropbear.id.au> requested this for
647  * captures from the Linux kernel /dev/input/eventN devices. This
648  * is used to communicate keystrokes and mouse movements from the
649  * Linux kernel to display systems, such as Xorg.
650  */
651 #define LINKTYPE_LINUX_EVDEV  216
652 
653 /*
654  * GSM Um and Abis interfaces, preceded by a "gsmtap" header.
655  *
656  * Requested by Harald Welte <laforge@gnumonks.org>.
657  */
658 #define LINKTYPE_GSMTAP_UM    217
659 #define LINKTYPE_GSMTAP_ABIS  218
660 
661 /*
662  * MPLS, with an MPLS label as the link-layer header.
663  * Requested by Michele Marchetto <michele@openbsd.org> on behalf
664  * of OpenBSD.
665  */
666 #define LINKTYPE_MPLS                   219
667 
668 /*
669  * USB packets, beginning with a Linux USB header, with the USB header
670  * padded to 64 bytes; required for memory-mapped access.
671  */
672 #define LINKTYPE_USB_LINUX_MMAPPED                220
673 
674 /*
675  * DECT packets, with a pseudo-header; requested by
676  * Matthias Wenzel <tcpdump@mazzoo.de>.
677  */
678 #define LINKTYPE_DECT                   221
679 
680 /*
681  * From: "Lidwa, Eric (GSFC-582.0)[SGT INC]" <eric.lidwa-1@nasa.gov>
682  * Date: Mon, 11 May 2009 11:18:30 -0500
683  *
684  * DLT_AOS. We need it for AOS Space Data Link Protocol.
685  *   I have already written dissectors for but need an OK from
686  *   legal before I can submit a patch.
687  *
688  */
689 #define LINKTYPE_AOS                    222
690 
691 /*
692  * Wireless HART (Highway Addressable Remote Transducer)
693  * From the HART Communication Foundation
694  * IES/PAS 62591
695  *
696  * Requested by Sam Roberts <vieuxtech@gmail.com>.
697  */
698 #define LINKTYPE_WIHART                 223
699 
700 /*
701  * Fibre Channel FC-2 frames, beginning with a Frame_Header.
702  * Requested by Kahou Lei <kahou82@gmail.com>.
703  */
704 #define LINKTYPE_FC_2                   224
705 
706 /*
707  * Fibre Channel FC-2 frames, beginning with an encoding of the
708  * SOF, and ending with an encoding of the EOF.
709  *
710  * The encodings represent the frame delimiters as 4-byte sequences
711  * representing the corresponding ordered sets, with K28.5
712  * represented as 0xBC, and the D symbols as the corresponding
713  * byte values; for example, SOFi2, which is K28.5 - D21.5 - D1.2 - D21.2,
714  * is represented as 0xBC 0xB5 0x55 0x55.
715  *
716  * Requested by Kahou Lei <kahou82@gmail.com>.
717  */
718 #define LINKTYPE_FC_2_WITH_FRAME_DELIMS           225
719 
720 /*
721  * Solaris ipnet pseudo-header; requested by Darren Reed <Darren.Reed@Sun.COM>.
722  *
723  * The pseudo-header starts with a one-byte version number; for version 2,
724  * the pseudo-header is:
725  *
726  * struct dl_ipnetinfo {
727  *     uint8_t   dli_version;
728  *     uint8_t   dli_family;
729  *     uint16_t  dli_htype;
730  *     uint32_t  dli_pktlen;
731  *     uint32_t  dli_ifindex;
732  *     uint32_t  dli_grifindex;
733  *     uint32_t  dli_zsrc;
734  *     uint32_t  dli_zdst;
735  * };
736  *
737  * dli_version is 2 for the current version of the pseudo-header.
738  *
739  * dli_family is a Solaris address family value, so it's 2 for IPv4
740  * and 26 for IPv6.
741  *
742  * dli_htype is a "hook type" - 0 for incoming packets, 1 for outgoing
743  * packets, and 2 for packets arriving from another zone on the same
744  * machine.
745  *
746  * dli_pktlen is the length of the packet data following the pseudo-header
747  * (so the captured length minus dli_pktlen is the length of the
748  * pseudo-header, assuming the entire pseudo-header was captured).
749  *
750  * dli_ifindex is the interface index of the interface on which the
751  * packet arrived.
752  *
753  * dli_grifindex is the group interface index number (for IPMP interfaces).
754  *
755  * dli_zsrc is the zone identifier for the source of the packet.
756  *
757  * dli_zdst is the zone identifier for the destination of the packet.
758  *
759  * A zone number of 0 is the global zone; a zone number of 0xffffffff
760  * means that the packet arrived from another host on the network, not
761  * from another zone on the same machine.
762  *
763  * An IPv4 or IPv6 datagram follows the pseudo-header; dli_family indicates
764  * which of those it is.
765  */
766 #define LINKTYPE_IPNET                  226
767 
768 /*
769  * CAN (Controller Area Network) frames, with a pseudo-header as supplied
770  * by Linux SocketCAN, and with multi-byte numerical fields in that header
771  * in big-endian byte order.
772  *
773  * See Documentation/networking/can.txt in the Linux source.
774  *
775  * Requested by Felix Obenhuber <felix@obenhuber.de>.
776  */
777 #define LINKTYPE_CAN_SOCKETCAN          227
778 
779 /*
780  * Raw IPv4/IPv6; different from DLT_RAW in that the DLT_ value specifies
781  * whether it's v4 or v6.  Requested by Darren Reed <Darren.Reed@Sun.COM>.
782  */
783 #define LINKTYPE_IPV4                   228
784 #define LINKTYPE_IPV6                   229
785 
786 /*
787  * IEEE 802.15.4, exactly as it appears in the spec (no padding, no
788  * nothing), and with no FCS at the end of the frame; requested by
789  * Jon Smirl <jonsmirl@gmail.com>.
790  */
791 #define LINKTYPE_IEEE802_15_4_NOFCS               230
792 
793 /*
794  * Raw D-Bus:
795  *
796  *        https://www.freedesktop.org/wiki/Software/dbus
797  *
798  * messages:
799  *
800  *        https://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-messages
801  *
802  * starting with the endianness flag, followed by the message type, etc.,
803  * but without the authentication handshake before the message sequence:
804  *
805  *        https://dbus.freedesktop.org/doc/dbus-specification.html#auth-protocol
806  *
807  * Requested by Martin Vidner <martin@vidner.net>.
808  */
809 #define LINKTYPE_DBUS                   231
810 
811 /*
812  * Juniper-private data link type, as per request from
813  * Hannes Gredler <hannes@juniper.net>.
814  */
815 #define LINKTYPE_JUNIPER_VS                       232
816 #define LINKTYPE_JUNIPER_SRX_E2E                  233
817 #define LINKTYPE_JUNIPER_FIBRECHANNEL             234
818 
819 /*
820  * DVB-CI (DVB Common Interface for communication between a PC Card
821  * module and a DVB receiver).  See
822  *
823  *        https://www.kaiser.cx/pcap-dvbci.html
824  *
825  * for the specification.
826  *
827  * Requested by Martin Kaiser <martin@kaiser.cx>.
828  */
829 #define LINKTYPE_DVB_CI                 235
830 
831 /*
832  * Variant of 3GPP TS 27.010 multiplexing protocol.  Requested
833  * by Hans-Christoph Schemmel <hans-christoph.schemmel@cinterion.com>.
834  */
835 #define LINKTYPE_MUX27010     236
836 
837 /*
838  * STANAG 5066 D_PDUs.  Requested by M. Baris Demiray
839  * <barisdemiray@gmail.com>.
840  */
841 #define LINKTYPE_STANAG_5066_D_PDU                237
842 
843 /*
844  * Juniper-private data link type, as per request from
845  * Hannes Gredler <hannes@juniper.net>.
846  */
847 #define LINKTYPE_JUNIPER_ATM_CEMIC                238
848 
849 /*
850  * NetFilter LOG messages
851  * (payload of netlink NFNL_SUBSYS_ULOG/NFULNL_MSG_PACKET packets)
852  *
853  * Requested by Jakub Zawadzki <darkjames-ws@darkjames.pl>
854  */
855 #define LINKTYPE_NFLOG                  239
856 
857 /*
858  * Hilscher Gesellschaft fuer Systemautomation mbH link-layer type
859  * for Ethernet packets with a 4-byte pseudo-header and always
860  * with the payload including the FCS, as supplied by their
861  * netANALYZER hardware and software.
862  *
863  * Requested by Holger P. Frommer <HPfrommer@hilscher.com>
864  */
865 #define LINKTYPE_NETANALYZER  240
866 
867 /*
868  * Hilscher Gesellschaft fuer Systemautomation mbH link-layer type
869  * for Ethernet packets with a 4-byte pseudo-header and FCS and
870  * 1 byte of SFD, as supplied by their netANALYZER hardware and
871  * software.
872  *
873  * Requested by Holger P. Frommer <HPfrommer@hilscher.com>
874  */
875 #define LINKTYPE_NETANALYZER_TRANSPARENT          241
876 
877 /*
878  * IP-over-InfiniBand, as specified by RFC 4391.
879  *
880  * Requested by Petr Sumbera <petr.sumbera@oracle.com>.
881  */
882 #define LINKTYPE_IPOIB                  242
883 
884 /*
885  * MPEG-2 transport stream (ISO 13818-1/ITU-T H.222.0).
886  *
887  * Requested by Guy Martin <gmsoft@tuxicoman.be>.
888  */
889 #define LINKTYPE_MPEG_2_TS    243
890 
891 /*
892  * ng4T GmbH's UMTS Iub/Iur-over-ATM and Iub/Iur-over-IP format as
893  * used by their ng40 protocol tester.
894  *
895  * Requested by Jens Grimmer <jens.grimmer@ng4t.com>.
896  */
897 #define LINKTYPE_NG40                   244
898 
899 /*
900  * Pseudo-header giving adapter number and flags, followed by an NFC
901  * (Near-Field Communications) Logical Link Control Protocol (LLCP) PDU,
902  * as specified by NFC Forum Logical Link Control Protocol Technical
903  * Specification LLCP 1.1.
904  *
905  * Requested by Mike Wakerly <mikey@google.com>.
906  */
907 #define LINKTYPE_NFC_LLCP     245
908 
909 /*
910  * pfsync output; DLT_PFSYNC is 18, which collides with DLT_CIP in
911  * SuSE 6.3, on OpenBSD, NetBSD, DragonFly BSD, and macOS, and
912  * is 121, which collides with DLT_HHDLC, in FreeBSD.  We pick a
913  * shiny new link-layer header type value that doesn't collide with
914  * anything, in the hopes that future pfsync savefiles, if any,
915  * won't require special hacks to distinguish from other savefiles.
916  *
917  */
918 #define LINKTYPE_PFSYNC                 246
919 
920 /*
921  * Raw InfiniBand packets, starting with the Local Routing Header.
922  *
923  * Requested by Oren Kladnitsky <orenk@mellanox.com>.
924  */
925 #define LINKTYPE_INFINIBAND   247
926 
927 /*
928  * SCTP, with no lower-level protocols (i.e., no IPv4 or IPv6).
929  *
930  * Requested by Michael Tuexen <Michael.Tuexen@lurchi.franken.de>.
931  */
932 #define LINKTYPE_SCTP                   248
933 
934 /*
935  * USB packets, beginning with a USBPcap header.
936  *
937  * Requested by Tomasz Mon <desowin@gmail.com>
938  */
939 #define LINKTYPE_USBPCAP      249
940 
941 /*
942  * Schweitzer Engineering Laboratories "RTAC" product serial-line
943  * packets.
944  *
945  * Requested by Chris Bontje <chris_bontje@selinc.com>.
946  */
947 #define LINKTYPE_RTAC_SERIAL            250
948 
949 /*
950  * Bluetooth Low Energy air interface link-layer packets.
951  *
952  * Requested by Mike Kershaw <dragorn@kismetwireless.net>.
953  */
954 #define LINKTYPE_BLUETOOTH_LE_LL        251
955 
956 /*
957  * Link-layer header type for upper-protocol layer PDU saves from wireshark.
958  *
959  * the actual contents are determined by two TAGs stored with each
960  * packet:
961  *   EXP_PDU_TAG_LINKTYPE          the link type (LINKTYPE_ value) of the
962  *                                         original packet.
963  *
964  *   EXP_PDU_TAG_PROTO_NAME        the name of the wireshark dissector
965  *                                         that can make sense of the data stored.
966  */
967 #define LINKTYPE_WIRESHARK_UPPER_PDU    252
968 
969 /*
970  * Link-layer header type for the netlink protocol (nlmon devices).
971  */
972 #define LINKTYPE_NETLINK                253
973 
974 /*
975  * Bluetooth Linux Monitor headers for the BlueZ stack.
976  */
977 #define LINKTYPE_BLUETOOTH_LINUX_MONITOR          254
978 
979 /*
980  * Bluetooth Basic Rate/Enhanced Data Rate baseband packets, as
981  * captured by Ubertooth.
982  */
983 #define LINKTYPE_BLUETOOTH_BREDR_BB     255
984 
985 /*
986  * Bluetooth Low Energy link layer packets, as captured by Ubertooth.
987  */
988 #define LINKTYPE_BLUETOOTH_LE_LL_WITH_PHDR        256
989 
990 /*
991  * PROFIBUS data link layer.
992  */
993 #define LINKTYPE_PROFIBUS_DL            257
994 
995 /*
996  * Apple's DLT_PKTAP headers.
997  *
998  * Sadly, the folks at Apple either had no clue that the DLT_USERn values
999  * are for internal use within an organization and partners only, and
1000  * didn't know that the right way to get a link-layer header type is to
1001  * ask tcpdump.org for one, or knew and didn't care, so they just
1002  * used DLT_USER2, which causes problems for everything except for
1003  * their version of tcpdump.
1004  *
1005  * So I'll just give them one; hopefully this will show up in a
1006  * libpcap release in time for them to get this into 10.10 Big Sur
1007  * or whatever Mavericks' successor is called.  LINKTYPE_PKTAP
1008  * will be 258 *even on macOS*; that is *intentional*, so that
1009  * PKTAP files look the same on *all* OSes (different OSes can have
1010  * different numerical values for a given DLT_, but *MUST NOT* have
1011  * different values for what goes in a file, as files can be moved
1012  * between OSes!).
1013  */
1014 #define LINKTYPE_PKTAP                  258
1015 
1016 /*
1017  * Ethernet packets preceded by a header giving the last 6 octets
1018  * of the preamble specified by 802.3-2012 Clause 65, section
1019  * 65.1.3.2 "Transmit".
1020  */
1021 #define LINKTYPE_EPON                   259
1022 
1023 /*
1024  * IPMI trace packets, as specified by Table 3-20 "Trace Data Block Format"
1025  * in the PICMG HPM.2 specification.
1026  */
1027 #define LINKTYPE_IPMI_HPM_2   260
1028 
1029 /*
1030  * per  Joshua Wright <jwright@hasborg.com>, formats for Zwave captures.
1031  */
1032 #define LINKTYPE_ZWAVE_R1_R2  261
1033 #define LINKTYPE_ZWAVE_R3     262
1034 
1035 /*
1036  * per Steve Karg <skarg@users.sourceforge.net>, formats for Wattstopper
1037  * Digital Lighting Management room bus serial protocol captures.
1038  */
1039 #define LINKTYPE_WATTSTOPPER_DLM 263
1040 
1041 /*
1042  * ISO 14443 contactless smart card messages.
1043  */
1044 #define LINKTYPE_ISO_14443      264
1045 
1046 /*
1047  * Radio data system (RDS) groups.  IEC 62106.
1048  * Per Jonathan Brucker <jonathan.brucke@gmail.com>.
1049  */
1050 #define LINKTYPE_RDS                    265
1051 
1052 /*
1053  * USB packets, beginning with a Darwin (macOS, etc.) header.
1054  */
1055 #define LINKTYPE_USB_DARWIN   266
1056 
1057 /*
1058  * OpenBSD DLT_OPENFLOW.
1059  */
1060 #define LINKTYPE_OPENFLOW     267
1061 
1062 /*
1063  * SDLC frames containing SNA PDUs.
1064  */
1065 #define LINKTYPE_SDLC                   268
1066 
1067 /*
1068  * per "Selvig, Bjorn" <b.selvig@ti.com> used for
1069  * TI protocol sniffer.
1070  */
1071 #define LINKTYPE_TI_LLN_SNIFFER         269
1072 
1073 /*
1074  * per: Erik de Jong <erikdejong at gmail.com> for
1075  *   https://github.com/eriknl/LoRaTap/releases/tag/v0.1
1076  */
1077 #define LINKTYPE_LORATAP        270
1078 
1079 /*
1080  * per: Stefanha at gmail.com for
1081  *   https://lists.sandelman.ca/pipermail/tcpdump-workers/2017-May/000772.html
1082  * and: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/include/uapi/linux/vsockmon.h
1083  * for: https://qemu-project.org/Features/VirtioVsock
1084  */
1085 #define LINKTYPE_VSOCK          271
1086 
1087 /*
1088  * Nordic Semiconductor Bluetooth LE sniffer.
1089  */
1090 #define LINKTYPE_NORDIC_BLE   272
1091 
1092 /*
1093  * Excentis DOCSIS 3.1 RF sniffer (XRA-31)
1094  *   per: bruno.verstuyft at excentis.com
1095  *        https://www.xra31.com/xra-header
1096  */
1097 #define LINKTYPE_DOCSIS31_XRA31         273
1098 
1099 /*
1100  * mPackets, as specified by IEEE 802.3br Figure 99-4, starting
1101  * with the preamble and always ending with a CRC field.
1102  */
1103 #define LINKTYPE_ETHERNET_MPACKET       274
1104 
1105 /*
1106  * DisplayPort AUX channel monitoring data as specified by VESA
1107  * DisplayPort(DP) Standard preceded by a pseudo-header.
1108  *    per dirk.eibach at gdsys.cc
1109  */
1110 #define LINKTYPE_DISPLAYPORT_AUX        275
1111 
1112 /*
1113  * Linux cooked sockets v2.
1114  */
1115 #define LINKTYPE_LINUX_SLL2   276
1116 
1117 /*
1118  * Sercos Monitor, per Manuel Jacob <manuel.jacob at steinbeis-stg.de>
1119  */
1120 #define LINKTYPE_SERCOS_MONITOR 277
1121 
1122 /*
1123  * OpenVizsla http://openvizsla.org is open source USB analyzer hardware.
1124  * It consists of FPGA with attached USB phy and FTDI chip for streaming
1125  * the data to the host PC.
1126  *
1127  * Current OpenVizsla data encapsulation format is described here:
1128  * https://github.com/matwey/libopenvizsla/wiki/OpenVizsla-protocol-description
1129  *
1130  */
1131 #define LINKTYPE_OPENVIZSLA     278
1132 
1133 /*
1134  * The Elektrobit High Speed Capture and Replay (EBHSCR) protocol is produced
1135  * by a PCIe Card for interfacing high speed automotive interfaces.
1136  *
1137  * The specification for this frame format can be found at:
1138  *   https://www.elektrobit.com/ebhscr
1139  *
1140  * for Guenter.Ebermann at elektrobit.com
1141  *
1142  */
1143 #define LINKTYPE_EBHSCR               279
1144 
1145 /*
1146  * The https://fd.io vpp graph dispatch tracer produces pcap trace files
1147  * in the format documented here:
1148  * https://fdio-vpp.readthedocs.io/en/latest/gettingstarted/developers/vnet.html#graph-dispatcher-pcap-tracing
1149  */
1150 #define LINKTYPE_VPP_DISPATCH 280
1151 
1152 /*
1153  * Broadcom Ethernet switches (ROBO switch) 4 bytes proprietary tagging format.
1154  */
1155 #define LINKTYPE_DSA_TAG_BRCM 281
1156 #define LINKTYPE_DSA_TAG_BRCM_PREPEND   282
1157 
1158 /*
1159  * IEEE 802.15.4 with pseudo-header and optional meta-data TLVs, PHY payload
1160  * exactly as it appears in the spec (no padding, no nothing), and FCS if
1161  * specified by FCS Type TLV;  requested by James Ko <jck@exegin.com>.
1162  * Specification at https://github.com/jkcko/ieee802.15.4-tap
1163  */
1164 #define LINKTYPE_IEEE802_15_4_TAP       283
1165 
1166 /*
1167  * Marvell (Ethertype) Distributed Switch Architecture proprietary tagging format.
1168  */
1169 #define LINKTYPE_DSA_TAG_DSA  284
1170 #define LINKTYPE_DSA_TAG_EDSA 285
1171 
1172 /*
1173  * Payload of lawful intercept packets using the ELEE protocol;
1174  * https://socket.hr/draft-dfranusic-opsawg-elee-00.xml
1175  * https://xml2rfc.tools.ietf.org/cgi-bin/xml2rfc.cgi?url=https://socket.hr/draft-dfranusic-opsawg-elee-00.xml&modeAsFormat=html/ascii
1176  */
1177 #define LINKTYPE_ELEE                   286
1178 
1179 /*
1180  * Serial frames transmitted between a host and a Z-Wave chip.
1181  */
1182 #define LINKTYPE_Z_WAVE_SERIAL          287
1183 
1184 /*
1185  * USB 2.0, 1.1, and 1.0 packets as transmitted over the cable.
1186  */
1187 #define LINKTYPE_USB_2_0      288
1188 
1189 /*
1190  * ATSC Link-Layer Protocol (A/330) packets.
1191  */
1192 #define LINKTYPE_ATSC_ALP     289
1193 
1194 #define LINKTYPE_MATCHING_MAX 289                 /* highest value in the "matching" range */
1195 
1196 /*
1197  * The DLT_ and LINKTYPE_ values in the "matching" range should be the
1198  * same, so DLT_MATCHING_MAX and LINKTYPE_MATCHING_MAX should be the
1199  * same.
1200  */
1201 #if LINKTYPE_MATCHING_MAX != DLT_MATCHING_MAX
1202 #error The LINKTYPE_ matching range does not match the DLT_ matching range
1203 #endif
1204 
1205 static struct linktype_map {
1206           int       dlt;
1207           int       linktype;
1208 } map[] = {
1209           /*
1210            * These DLT_* codes have LINKTYPE_* codes with values identical
1211            * to the values of the corresponding DLT_* code.
1212            */
1213           { DLT_NULL,                   LINKTYPE_NULL },
1214           { DLT_EN10MB,                 LINKTYPE_ETHERNET },
1215           { DLT_EN3MB,                  LINKTYPE_EXP_ETHERNET },
1216           { DLT_AX25,                   LINKTYPE_AX25 },
1217           { DLT_PRONET,                 LINKTYPE_PRONET },
1218           { DLT_CHAOS,                  LINKTYPE_CHAOS },
1219           { DLT_IEEE802,                LINKTYPE_IEEE802_5 },
1220           { DLT_ARCNET,                 LINKTYPE_ARCNET_BSD },
1221           { DLT_SLIP,                   LINKTYPE_SLIP },
1222           { DLT_PPP,                    LINKTYPE_PPP },
1223           { DLT_FDDI,                   LINKTYPE_FDDI },
1224           { DLT_SYMANTEC_FIREWALL, LINKTYPE_SYMANTEC_FIREWALL },
1225 
1226           /*
1227            * These DLT_* codes have different values on different
1228            * platforms; we map them to LINKTYPE_* codes that
1229            * have values that should never be equal to any DLT_*
1230            * code.
1231            */
1232 #ifdef DLT_FR
1233           /* BSD/OS Frame Relay */
1234           { DLT_FR,           LINKTYPE_FRELAY },
1235 #endif
1236 
1237           { DLT_ATM_RFC1483,  LINKTYPE_ATM_RFC1483 },
1238           { DLT_RAW,                    LINKTYPE_RAW },
1239           { DLT_SLIP_BSDOS,   LINKTYPE_SLIP_BSDOS },
1240           { DLT_PPP_BSDOS,    LINKTYPE_PPP_BSDOS },
1241 
1242           /* BSD/OS Cisco HDLC */
1243           { DLT_C_HDLC,                 LINKTYPE_C_HDLC },
1244 
1245           /*
1246            * These DLT_* codes are not on all platforms, but, so far,
1247            * there don't appear to be any platforms that define
1248            * other codes with those values; we map them to
1249            * different LINKTYPE_* values anyway, just in case.
1250            */
1251 
1252           /* Linux ATM Classical IP */
1253           { DLT_ATM_CLIP,               LINKTYPE_ATM_CLIP },
1254 
1255           /* NetBSD sync/async serial PPP (or Cisco HDLC) */
1256           { DLT_PPP_SERIAL,   LINKTYPE_PPP_HDLC },
1257 
1258           /* NetBSD PPP over Ethernet */
1259           { DLT_PPP_ETHER,    LINKTYPE_PPP_ETHER },
1260 
1261           /*
1262            * All LINKTYPE_ values between LINKTYPE_MATCHING_MIN
1263            * and LINKTYPE_MATCHING_MAX are mapped to identical
1264            * DLT_ values.
1265            */
1266 
1267           { -1,                         -1 }
1268 };
1269 
1270 int
dlt_to_linktype(int dlt)1271 dlt_to_linktype(int dlt)
1272 {
1273           int i;
1274 
1275           /*
1276            * DLTs that, on some platforms, have values in the matching range
1277            * but that *don't* have the same value as the corresponding
1278            * LINKTYPE because, for some reason, not all OSes have the
1279            * same value for that DLT (note that the DLT's value might be
1280            * outside the matching range on some of those OSes).
1281            */
1282           if (dlt == DLT_PFSYNC)
1283                     return (LINKTYPE_PFSYNC);
1284           if (dlt == DLT_PKTAP)
1285                     return (LINKTYPE_PKTAP);
1286 
1287           /*
1288            * For all other values in the matching range, the DLT
1289            * value is the same as the LINKTYPE value.
1290            */
1291           if (dlt >= DLT_MATCHING_MIN && dlt <= DLT_MATCHING_MAX)
1292                     return (dlt);
1293 
1294           /*
1295            * Map the values outside that range.
1296            */
1297           for (i = 0; map[i].dlt != -1; i++) {
1298                     if (map[i].dlt == dlt)
1299                               return (map[i].linktype);
1300           }
1301 
1302           /*
1303            * If we don't have a mapping for this DLT, return an
1304            * error; that means that this is a value with no corresponding
1305            * LINKTYPE, and we need to assign one.
1306            */
1307           return (-1);
1308 }
1309 
1310 int
linktype_to_dlt(int linktype)1311 linktype_to_dlt(int linktype)
1312 {
1313           int i;
1314 
1315           /*
1316            * LINKTYPEs in the matching range that *don't*
1317            * have the same value as the corresponding DLTs
1318            * because, for some reason, not all OSes have the
1319            * same value for that DLT.
1320            */
1321           if (linktype == LINKTYPE_PFSYNC)
1322                     return (DLT_PFSYNC);
1323           if (linktype == LINKTYPE_PKTAP)
1324                     return (DLT_PKTAP);
1325 
1326           /*
1327            * For all other values in the matching range, except for
1328            * LINKTYPE_ATM_CLIP, the LINKTYPE value is the same as
1329            * the DLT value.
1330            *
1331            * LINKTYPE_ATM_CLIP is a special case.  DLT_ATM_CLIP is
1332            * not on all platforms, but, so far, there don't appear
1333            * to be any platforms that define it as anything other
1334            * than 19; we define LINKTYPE_ATM_CLIP as something
1335            * other than 19, just in case.  That value is in the
1336            * matching range, so we have to check for it.
1337            */
1338           if (linktype >= LINKTYPE_MATCHING_MIN &&
1339               linktype <= LINKTYPE_MATCHING_MAX &&
1340               linktype != LINKTYPE_ATM_CLIP)
1341                     return (linktype);
1342 
1343           /*
1344            * Map the values outside that range.
1345            */
1346           for (i = 0; map[i].linktype != -1; i++) {
1347                     if (map[i].linktype == linktype)
1348                               return (map[i].dlt);
1349           }
1350 
1351           /*
1352            * If we don't have an entry for this LINKTYPE, return
1353            * the link type value; it may be a DLT from an newer
1354            * version of libpcap.
1355            */
1356           return linktype;
1357 }
1358 
1359 /*
1360  * Return the maximum snapshot length for a given DLT_ value.
1361  *
1362  * For most link-layer types, we use MAXIMUM_SNAPLEN.
1363  *
1364  * For DLT_DBUS, the maximum is 128MiB, as per
1365  *
1366  *    https://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-messages
1367  *
1368  * For DLT_EBHSCR, the maximum is 8MiB, as per
1369  *
1370  *    https://www.elektrobit.com/ebhscr
1371  *
1372  * For DLT_USBPCAP, the maximum is 1MiB, as per
1373  *
1374  *    https://bugs.wireshark.org/bugzilla/show_bug.cgi?id=15985
1375  */
1376 u_int
max_snaplen_for_dlt(int dlt)1377 max_snaplen_for_dlt(int dlt)
1378 {
1379           switch (dlt) {
1380 
1381           case DLT_DBUS:
1382                     return 128*1024*1024;
1383 
1384           case DLT_EBHSCR:
1385                     return 8*1024*1024;
1386 
1387           case DLT_USBPCAP:
1388                     return 1024*1024;
1389 
1390           default:
1391                     return MAXIMUM_SNAPLEN;
1392           }
1393 }
1394 
1395 /*
1396  * DLT_LINUX_SLL packets with a protocol type of LINUX_SLL_P_CAN or
1397  * LINUX_SLL_P_CANFD have SocketCAN headers in front of the payload,
1398  * with the CAN ID being in host byte order.
1399  *
1400  * When reading a DLT_LINUX_SLL capture file, we need to check for those
1401  * packets and convert the CAN ID from the byte order of the host that
1402  * wrote the file to this host's byte order.
1403  */
1404 static void
swap_linux_sll_header(const struct pcap_pkthdr * hdr,u_char * buf)1405 swap_linux_sll_header(const struct pcap_pkthdr *hdr, u_char *buf)
1406 {
1407           u_int caplen = hdr->caplen;
1408           u_int length = hdr->len;
1409           struct sll_header *shdr = (struct sll_header *)buf;
1410           uint16_t protocol;
1411           pcap_can_socketcan_hdr *chdr;
1412 
1413           if (caplen < (u_int) sizeof(struct sll_header) ||
1414               length < (u_int) sizeof(struct sll_header)) {
1415                     /* Not enough data to have the protocol field */
1416                     return;
1417           }
1418 
1419           protocol = EXTRACT_BE_U_2(&shdr->sll_protocol);
1420           if (protocol != LINUX_SLL_P_CAN && protocol != LINUX_SLL_P_CANFD)
1421                     return;
1422 
1423           /*
1424            * SocketCAN packet; fix up the packet's header.
1425            */
1426           chdr = (pcap_can_socketcan_hdr *)(buf + sizeof(struct sll_header));
1427           if (caplen < (u_int) sizeof(struct sll_header) + sizeof(chdr->can_id) ||
1428               length < (u_int) sizeof(struct sll_header) + sizeof(chdr->can_id)) {
1429                     /* Not enough data to have the CAN ID */
1430                     return;
1431           }
1432           chdr->can_id = SWAPLONG(chdr->can_id);
1433 }
1434 
1435 /*
1436  * The DLT_USB_LINUX and DLT_USB_LINUX_MMAPPED headers are in host
1437  * byte order when capturing (it's supplied directly from a
1438  * memory-mapped buffer shared by the kernel).
1439  *
1440  * When reading a DLT_USB_LINUX or DLT_USB_LINUX_MMAPPED capture file,
1441  * we need to convert it from the byte order of the host that wrote
1442  * the file to this host's byte order.
1443  */
1444 static void
swap_linux_usb_header(const struct pcap_pkthdr * hdr,u_char * buf,int header_len_64_bytes)1445 swap_linux_usb_header(const struct pcap_pkthdr *hdr, u_char *buf,
1446     int header_len_64_bytes)
1447 {
1448           pcap_usb_header_mmapped *uhdr = (pcap_usb_header_mmapped *)buf;
1449           bpf_u_int32 offset = 0;
1450 
1451           /*
1452            * "offset" is the offset *past* the field we're swapping;
1453            * we skip the field *before* checking to make sure
1454            * the captured data length includes the entire field.
1455            */
1456 
1457           /*
1458            * The URB id is a totally opaque value; do we really need to
1459            * convert it to the reading host's byte order???
1460            */
1461           offset += 8;                            /* skip past id */
1462           if (hdr->caplen < offset)
1463                     return;
1464           uhdr->id = SWAPLL(uhdr->id);
1465 
1466           offset += 4;                            /* skip past various 1-byte fields */
1467 
1468           offset += 2;                            /* skip past bus_id */
1469           if (hdr->caplen < offset)
1470                     return;
1471           uhdr->bus_id = SWAPSHORT(uhdr->bus_id);
1472 
1473           offset += 2;                            /* skip past various 1-byte fields */
1474 
1475           offset += 8;                            /* skip past ts_sec */
1476           if (hdr->caplen < offset)
1477                     return;
1478           uhdr->ts_sec = SWAPLL(uhdr->ts_sec);
1479 
1480           offset += 4;                            /* skip past ts_usec */
1481           if (hdr->caplen < offset)
1482                     return;
1483           uhdr->ts_usec = SWAPLONG(uhdr->ts_usec);
1484 
1485           offset += 4;                            /* skip past status */
1486           if (hdr->caplen < offset)
1487                     return;
1488           uhdr->status = SWAPLONG(uhdr->status);
1489 
1490           offset += 4;                            /* skip past urb_len */
1491           if (hdr->caplen < offset)
1492                     return;
1493           uhdr->urb_len = SWAPLONG(uhdr->urb_len);
1494 
1495           offset += 4;                            /* skip past data_len */
1496           if (hdr->caplen < offset)
1497                     return;
1498           uhdr->data_len = SWAPLONG(uhdr->data_len);
1499 
1500           if (uhdr->transfer_type == URB_ISOCHRONOUS) {
1501                     offset += 4;                            /* skip past s.iso.error_count */
1502                     if (hdr->caplen < offset)
1503                               return;
1504                     uhdr->s.iso.error_count = SWAPLONG(uhdr->s.iso.error_count);
1505 
1506                     offset += 4;                            /* skip past s.iso.numdesc */
1507                     if (hdr->caplen < offset)
1508                               return;
1509                     uhdr->s.iso.numdesc = SWAPLONG(uhdr->s.iso.numdesc);
1510           } else
1511                     offset += 8;                            /* skip USB setup header */
1512 
1513           /*
1514            * With the old header, there are no isochronous descriptors
1515            * after the header.
1516            *
1517            * With the new header, the actual number of descriptors in
1518            * the header is not s.iso.numdesc, it's ndesc - only the
1519            * first N descriptors, for some value of N, are put into
1520            * the header, and ndesc is set to the actual number copied.
1521            * In addition, if s.iso.numdesc is negative, no descriptors
1522            * are captured, and ndesc is set to 0.
1523            */
1524           if (header_len_64_bytes) {
1525                     /*
1526                      * This is either the "version 1" header, with
1527                      * 16 bytes of additional fields at the end, or
1528                      * a "version 0" header from a memory-mapped
1529                      * capture, with 16 bytes of zeroed-out padding
1530                      * at the end.  Byte swap them as if this were
1531                      * a "version 1" header.
1532                      */
1533                     offset += 4;                            /* skip past interval */
1534                     if (hdr->caplen < offset)
1535                               return;
1536                     uhdr->interval = SWAPLONG(uhdr->interval);
1537 
1538                     offset += 4;                            /* skip past start_frame */
1539                     if (hdr->caplen < offset)
1540                               return;
1541                     uhdr->start_frame = SWAPLONG(uhdr->start_frame);
1542 
1543                     offset += 4;                            /* skip past xfer_flags */
1544                     if (hdr->caplen < offset)
1545                               return;
1546                     uhdr->xfer_flags = SWAPLONG(uhdr->xfer_flags);
1547 
1548                     offset += 4;                            /* skip past ndesc */
1549                     if (hdr->caplen < offset)
1550                               return;
1551                     uhdr->ndesc = SWAPLONG(uhdr->ndesc);
1552 
1553                     if (uhdr->transfer_type == URB_ISOCHRONOUS) {
1554                               /* swap the values in struct linux_usb_isodesc */
1555                               usb_isodesc *pisodesc;
1556                               uint32_t i;
1557 
1558                               pisodesc = (usb_isodesc *)(void *)(buf+offset);
1559                               for (i = 0; i < uhdr->ndesc; i++) {
1560                                         offset += 4;                  /* skip past status */
1561                                         if (hdr->caplen < offset)
1562                                                   return;
1563                                         pisodesc->status = SWAPLONG(pisodesc->status);
1564 
1565                                         offset += 4;                  /* skip past offset */
1566                                         if (hdr->caplen < offset)
1567                                                   return;
1568                                         pisodesc->offset = SWAPLONG(pisodesc->offset);
1569 
1570                                         offset += 4;                  /* skip past len */
1571                                         if (hdr->caplen < offset)
1572                                                   return;
1573                                         pisodesc->len = SWAPLONG(pisodesc->len);
1574 
1575                                         offset += 4;                  /* skip past padding */
1576 
1577                                         pisodesc++;
1578                               }
1579                     }
1580           }
1581 }
1582 
1583 /*
1584  * The DLT_NFLOG "packets" have a mixture of big-endian and host-byte-order
1585  * data.  They begin with a fixed-length header with big-endian fields,
1586  * followed by a set of TLVs, where the type and length are in host
1587  * byte order but the values are either big-endian or are a raw byte
1588  * sequence that's the same regardless of the host's byte order.
1589  *
1590  * When reading a DLT_NFLOG capture file, we need to convert the type
1591  * and length values from the byte order of the host that wrote the
1592  * file to the byte order of this host.
1593  */
1594 static void
swap_nflog_header(const struct pcap_pkthdr * hdr,u_char * buf)1595 swap_nflog_header(const struct pcap_pkthdr *hdr, u_char *buf)
1596 {
1597           u_char *p = buf;
1598           nflog_hdr_t *nfhdr = (nflog_hdr_t *)buf;
1599           nflog_tlv_t *tlv;
1600           u_int caplen = hdr->caplen;
1601           u_int length = hdr->len;
1602           uint16_t size;
1603 
1604           if (caplen < (u_int) sizeof(nflog_hdr_t) ||
1605               length < (u_int) sizeof(nflog_hdr_t)) {
1606                     /* Not enough data to have any TLVs. */
1607                     return;
1608           }
1609 
1610           if (nfhdr->nflog_version != 0) {
1611                     /* Unknown NFLOG version */
1612                     return;
1613           }
1614 
1615           length -= sizeof(nflog_hdr_t);
1616           caplen -= sizeof(nflog_hdr_t);
1617           p += sizeof(nflog_hdr_t);
1618 
1619           while (caplen >= sizeof(nflog_tlv_t)) {
1620                     tlv = (nflog_tlv_t *) p;
1621 
1622                     /* Swap the type and length. */
1623                     tlv->tlv_type = SWAPSHORT(tlv->tlv_type);
1624                     tlv->tlv_length = SWAPSHORT(tlv->tlv_length);
1625 
1626                     /* Get the length of the TLV. */
1627                     size = tlv->tlv_length;
1628                     if (size % 4 != 0)
1629                               size += 4 - size % 4;
1630 
1631                     /* Is the TLV's length less than the minimum? */
1632                     if (size < sizeof(nflog_tlv_t)) {
1633                               /* Yes. Give up now. */
1634                               return;
1635                     }
1636 
1637                     /* Do we have enough data for the full TLV? */
1638                     if (caplen < size || length < size) {
1639                               /* No. */
1640                               return;
1641                     }
1642 
1643                     /* Skip over the TLV. */
1644                     length -= size;
1645                     caplen -= size;
1646                     p += size;
1647           }
1648 }
1649 
1650 void
swap_pseudo_headers(int linktype,struct pcap_pkthdr * hdr,u_char * data)1651 swap_pseudo_headers(int linktype, struct pcap_pkthdr *hdr, u_char *data)
1652 {
1653           /*
1654            * Convert pseudo-headers from the byte order of
1655            * the host on which the file was saved to our
1656            * byte order, as necessary.
1657            */
1658           switch (linktype) {
1659 
1660           case DLT_LINUX_SLL:
1661                     swap_linux_sll_header(hdr, data);
1662                     break;
1663 
1664           case DLT_USB_LINUX:
1665                     swap_linux_usb_header(hdr, data, 0);
1666                     break;
1667 
1668           case DLT_USB_LINUX_MMAPPED:
1669                     swap_linux_usb_header(hdr, data, 1);
1670                     break;
1671 
1672           case DLT_NFLOG:
1673                     swap_nflog_header(hdr, data);
1674                     break;
1675           }
1676 }
1677