xref: /dragonfly/contrib/libpcap/pcap-common.c (revision f9993810)
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
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
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
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
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
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
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
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