2 * Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997
3 * The Regents of the University of California. All rights reserved.
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
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.
22 #include <sys/cdefs.h>
24 __RCSID("$NetBSD: print-sll.c,v 1.6 2015/03/31 21:59:35 christos Exp $");
27 #define NETDISSECT_REWORKED
32 #include <tcpdump-stdinc.h>
34 #include "interface.h"
35 #include "addrtoname.h"
36 #include "ethertype.h"
42 * For captures on Linux cooked sockets, we construct a fake header
45 * a 2-byte "packet type" which is one of:
47 * LINUX_SLL_HOST packet was sent to us
48 * LINUX_SLL_BROADCAST packet was broadcast
49 * LINUX_SLL_MULTICAST packet was multicast
50 * LINUX_SLL_OTHERHOST packet was sent to somebody else
51 * LINUX_SLL_OUTGOING packet was sent *by* us;
53 * a 2-byte Ethernet protocol field;
55 * a 2-byte link-layer type;
57 * a 2-byte link-layer address length;
59 * an 8-byte source link-layer address, whose actual length is
60 * specified by the previous value.
62 * All fields except for the link-layer address are in network byte order.
64 * DO NOT change the layout of this structure, or change any of the
65 * LINUX_SLL_ values below. If you must change the link-layer header
66 * for a "cooked" Linux capture, introduce a new DLT_ type (ask
67 * "tcpdump-workers@lists.tcpdump.org" for one, so that you don't give it
68 * a value that collides with a value already being used), and use the
69 * new header in captures of that type, so that programs that can
70 * handle DLT_LINUX_SLL captures will continue to handle them correctly
71 * without any change, and so that capture files with different headers
72 * can be told apart and programs that read them can dissect the
75 * This structure, and the #defines below, must be the same in the
76 * libpcap and tcpdump versions of "sll.h".
80 * A DLT_LINUX_SLL fake link-layer header.
82 #define SLL_HDR_LEN 16 /* total header length */
83 #define SLL_ADDRLEN 8 /* length of address field */
86 uint16_t sll_pkttype
; /* packet type */
87 uint16_t sll_hatype
; /* link-layer address type */
88 uint16_t sll_halen
; /* link-layer address length */
89 uint8_t sll_addr
[SLL_ADDRLEN
]; /* link-layer address */
90 uint16_t sll_protocol
; /* protocol */
94 * The LINUX_SLL_ values for "sll_pkttype"; these correspond to the
95 * PACKET_ values on Linux, but are defined here so that they're
96 * available even on systems other than Linux, and so that they
97 * don't change even if the PACKET_ values change.
99 #define LINUX_SLL_HOST 0
100 #define LINUX_SLL_BROADCAST 1
101 #define LINUX_SLL_MULTICAST 2
102 #define LINUX_SLL_OTHERHOST 3
103 #define LINUX_SLL_OUTGOING 4
106 * The LINUX_SLL_ values for "sll_protocol"; these correspond to the
107 * ETH_P_ values on Linux, but are defined here so that they're
108 * available even on systems other than Linux. We assume, for now,
109 * that the ETH_P_ values won't change in Linux; if they do, then:
111 * if we don't translate them in "pcap-linux.c", capture files
112 * won't necessarily be readable if captured on a system that
113 * defines ETH_P_ values that don't match these values;
115 * if we do translate them in "pcap-linux.c", that makes life
116 * unpleasant for the BPF code generator, as the values you test
117 * for in the kernel aren't the values that you test for when
118 * reading a capture file, so the fixup code run on BPF programs
119 * handed to the kernel ends up having to do more work.
121 * Add other values here as necessary, for handling packet types that
122 * might show up on non-Ethernet, non-802.x networks. (Not all the ones
123 * in the Linux "if_ether.h" will, I suspect, actually show up in
126 #define LINUX_SLL_P_802_3 0x0001 /* Novell 802.3 frames without 802.2 LLC header */
127 #define LINUX_SLL_P_802_2 0x0004 /* 802.2 frames (not D/I/X Ethernet) */
129 static const struct tok sll_pkttype_values
[] = {
130 { LINUX_SLL_HOST
, "In" },
131 { LINUX_SLL_BROADCAST
, "B" },
132 { LINUX_SLL_MULTICAST
, "M" },
133 { LINUX_SLL_OTHERHOST
, "P" },
134 { LINUX_SLL_OUTGOING
, "Out" },
139 sll_print(netdissect_options
*ndo
, register const struct sll_header
*sllp
, u_int length
)
143 ND_PRINT((ndo
, "%3s ",tok2str(sll_pkttype_values
,"?",EXTRACT_16BITS(&sllp
->sll_pkttype
))));
146 * XXX - check the link-layer address type value?
147 * For now, we just assume 6 means Ethernet.
148 * XXX - print others as strings of hex?
150 if (EXTRACT_16BITS(&sllp
->sll_halen
) == 6)
151 ND_PRINT((ndo
, "%s ", etheraddr_string(ndo
, sllp
->sll_addr
)));
153 if (!ndo
->ndo_qflag
) {
154 ether_type
= EXTRACT_16BITS(&sllp
->sll_protocol
);
156 if (ether_type
<= ETHERMTU
) {
158 * Not an Ethernet type; what type is it?
160 switch (ether_type
) {
162 case LINUX_SLL_P_802_3
:
164 * Ethernet_802.3 IPX frame.
166 ND_PRINT((ndo
, "802.3"));
169 case LINUX_SLL_P_802_2
:
173 ND_PRINT((ndo
, "802.2"));
180 ND_PRINT((ndo
, "ethertype Unknown (0x%04x)",
185 ND_PRINT((ndo
, "ethertype %s (0x%04x)",
186 tok2str(ethertype_values
, "Unknown", ether_type
),
189 ND_PRINT((ndo
, ", length %u: ", length
));
194 * This is the top level routine of the printer. 'p' points to the
195 * Linux "cooked capture" header of the packet, 'h->ts' is the timestamp,
196 * 'h->len' is the length of the packet off the wire, and 'h->caplen'
197 * is the number of bytes actually captured.
200 sll_if_print(netdissect_options
*ndo
, const struct pcap_pkthdr
*h
, const u_char
*p
)
202 u_int caplen
= h
->caplen
;
203 u_int length
= h
->len
;
204 register const struct sll_header
*sllp
;
206 u_short extracted_ethertype
;
208 if (caplen
< SLL_HDR_LEN
) {
210 * XXX - this "can't happen" because "pcap-linux.c" always
211 * adds this many bytes of header to every packet in a
212 * cooked socket capture.
214 ND_PRINT((ndo
, "[|sll]"));
218 sllp
= (const struct sll_header
*)p
;
221 sll_print(ndo
, sllp
, length
);
224 * Go past the cooked-mode header.
226 length
-= SLL_HDR_LEN
;
227 caplen
-= SLL_HDR_LEN
;
230 ether_type
= EXTRACT_16BITS(&sllp
->sll_protocol
);
234 * Is it (gag) an 802.3 encapsulation, or some non-Ethernet
237 if (ether_type
<= ETHERMTU
) {
239 * Yes - what type is it?
241 switch (ether_type
) {
243 case LINUX_SLL_P_802_3
:
245 * Ethernet_802.3 IPX frame.
247 ipx_print(ndo
, p
, length
);
250 case LINUX_SLL_P_802_2
:
253 * Try to print the LLC-layer header & higher layers.
255 if (llc_print(ndo
, p
, length
, caplen
, NULL
, NULL
,
256 &extracted_ethertype
) == 0)
257 goto unknown
; /* unknown LLC type */
261 extracted_ethertype
= 0;
265 /* ether_type not known, print raw packet */
267 sll_print(ndo
, sllp
, length
+ SLL_HDR_LEN
);
268 if (extracted_ethertype
) {
269 ND_PRINT((ndo
, "(LLC %s) ",
270 etherproto_string(htons(extracted_ethertype
))));
272 if (!ndo
->ndo_suppress_default_print
)
273 ND_DEFAULTPRINT(p
, caplen
);
276 } else if (ether_type
== ETHERTYPE_8021Q
) {
278 * Print VLAN information, and then go back and process
279 * the enclosed type field.
281 if (caplen
< 4 || length
< 4) {
282 ND_PRINT((ndo
, "[|vlan]"));
283 return (SLL_HDR_LEN
);
285 if (ndo
->ndo_eflag
) {
286 uint16_t tag
= EXTRACT_16BITS(p
);
288 ND_PRINT((ndo
, "%s, ", ieee8021q_tci_string(tag
)));
291 ether_type
= EXTRACT_16BITS(p
+ 2);
292 if (ether_type
<= ETHERMTU
)
293 ether_type
= LINUX_SLL_P_802_2
;
294 if (!ndo
->ndo_qflag
) {
295 ND_PRINT((ndo
, "ethertype %s, ",
296 tok2str(ethertype_values
, "Unknown", ether_type
)));
303 if (ethertype_print(ndo
, ether_type
, p
, length
, caplen
) == 0) {
304 /* ether_type not known, print raw packet */
306 sll_print(ndo
, sllp
, length
+ SLL_HDR_LEN
);
307 if (!ndo
->ndo_suppress_default_print
)
308 ND_DEFAULTPRINT(p
, caplen
);
312 return (SLL_HDR_LEN
);