2 * Copyright (c) 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.
21 * Code by Gert Doering, SpaceNet GmbH, gert@space.net
23 * Reference documentation:
24 * http://www.cisco.com/univercd/cc/td/doc/product/lan/trsrb/frames.htm
27 /* \summary: Cisco Discovery Protocol (CDP) printer */
33 #include "netdissect-stdinc.h"
37 #include "netdissect.h"
38 #include "addrtoname.h"
43 #define CDP_HEADER_LEN 4
44 #define CDP_HEADER_VERSION_OFFSET 0
45 #define CDP_HEADER_TTL_OFFSET 1
46 #define CDP_HEADER_CHECKSUM_OFFSET 2
48 #define CDP_TLV_HEADER_LEN 4
49 #define CDP_TLV_TYPE_OFFSET 0
50 #define CDP_TLV_LEN_OFFSET 2
52 static const struct tok cdp_tlv_values
[] = {
56 { 0x04, "Capability"},
57 { 0x05, "Version String"},
60 { 0x08, "Protocol-Hello option"},
61 { 0x09, "VTP Management Domain"},
62 { 0x0a, "Native VLAN ID"},
64 { 0x0e, "ATA-186 VoIP VLAN assignment"},
65 { 0x0f, "ATA-186 VoIP VLAN request"},
66 { 0x10, "power consumption"},
68 { 0x12, "AVVID trust bitmap"},
69 { 0x13, "AVVID untrusted ports CoS"},
70 { 0x14, "System Name"},
71 { 0x15, "System Object ID (not decoded)"},
72 { 0x16, "Management Addresses"},
73 { 0x17, "Physical Location"},
77 static const struct tok cdp_capability_values
[] = {
79 { 0x02, "Transparent Bridge" },
80 { 0x04, "Source Route Bridge" },
81 { 0x08, "L2 Switch" },
82 { 0x10, "L3 capable" },
83 { 0x20, "IGMP snooping" },
84 { 0x40, "L1 capable" },
88 static int cdp_print_addr(netdissect_options
*, const u_char
*, u_int
);
89 static int cdp_print_prefixes(netdissect_options
*, const u_char
*, u_int
);
90 static unsigned int cdp_get_number(netdissect_options
*, const u_char
*, u_int
);
93 cdp_print(netdissect_options
*ndo
,
94 const u_char
*pptr
, u_int length
, u_int caplen
)
96 u_int type
, len
, i
, j
;
99 ndo
->ndo_protocol
= "cdp";
100 if (caplen
< CDP_HEADER_LEN
) {
105 tptr
= pptr
; /* temporary pointer */
107 ND_TCHECK_LEN(tptr
, CDP_HEADER_LEN
);
108 ND_PRINT("CDPv%u, ttl: %us", EXTRACT_U_1((tptr
+ CDP_HEADER_VERSION_OFFSET
)),
109 EXTRACT_U_1(tptr
+ CDP_HEADER_TTL_OFFSET
));
111 ND_PRINT(", checksum: 0x%04x (unverified), length %u", EXTRACT_BE_U_2(tptr
+ CDP_HEADER_CHECKSUM_OFFSET
), length
);
112 tptr
+= CDP_HEADER_LEN
;
114 while (tptr
< (pptr
+length
)) {
115 ND_TCHECK_LEN(tptr
, CDP_TLV_HEADER_LEN
); /* read out Type and Length */
116 type
= EXTRACT_BE_U_2(tptr
+ CDP_TLV_TYPE_OFFSET
);
117 len
= EXTRACT_BE_U_2(tptr
+ CDP_TLV_LEN_OFFSET
); /* object length includes the 4 bytes header length */
118 if (len
< CDP_TLV_HEADER_LEN
) {
120 ND_PRINT("\n\t%s (0x%02x), TLV length: %u byte%s (too short)",
121 tok2str(cdp_tlv_values
,"unknown field type", type
),
124 PLURAL_SUFFIX(len
)); /* plural */
126 ND_PRINT(", %s TLV length %u too short",
127 tok2str(cdp_tlv_values
,"unknown field type", type
),
131 tptr
+= CDP_TLV_HEADER_LEN
;
132 len
-= CDP_TLV_HEADER_LEN
;
134 ND_TCHECK_LEN(tptr
, len
);
136 if (ndo
->ndo_vflag
|| type
== 1) { /* in non-verbose mode just print Device-ID */
139 ND_PRINT("\n\t%s (0x%02x), value length: %u byte%s: ",
140 tok2str(cdp_tlv_values
,"unknown field type", type
),
143 PLURAL_SUFFIX(len
)); /* plural */
147 case 0x01: /* Device-ID */
149 ND_PRINT(", Device-ID ");
151 (void)nd_printn(ndo
, tptr
, len
, NULL
);
154 case 0x02: /* Address */
155 if (cdp_print_addr(ndo
, tptr
, len
) < 0)
158 case 0x03: /* Port-ID */
160 (void)nd_printn(ndo
, tptr
, len
, NULL
);
163 case 0x04: /* Capabilities */
166 ND_PRINT("(0x%08x): %s",
167 EXTRACT_BE_U_4(tptr
),
168 bittok2str(cdp_capability_values
, "none", EXTRACT_BE_U_4(tptr
)));
170 case 0x05: /* Version */
172 for (i
=0;i
<len
;i
++) {
173 j
= EXTRACT_U_1(tptr
+ i
);
174 if (j
== '\n') /* lets rework the version string to
175 get a nice indentation */
178 fn_print_char(ndo
, j
);
181 case 0x06: /* Platform */
183 (void)nd_printn(ndo
, tptr
, len
, NULL
);
186 case 0x07: /* Prefixes */
187 if (cdp_print_prefixes(ndo
, tptr
, len
) < 0)
190 case 0x08: /* Protocol Hello Option - not documented */
192 case 0x09: /* VTP Mgmt Domain - CDPv2 */
194 (void)nd_printn(ndo
, tptr
, len
, NULL
);
197 case 0x0a: /* Native VLAN ID - CDPv2 */
200 ND_PRINT("%u", EXTRACT_BE_U_2(tptr
));
202 case 0x0b: /* Duplex - CDPv2 */
205 ND_PRINT("%s", EXTRACT_U_1(tptr
) ? "full": "half");
208 /* http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cata/186/2_12_m/english/release/notes/186rn21m.html
209 * plus more details from other sources
211 * There are apparently versions of the request with both
212 * 2 bytes and 3 bytes of value. The 3 bytes of value
213 * appear to be a 1-byte application type followed by a
214 * 2-byte VLAN ID; the 2 bytes of value are unknown
215 * (they're 0x20 0x00 in some captures I've seen; that
216 * is not a valid VLAN ID, as VLAN IDs are 12 bits).
218 * The replies all appear to be 3 bytes long.
220 case 0x0e: /* ATA-186 VoIP VLAN assignment - incomplete doc. */
223 ND_PRINT("app %u, vlan %u", EXTRACT_U_1(tptr
), EXTRACT_BE_U_2(tptr
+ 1));
225 case 0x0f: /* ATA-186 VoIP VLAN request - incomplete doc. */
229 ND_PRINT("unknown 0x%04x", EXTRACT_BE_U_2(tptr
));
231 ND_PRINT("app %u, vlan %u", EXTRACT_U_1(tptr
), EXTRACT_BE_U_2(tptr
+ 1));
233 case 0x10: /* Power - not documented */
234 ND_PRINT("%1.2fW", cdp_get_number(ndo
, tptr
, len
) / 1000.0);
236 case 0x11: /* MTU - not documented */
239 ND_PRINT("%u bytes", EXTRACT_BE_U_4(tptr
));
241 case 0x12: /* AVVID trust bitmap - not documented */
244 ND_PRINT("0x%02x", EXTRACT_U_1(tptr
));
246 case 0x13: /* AVVID untrusted port CoS - not documented */
249 ND_PRINT("0x%02x", EXTRACT_U_1(tptr
));
251 case 0x14: /* System Name - not documented */
253 (void)nd_printn(ndo
, tptr
, len
, NULL
);
256 case 0x16: /* System Object ID - not documented */
257 if (cdp_print_addr(ndo
, tptr
, len
) < 0)
260 case 0x17: /* Physical Location - not documented */
263 ND_PRINT("0x%02x", EXTRACT_U_1(tptr
));
266 (void)nd_printn(ndo
, tptr
+ 1, len
- 1, NULL
);
270 print_unknown_data(ndo
, tptr
, "\n\t ", len
);
276 if (ndo
->ndo_vflag
< 1)
277 ND_PRINT(", length %u", caplen
);
285 * Protocol type values.
287 * PT_NLPID means that the protocol type field contains an OSI NLPID.
289 * PT_IEEE_802_2 means that the protocol type field contains an IEEE 802.2
290 * LLC header that specifies that the payload is for that protocol.
292 #define PT_NLPID 1 /* OSI NLPID */
293 #define PT_IEEE_802_2 2 /* IEEE 802.2 LLC header */
296 cdp_print_addr(netdissect_options
*ndo
,
297 const u_char
* p
, u_int l
)
299 u_int pt
, pl
, al
, num
;
300 const u_char
*endp
= p
+ l
;
301 static const u_char prot_ipv6
[] = {
302 0xaa, 0xaa, 0x03, 0x00, 0x00, 0x00, 0x86, 0xdd
308 num
= EXTRACT_BE_U_4(p
);
311 while (p
< endp
&& num
!= 0) {
315 pt
= EXTRACT_U_1(p
); /* type of "protocol" field */
316 pl
= EXTRACT_U_1(p
+ 1); /* length of "protocol" field */
320 if (p
+ pl
+ 2 > endp
)
322 al
= EXTRACT_BE_U_2(p
+ pl
); /* address length */
324 if (pt
== PT_NLPID
&& pl
== 1 && EXTRACT_U_1(p
) == NLPID_IP
&&
327 * IPv4: protocol type = NLPID, protocol length = 1
328 * (1-byte NLPID), protocol = 0xcc (NLPID for IPv4),
336 ND_PRINT("IPv4 (%u) %s", num
, ipaddr_string(ndo
, p
));
339 else if (pt
== PT_IEEE_802_2
&& pl
== 8 &&
340 memcmp(p
, prot_ipv6
, 8) == 0 && al
== 16) {
342 * IPv6: protocol type = IEEE 802.2 header,
343 * protocol length = 8 (size of LLC+SNAP header),
344 * protocol = LLC+SNAP header with the IPv6
345 * Ethertype, address length = 16
348 ND_TCHECK_LEN(p
, al
);
352 ND_PRINT("IPv6 (%u) %s", num
, ip6addr_string(ndo
, p
));
357 * Generic case: just print raw data
359 ND_TCHECK_LEN(p
, pl
);
362 ND_PRINT("pt=0x%02x, pl=%u, pb=", EXTRACT_U_1((p
- 2)), pl
);
364 ND_PRINT(" %02x", EXTRACT_U_1(p
));
371 ND_PRINT(", al=%u, a=", al
);
373 ND_TCHECK_LEN(p
, al
);
377 ND_PRINT(" %02x", EXTRACT_U_1(p
));
395 cdp_print_prefixes(netdissect_options
*ndo
,
396 const u_char
* p
, u_int l
)
401 ND_PRINT(" IPv4 Prefixes (%u):", l
/ 5);
404 ND_PRINT(" %u.%u.%u.%u/%u",
405 EXTRACT_U_1(p
), EXTRACT_U_1(p
+ 1), EXTRACT_U_1(p
+ 2),
406 EXTRACT_U_1(p
+ 3), EXTRACT_U_1(p
+ 4));
417 /* read in a <n>-byte number, MSB first
418 * (of course this can handle max sizeof(int))
421 cdp_get_number(netdissect_options
*ndo
, const u_char
* p
, u_int l
)
426 res
= (res
<<8) + EXTRACT_U_1(p
);