libpcap  1.10.1
About: libpcap is a packet filter library used by tools like tcpdump.
  Fossies Dox: libpcap-1.10.1.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

pcap-common.c
Go to the documentation of this file.
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;
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 },
1216  { DLT_AX25, LINKTYPE_AX25 },
1221  { DLT_SLIP, LINKTYPE_SLIP },
1222  { DLT_PPP, LINKTYPE_PPP },
1223  { DLT_FDDI, LINKTYPE_FDDI },
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 
1238  { DLT_RAW, LINKTYPE_RAW },
1241 
1242  /* BSD/OS Cisco 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 */
1254 
1255  /* NetBSD sync/async serial PPP (or Cisco HDLC) */
1257 
1258  /* NetBSD PPP over Ethernet */
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
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
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 {
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 }
u_int bpf_u_int32
Definition: bpf.h:98
#define DLT_RAW
Definition: dlt.h:88
#define DLT_PFSYNC
Definition: dlt.h:1177
#define DLT_PPP_SERIAL
Definition: dlt.h:152
#define DLT_IEEE802
Definition: dlt.h:68
#define DLT_EN10MB
Definition: dlt.h:63
#define DLT_SYMANTEC_FIREWALL
Definition: dlt.h:162
#define DLT_PPP_BSDOS
Definition: dlt.h:104
#define DLT_ARCNET
Definition: dlt.h:69
#define DLT_CHAOS
Definition: dlt.h:67
#define DLT_SLIP
Definition: dlt.h:70
#define DLT_ATM_RFC1483
Definition: dlt.h:83
#define DLT_PRONET
Definition: dlt.h:66
#define DLT_NULL
Definition: dlt.h:62
#define DLT_USBPCAP
Definition: dlt.h:1199
#define DLT_MATCHING_MIN
Definition: dlt.h:181
#define DLT_EBHSCR
Definition: dlt.h:1432
#define DLT_ATM_CLIP
Definition: dlt.h:139
#define DLT_PPP_ETHER
Definition: dlt.h:153
#define DLT_LINUX_SLL
Definition: dlt.h:251
#define DLT_AX25
Definition: dlt.h:65
#define DLT_NFLOG
Definition: dlt.h:1114
#define DLT_USB_LINUX
Definition: dlt.h:701
#define DLT_DBUS
Definition: dlt.h:1067
#define DLT_MATCHING_MAX
Definition: dlt.h:1493
#define DLT_PPP
Definition: dlt.h:71
#define DLT_USB_LINUX_MMAPPED
Definition: dlt.h:930
#define DLT_PKTAP
Definition: dlt.h:1302
#define DLT_EN3MB
Definition: dlt.h:64
#define DLT_SLIP_BSDOS
Definition: dlt.h:103
#define DLT_FDDI
Definition: dlt.h:72
#define DLT_C_HDLC
Definition: dlt.h:197
#define EXTRACT_BE_U_2(p)
Definition: extract.h:242
#define SWAPLONG(y)
Definition: gencode.c:1955
struct nflog_hdr nflog_hdr_t
static void swap_linux_usb_header(const struct pcap_pkthdr *hdr, u_char *buf, int header_len_64_bytes)
Definition: pcap-common.c:1445
#define LINKTYPE_MATCHING_MIN
Definition: pcap-common.c:161
#define LINKTYPE_SLIP_BSDOS
Definition: pcap-common.c:148
#define LINKTYPE_ATM_RFC1483
Definition: pcap-common.c:146
#define LINKTYPE_AX25
Definition: pcap-common.c:110
#define LINKTYPE_PPP_ETHER
Definition: pcap-common.c:136
#define LINKTYPE_ETHERNET
Definition: pcap-common.c:108
static void swap_nflog_header(const struct pcap_pkthdr *hdr, u_char *buf)
Definition: pcap-common.c:1595
#define LINKTYPE_IEEE802_5
Definition: pcap-common.c:113
int linktype_to_dlt(int linktype)
Definition: pcap-common.c:1311
#define LINKTYPE_RAW
Definition: pcap-common.c:147
static struct linktype_map map[]
u_int max_snaplen_for_dlt(int dlt)
Definition: pcap-common.c:1377
static void swap_linux_sll_header(const struct pcap_pkthdr *hdr, u_char *buf)
Definition: pcap-common.c:1405
#define LINKTYPE_FDDI
Definition: pcap-common.c:117
#define LINKTYPE_ARCNET_BSD
Definition: pcap-common.c:114
int dlt_to_linktype(int dlt)
Definition: pcap-common.c:1271
#define LINKTYPE_MATCHING_MAX
Definition: pcap-common.c:1194
#define LINKTYPE_PRONET
Definition: pcap-common.c:111
#define LINKTYPE_ATM_CLIP
Definition: pcap-common.c:165
#define LINKTYPE_EXP_ETHERNET
Definition: pcap-common.c:109
#define LINKTYPE_PPP
Definition: pcap-common.c:116
#define LINKTYPE_CHAOS
Definition: pcap-common.c:112
#define LINKTYPE_PPP_HDLC
Definition: pcap-common.c:134
#define LINKTYPE_PKTAP
Definition: pcap-common.c:1014
#define LINKTYPE_PPP_BSDOS
Definition: pcap-common.c:149
#define LINKTYPE_SYMANTEC_FIREWALL
Definition: pcap-common.c:138
#define LINKTYPE_SLIP
Definition: pcap-common.c:115
#define LINKTYPE_PFSYNC
Definition: pcap-common.c:918
void swap_pseudo_headers(int linktype, struct pcap_pkthdr *hdr, u_char *data)
Definition: pcap-common.c:1651
#define LINKTYPE_NULL
Definition: pcap-common.c:107
#define LINKTYPE_C_HDLC
Definition: pcap-common.c:163
#define LINKTYPE_FRELAY
Definition: pcap-common.c:166
#define SWAPSHORT(y)
Definition: pcap-common.h:42
#define MAXIMUM_SNAPLEN
Definition: pcap-int.h:131
#define SWAPLL(ull)
Definition: pcap-int.h:96
#define LINUX_SLL_P_CAN
Definition: sll.h:146
#define LINUX_SLL_P_CANFD
Definition: sll.h:147
int32_t error_count
Definition: usb.h:71
int32_t numdesc
Definition: usb.h:72
uint16_t bus_id
Definition: usb.h:110
int32_t interval
Definition: usb.h:122
uint32_t ndesc
Definition: usb.h:125
int32_t ts_usec
Definition: usb.h:114
int64_t ts_sec
Definition: usb.h:113
uint32_t data_len
Definition: usb.h:117
uint32_t xfer_flags
Definition: usb.h:124
iso_rec iso
Definition: usb.h:120
uint8_t transfer_type
Definition: usb.h:107
uint32_t urb_len
Definition: usb.h:116
int32_t status
Definition: usb.h:115
uint64_t id
Definition: usb.h:105
union _usb_header_mmapped::@3 s
int32_t start_frame
Definition: usb.h:123
int32_t status
Definition: usb.h:137
uint32_t offset
Definition: usb.h:138
uint32_t len
Definition: usb.h:139
uint8_t nflog_version
Definition: nflog.h:46
uint16_t tlv_length
Definition: nflog.h:51
uint16_t tlv_type
Definition: nflog.h:52
bpf_u_int32 caplen
Definition: pcap.h:247
bpf_u_int32 len
Definition: pcap.h:248
Definition: sll.h:85
uint16_t sll_protocol
Definition: sll.h:90
#define URB_ISOCHRONOUS
Definition: usb.h:43