2 * Routines for FDDI packet disassembly
4 * Laurent Deniel <deniel@worldnet.fr>
6 * $Id: packet-fddi.c,v 1.52 2001/11/20 21:59:12 guy Exp $
8 * Ethereal - Network traffic analyzer
9 * By Gerald Combs <gerald@ethereal.com>
10 * Copyright 1998 Gerald Combs
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version 2
15 * of the License, or (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
31 #ifdef HAVE_SYS_TYPES_H
32 # include <sys/types.h>
40 #include "packet-fddi.h"
41 #include "packet-llc.h"
44 static int proto_fddi = -1;
45 static int hf_fddi_fc = -1;
46 static int hf_fddi_fc_clf = -1;
47 static int hf_fddi_fc_prio = -1;
48 static int hf_fddi_fc_smt_subtype = -1;
49 static int hf_fddi_fc_mac_subtype = -1;
50 static int hf_fddi_dst = -1;
51 static int hf_fddi_src = -1;
52 static int hf_fddi_addr = -1;
54 static gint ett_fddi = -1;
55 static gint ett_fddi_fc = -1;
57 /* FDDI Frame Control values */
59 #define FDDI_FC_VOID 0x00 /* Void frame */
60 #define FDDI_FC_NRT 0x80 /* Nonrestricted token */
61 #define FDDI_FC_RT 0xc0 /* Restricted token */
62 #define FDDI_FC_MAC 0xc0 /* MAC frame */
63 #define FDDI_FC_SMT 0x40 /* SMT frame */
64 #define FDDI_FC_SMT_INFO 0x41 /* SMT Info */
65 #define FDDI_FC_SMT_NSA 0x4F /* SMT Next station adrs */
66 #define FDDI_FC_SMT_MIN FDDI_FC_SMT_INFO
67 #define FDDI_FC_SMT_MAX FDDI_FC_SMT_NSA
68 #define FDDI_FC_MAC_MIN 0xc1
69 #define FDDI_FC_MAC_BEACON 0xc2 /* MAC Beacon frame */
70 #define FDDI_FC_MAC_CLAIM 0xc3 /* MAC Claim frame */
71 #define FDDI_FC_MAC_MAX 0xcf
72 #define FDDI_FC_LLC_ASYNC 0x50 /* Async. LLC frame */
73 #define FDDI_FC_LLC_ASYNC_MIN FDDI_FC_LLC_ASYNC
74 #define FDDI_FC_LLC_ASYNC_DEF 0x54
75 #define FDDI_FC_LLC_ASYNC_MAX 0x5f
76 #define FDDI_FC_LLC_SYNC 0xd0 /* Sync. LLC frame */
77 #define FDDI_FC_LLC_SYNC_MIN FDDI_FC_LLC_SYNC
78 #define FDDI_FC_LLC_SYNC_MAX 0xd7
79 #define FDDI_FC_IMP_ASYNC 0x60 /* Implementor Async. */
80 #define FDDI_FC_IMP_ASYNC_MIN FDDI_FC_IMP_ASYNC
81 #define FDDI_FC_IMP_ASYNC_MAX 0x6f
82 #define FDDI_FC_IMP_SYNC 0xe0 /* Implementor Synch. */
84 #define FDDI_FC_CLFF 0xF0 /* Class/Length/Format bits */
85 #define FDDI_FC_ZZZZ 0x0F /* Control bits */
88 * Async frame ZZZZ bits:
90 #define FDDI_FC_ASYNC_R 0x08 /* Reserved */
91 #define FDDI_FC_ASYNC_PRI 0x07 /* Priority */
93 #define CLFF_BITS(fc) (((fc) & FDDI_FC_CLFF) >> 4)
94 #define ZZZZ_BITS(fc) ((fc) & FDDI_FC_ZZZZ)
96 static const value_string clf_vals[] = {
97 { CLFF_BITS(FDDI_FC_VOID), "Void" },
98 { CLFF_BITS(FDDI_FC_SMT), "SMT" },
99 { CLFF_BITS(FDDI_FC_LLC_ASYNC), "Async LLC" },
100 { CLFF_BITS(FDDI_FC_IMP_ASYNC), "Implementor Async" },
101 { CLFF_BITS(FDDI_FC_NRT), "Nonrestricted Token" },
102 { CLFF_BITS(FDDI_FC_MAC), "MAC" },
103 { CLFF_BITS(FDDI_FC_LLC_SYNC), "Sync LLC" },
104 { CLFF_BITS(FDDI_FC_IMP_SYNC), "Implementor Sync" },
108 static const value_string smt_subtype_vals[] = {
109 { ZZZZ_BITS(FDDI_FC_SMT_INFO), "Info" },
110 { ZZZZ_BITS(FDDI_FC_SMT_NSA), "Next Station Address" },
114 static const value_string mac_subtype_vals[] = {
115 { ZZZZ_BITS(FDDI_FC_MAC_BEACON), "Beacon" },
116 { ZZZZ_BITS(FDDI_FC_MAC_CLAIM), "Claim" },
120 #define FDDI_HEADER_SIZE 13
122 /* field positions */
125 #define FDDI_P_DHOST 1
126 #define FDDI_P_SHOST 7
128 static dissector_handle_t llc_handle;
131 swap_mac_addr(u_char *swapped_addr, const u_char *orig_addr)
135 for (i = 0; i < 6; i++) {
136 swapped_addr[i] = BIT_SWAP(orig_addr[i]);
142 capture_fddi(const u_char *pd, int len, packet_counts *ld)
146 if (!BYTES_ARE_IN_FRAME(0, len, FDDI_HEADER_SIZE)) {
150 offset = FDDI_HEADER_SIZE;
152 fc = (int) pd[FDDI_P_FC];
156 /* From now, only 802.2 SNAP (Async. LCC frame) is supported */
158 case FDDI_FC_LLC_ASYNC + 0 :
159 case FDDI_FC_LLC_ASYNC + 1 :
160 case FDDI_FC_LLC_ASYNC + 2 :
161 case FDDI_FC_LLC_ASYNC + 3 :
162 case FDDI_FC_LLC_ASYNC + 4 :
163 case FDDI_FC_LLC_ASYNC + 5 :
164 case FDDI_FC_LLC_ASYNC + 6 :
165 case FDDI_FC_LLC_ASYNC + 7 :
166 case FDDI_FC_LLC_ASYNC + 8 :
167 case FDDI_FC_LLC_ASYNC + 9 :
168 case FDDI_FC_LLC_ASYNC + 10 :
169 case FDDI_FC_LLC_ASYNC + 11 :
170 case FDDI_FC_LLC_ASYNC + 12 :
171 case FDDI_FC_LLC_ASYNC + 13 :
172 case FDDI_FC_LLC_ASYNC + 14 :
173 case FDDI_FC_LLC_ASYNC + 15 :
174 capture_llc(pd, offset, len, ld);
185 fddifc_to_str(int fc)
187 static gchar strbuf[128+1];
191 case FDDI_FC_VOID: /* Void frame */
194 case FDDI_FC_NRT: /* Nonrestricted token */
195 return "Nonrestricted token";
197 case FDDI_FC_RT: /* Restricted token */
198 return "Restricted token";
200 case FDDI_FC_SMT_INFO: /* SMT Info */
203 case FDDI_FC_SMT_NSA: /* SMT Next station adrs */
204 return "SMT Next station address";
206 case FDDI_FC_MAC_BEACON: /* MAC Beacon frame */
209 case FDDI_FC_MAC_CLAIM: /* MAC Claim frame */
210 return "MAC claim token";
213 switch (fc & FDDI_FC_CLFF) {
216 sprintf(strbuf, "MAC frame, control %x", fc & FDDI_FC_ZZZZ);
220 sprintf(strbuf, "SMT frame, control %x", fc & FDDI_FC_ZZZZ);
223 case FDDI_FC_LLC_ASYNC:
224 if (fc & FDDI_FC_ASYNC_R)
225 sprintf(strbuf, "Async LLC frame, control %x", fc & FDDI_FC_ZZZZ);
227 sprintf(strbuf, "Async LLC frame, priority %d",
228 fc & FDDI_FC_ASYNC_PRI);
231 case FDDI_FC_LLC_SYNC:
232 if (fc & FDDI_FC_ZZZZ) {
233 sprintf(strbuf, "Sync LLC frame, control %x", fc & FDDI_FC_ZZZZ);
236 return "Sync LLC frame";
238 case FDDI_FC_IMP_ASYNC:
239 sprintf(strbuf, "Implementor async frame, control %x",
243 case FDDI_FC_IMP_SYNC:
244 sprintf(strbuf, "Implementor sync frame, control %x",
250 return "Unknown frame type";
257 dissect_fddi(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree,
261 proto_tree *fh_tree = NULL;
265 static u_char src[6], dst[6];
266 u_char src_swapped[6], dst_swapped[6];
269 if (check_col(pinfo->fd, COL_PROTOCOL))
270 col_set_str(pinfo->fd, COL_PROTOCOL, "FDDI");
272 fc = (int) tvb_get_guint8(tvb, FDDI_P_FC);
273 fc_str = fddifc_to_str(fc);
275 if (check_col(pinfo->fd, COL_INFO))
276 col_add_str(pinfo->fd, COL_INFO, fc_str);
279 ti = proto_tree_add_protocol_format(tree, proto_fddi, tvb, 0, FDDI_HEADER_SIZE,
280 "Fiber Distributed Data Interface, %s", fc_str);
281 fh_tree = proto_item_add_subtree(ti, ett_fddi);
282 ti = proto_tree_add_uint_format(fh_tree, hf_fddi_fc, tvb, FDDI_P_FC, 1, fc,
283 "Frame Control: 0x%02x (%s)", fc, fc_str);
284 fc_tree = proto_item_add_subtree(ti, ett_fddi_fc);
285 proto_tree_add_uint(fc_tree, hf_fddi_fc_clf, tvb, FDDI_P_FC, 1, fc);
286 switch (fc & FDDI_FC_CLFF) {
289 proto_tree_add_uint(fc_tree, hf_fddi_fc_smt_subtype, tvb, FDDI_P_FC, 1, fc);
293 if (fc != FDDI_FC_RT)
294 proto_tree_add_uint(fc_tree, hf_fddi_fc_mac_subtype, tvb, FDDI_P_FC, 1, fc);
297 case FDDI_FC_LLC_ASYNC:
298 if (!(fc & FDDI_FC_ASYNC_R))
299 proto_tree_add_uint(fc_tree, hf_fddi_fc_prio, tvb, FDDI_P_FC, 1, fc);
304 /* Extract the destination address, possibly bit-swapping it. */
306 swap_mac_addr(dst, (u_char *) tvb_get_ptr(tvb, FDDI_P_DHOST, 6));
308 memcpy(dst, (u_char *) tvb_get_ptr(tvb, FDDI_P_DHOST, 6), sizeof dst);
309 swap_mac_addr(dst_swapped, (u_char*) tvb_get_ptr(tvb, FDDI_P_DHOST, 6));
311 /* XXX - copy them to some buffer associated with "pi", rather than
312 just making "dst" static? */
313 SET_ADDRESS(&pinfo->dl_dst, AT_ETHER, 6, &dst[0]);
314 SET_ADDRESS(&pinfo->dst, AT_ETHER, 6, &dst[0]);
317 proto_tree_add_ether(fh_tree, hf_fddi_dst, tvb, FDDI_P_DHOST, 6, dst);
318 proto_tree_add_ether_hidden(fh_tree, hf_fddi_addr, tvb, FDDI_P_DHOST, 6, dst);
320 /* hide some bit-swapped mac address fields in the proto_tree, just in case */
321 proto_tree_add_ether_hidden(fh_tree, hf_fddi_dst, tvb, FDDI_P_DHOST, 6, dst_swapped);
322 proto_tree_add_ether_hidden(fh_tree, hf_fddi_addr, tvb, FDDI_P_DHOST, 6, dst_swapped);
325 /* Extract the source address, possibly bit-swapping it. */
327 swap_mac_addr(src, (u_char *) tvb_get_ptr(tvb, FDDI_P_SHOST, 6));
329 memcpy(src, (u_char *) tvb_get_ptr(tvb, FDDI_P_SHOST, 6), sizeof src);
330 swap_mac_addr(src_swapped, (u_char*) tvb_get_ptr(tvb, FDDI_P_SHOST, 6));
332 /* XXX - copy them to some buffer associated with "pi", rather than
333 just making "src" static? */
334 SET_ADDRESS(&pinfo->dl_src, AT_ETHER, 6, &src[0]);
335 SET_ADDRESS(&pinfo->src, AT_ETHER, 6, &src[0]);
338 proto_tree_add_ether(fh_tree, hf_fddi_src, tvb, FDDI_P_SHOST, 6, src);
339 proto_tree_add_ether_hidden(fh_tree, hf_fddi_addr, tvb, FDDI_P_SHOST, 6, src);
341 /* hide some bit-swapped mac address fields in the proto_tree, just in case */
342 proto_tree_add_ether_hidden(fh_tree, hf_fddi_src, tvb, FDDI_P_SHOST, 6, src_swapped);
343 proto_tree_add_ether_hidden(fh_tree, hf_fddi_addr, tvb, FDDI_P_SHOST, 6, src_swapped);
346 next_tvb = tvb_new_subset(tvb, FDDI_HEADER_SIZE, -1, -1);
350 /* From now, only 802.2 SNAP (Async. LCC frame) is supported */
352 case FDDI_FC_LLC_ASYNC + 0 :
353 case FDDI_FC_LLC_ASYNC + 1 :
354 case FDDI_FC_LLC_ASYNC + 2 :
355 case FDDI_FC_LLC_ASYNC + 3 :
356 case FDDI_FC_LLC_ASYNC + 4 :
357 case FDDI_FC_LLC_ASYNC + 5 :
358 case FDDI_FC_LLC_ASYNC + 6 :
359 case FDDI_FC_LLC_ASYNC + 7 :
360 case FDDI_FC_LLC_ASYNC + 8 :
361 case FDDI_FC_LLC_ASYNC + 9 :
362 case FDDI_FC_LLC_ASYNC + 10 :
363 case FDDI_FC_LLC_ASYNC + 11 :
364 case FDDI_FC_LLC_ASYNC + 12 :
365 case FDDI_FC_LLC_ASYNC + 13 :
366 case FDDI_FC_LLC_ASYNC + 14 :
367 case FDDI_FC_LLC_ASYNC + 15 :
368 call_dissector(llc_handle, next_tvb, pinfo, tree);
372 dissect_data(next_tvb, 0, pinfo, tree);
380 dissect_fddi_bitswapped(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
382 dissect_fddi(tvb, pinfo, tree, TRUE);
386 dissect_fddi_not_bitswapped(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
388 dissect_fddi(tvb, pinfo, tree, FALSE);
392 proto_register_fddi(void)
394 static hf_register_info hf[] = {
397 * XXX - we want this guy to have his own private formatting
398 * routine, using "fc_to_str()"; if "fc_to_str()" returns
399 * NULL, just show the hex value, else show the string.
402 { "Frame Control", "fddi.fc", FT_UINT8, BASE_HEX, NULL, 0x0,
406 { "Class/Length/Format", "fddi.fc.clf", FT_UINT8, BASE_HEX, VALS(clf_vals), FDDI_FC_CLFF,
410 { "Priority", "fddi.fc.prio", FT_UINT8, BASE_DEC, NULL, FDDI_FC_ASYNC_PRI,
413 { &hf_fddi_fc_smt_subtype,
414 { "SMT Subtype", "fddi.fc.smt_subtype", FT_UINT8, BASE_DEC, VALS(smt_subtype_vals), FDDI_FC_ZZZZ,
417 { &hf_fddi_fc_mac_subtype,
418 { "MAC Subtype", "fddi.fc.mac_subtype", FT_UINT8, BASE_DEC, VALS(mac_subtype_vals), FDDI_FC_ZZZZ,
422 { "Destination", "fddi.dst", FT_ETHER, BASE_NONE, NULL, 0x0,
423 "Destination Hardware Address", HFILL }},
426 { "Source", "fddi.src", FT_ETHER, BASE_NONE, NULL, 0x0,
430 { "Source or Destination Address", "fddi.addr", FT_ETHER, BASE_NONE, NULL, 0x0,
431 "Source or Destination Hardware Address", HFILL }},
434 static gint *ett[] = {
439 proto_fddi = proto_register_protocol("Fiber Distributed Data Interface",
441 proto_register_field_array(proto_fddi, hf, array_length(hf));
442 proto_register_subtree_array(ett, array_length(ett));
445 * Called from various dissectors for encapsulated FDDI frames.
446 * We assume the MAC addresses in them aren't bitswapped.
448 register_dissector("fddi", dissect_fddi_not_bitswapped, proto_fddi);
452 proto_reg_handoff_fddi(void)
455 * Get a handle for the LLC dissector.
457 llc_handle = find_dissector("llc");
459 dissector_add("wtap_encap", WTAP_ENCAP_FDDI,
460 dissect_fddi_not_bitswapped, proto_fddi);
461 dissector_add("wtap_encap", WTAP_ENCAP_FDDI_BITSWAPPED,
462 dissect_fddi_bitswapped, proto_fddi);