2 * Copyright (c) 1998-2006 The TCPDUMP project
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that: (1) source code
6 * distributions retain the above copyright notice and this paragraph
7 * in its entirety, and (2) distributions including binary code include
8 * the above copyright notice and this paragraph in its entirety in
9 * the documentation or other materials provided with the distribution.
10 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND
11 * WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
12 * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
13 * FOR A PARTICULAR PURPOSE.
15 * support for the IEEE "slow protocols" LACP, MARKER as per 802.3ad
18 * Original code by Hannes Gredler (hannes@juniper.net)
22 static const char rcsid[] _U_ =
23 "@(#) $Header: /tcpdump/master/tcpdump/print-slow.c,v 1.8 2006-10-12 05:44:33 hannes Exp $";
30 #include <tcpdump-stdinc.h>
36 #include "interface.h"
38 #include "addrtoname.h"
42 struct slow_common_header_t {
43 u_int8_t proto_subtype;
47 #define SLOW_PROTO_LACP 1
48 #define SLOW_PROTO_MARKER 2
49 #define SLOW_PROTO_OAM 3
51 #define LACP_VERSION 1
52 #define MARKER_VERSION 1
54 static const struct tok slow_proto_values[] = {
55 { SLOW_PROTO_LACP, "LACP" },
56 { SLOW_PROTO_MARKER, "MARKER" },
57 { SLOW_PROTO_OAM, "OAM" },
61 static const struct tok slow_oam_flag_values[] = {
62 { 0x0001, "Link Fault" },
63 { 0x0002, "Dying Gasp" },
64 { 0x0004, "Critical Event" },
65 { 0x0008, "Local Evaluating" },
66 { 0x0010, "Local Stable" },
67 { 0x0020, "Remote Evaluating" },
68 { 0x0040, "Remote Stable" },
72 #define SLOW_OAM_CODE_INFO 0x00
73 #define SLOW_OAM_CODE_EVENT_NOTIF 0x01
74 #define SLOW_OAM_CODE_VAR_REQUEST 0x02
75 #define SLOW_OAM_CODE_VAR_RESPONSE 0x03
76 #define SLOW_OAM_CODE_LOOPBACK_CTRL 0x04
77 #define SLOW_OAM_CODE_PRIVATE 0xfe
79 static const struct tok slow_oam_code_values[] = {
80 { SLOW_OAM_CODE_INFO, "Information" },
81 { SLOW_OAM_CODE_EVENT_NOTIF, "Event Notification" },
82 { SLOW_OAM_CODE_VAR_REQUEST, "Variable Request" },
83 { SLOW_OAM_CODE_VAR_RESPONSE, "Variable Response" },
84 { SLOW_OAM_CODE_LOOPBACK_CTRL, "Loopback Control" },
85 { SLOW_OAM_CODE_PRIVATE, "Vendor Private" },
89 struct slow_oam_info_t {
96 u_int8_t oam_pdu_config[2];
98 u_int8_t vendor_private[4];
101 #define SLOW_OAM_INFO_TYPE_END_OF_TLV 0x00
102 #define SLOW_OAM_INFO_TYPE_LOCAL 0x01
103 #define SLOW_OAM_INFO_TYPE_REMOTE 0x02
104 #define SLOW_OAM_INFO_TYPE_ORG_SPECIFIC 0xfe
106 static const struct tok slow_oam_info_type_values[] = {
107 { SLOW_OAM_INFO_TYPE_END_OF_TLV, "End of TLV marker" },
108 { SLOW_OAM_INFO_TYPE_LOCAL, "Local" },
109 { SLOW_OAM_INFO_TYPE_REMOTE, "Remote" },
110 { SLOW_OAM_INFO_TYPE_ORG_SPECIFIC, "Organization specific" },
114 #define OAM_INFO_TYPE_PARSER_MASK 0x3
115 static const struct tok slow_oam_info_type_state_parser_values[] = {
116 { 0x00, "forwarding" },
117 { 0x01, "looping back" },
118 { 0x02, "discarding" },
119 { 0x03, "reserved" },
123 #define OAM_INFO_TYPE_MUX_MASK 0x4
124 static const struct tok slow_oam_info_type_state_mux_values[] = {
125 { 0x00, "forwarding" },
126 { 0x04, "discarding" },
130 static const struct tok slow_oam_info_type_oam_config_values[] = {
132 { 0x02, "Unidirectional" },
133 { 0x04, "Remote-Loopback" },
134 { 0x08, "Link-Events" },
135 { 0x10, "Variable-Retrieval" },
140 #define OAM_INFO_TYPE_PDU_SIZE_MASK 0x7ff
142 #define SLOW_OAM_LINK_EVENT_END_OF_TLV 0x00
143 #define SLOW_OAM_LINK_EVENT_ERR_SYM_PER 0x01
144 #define SLOW_OAM_LINK_EVENT_ERR_FRM 0x02
145 #define SLOW_OAM_LINK_EVENT_ERR_FRM_PER 0x03
146 #define SLOW_OAM_LINK_EVENT_ERR_FRM_SUMM 0x04
147 #define SLOW_OAM_LINK_EVENT_ORG_SPECIFIC 0xfe
149 static const struct tok slow_oam_link_event_values[] = {
150 { SLOW_OAM_LINK_EVENT_END_OF_TLV, "End of TLV marker" },
151 { SLOW_OAM_LINK_EVENT_ERR_SYM_PER, "Errored Symbol Period Event" },
152 { SLOW_OAM_LINK_EVENT_ERR_FRM, "Errored Frame Event" },
153 { SLOW_OAM_LINK_EVENT_ERR_FRM_PER, "Errored Frame Period Event" },
154 { SLOW_OAM_LINK_EVENT_ERR_FRM_SUMM, "Errored Frame Seconds Summary Event" },
155 { SLOW_OAM_LINK_EVENT_ORG_SPECIFIC, "Organization specific" },
159 struct slow_oam_link_event_t {
161 u_int8_t event_length;
162 u_int8_t time_stamp[2];
164 u_int8_t threshold[8];
166 u_int8_t errors_running_total[8];
167 u_int8_t event_running_total[4];
170 struct slow_oam_variablerequest_t {
175 struct slow_oam_variableresponse_t {
181 struct slow_oam_loopbackctrl_t {
185 static const struct tok slow_oam_loopbackctrl_cmd_values[] = {
186 { 0x01, "Enable OAM Remote Loopback" },
187 { 0x02, "Disable OAM Remote Loopback" },
191 struct tlv_header_t {
196 #define LACP_TLV_TERMINATOR 0x00
197 #define LACP_TLV_ACTOR_INFO 0x01
198 #define LACP_TLV_PARTNER_INFO 0x02
199 #define LACP_TLV_COLLECTOR_INFO 0x03
201 #define MARKER_TLV_TERMINATOR 0x00
202 #define MARKER_TLV_MARKER_INFO 0x01
204 static const struct tok slow_tlv_values[] = {
205 { (SLOW_PROTO_LACP << 8) + LACP_TLV_TERMINATOR, "Terminator"},
206 { (SLOW_PROTO_LACP << 8) + LACP_TLV_ACTOR_INFO, "Actor Information"},
207 { (SLOW_PROTO_LACP << 8) + LACP_TLV_PARTNER_INFO, "Partner Information"},
208 { (SLOW_PROTO_LACP << 8) + LACP_TLV_COLLECTOR_INFO, "Collector Information"},
210 { (SLOW_PROTO_MARKER << 8) + MARKER_TLV_TERMINATOR, "Terminator"},
211 { (SLOW_PROTO_MARKER << 8) + MARKER_TLV_MARKER_INFO, "Marker Information"},
215 struct lacp_tlv_actor_partner_info_t {
217 u_int8_t sys[ETHER_ADDR_LEN];
219 u_int8_t port_pri[2];
225 static const struct tok lacp_tlv_actor_partner_info_state_values[] = {
228 { 0x04, "Aggregation"},
229 { 0x08, "Synchronization"},
230 { 0x10, "Collecting"},
231 { 0x20, "Distributing"},
237 struct lacp_tlv_collector_info_t {
238 u_int8_t max_delay[2];
242 struct marker_tlv_marker_info_t {
243 u_int8_t req_port[2];
244 u_int8_t req_sys[ETHER_ADDR_LEN];
245 u_int8_t req_trans_id[4];
249 struct lacp_marker_tlv_terminator_t {
253 void slow_marker_lacp_print(register const u_char *, register u_int);
254 void slow_oam_print(register const u_char *, register u_int);
256 const struct slow_common_header_t *slow_com_header;
259 slow_print(register const u_char *pptr, register u_int len) {
263 slow_com_header = (const struct slow_common_header_t *)pptr;
264 TCHECK(*slow_com_header);
267 * Sanity checking of the header.
269 switch (slow_com_header->proto_subtype) {
270 case SLOW_PROTO_LACP:
271 if (slow_com_header->version != LACP_VERSION) {
272 printf("LACP version %u packet not supported",slow_com_header->version);
278 case SLOW_PROTO_MARKER:
279 if (slow_com_header->version != MARKER_VERSION) {
280 printf("MARKER version %u packet not supported",slow_com_header->version);
286 case SLOW_PROTO_OAM: /* fall through */
291 /* print basic information and exit */
297 printf("%sv%u, length %u",
298 tok2str(slow_proto_values, "unknown (%u)",slow_com_header->proto_subtype),
299 slow_com_header->version,
302 /* some slow protos don't have a version number in the header */
303 printf("%s, length %u",
304 tok2str(slow_proto_values, "unknown (%u)",slow_com_header->proto_subtype),
308 /* unrecognized subtype */
309 if (print_version == -1) {
310 print_unknown_data(pptr, "\n\t", len);
317 switch (slow_com_header->proto_subtype) {
318 default: /* should not happen */
322 /* skip proto_subtype */
323 slow_oam_print(pptr+1, len-1);
326 case SLOW_PROTO_LACP: /* LACP and MARKER share the same semantics */
327 case SLOW_PROTO_MARKER:
328 /* skip slow_common_header */
329 len -= sizeof(const struct slow_common_header_t);
330 pptr += sizeof(const struct slow_common_header_t);
331 slow_marker_lacp_print(pptr, len);
337 printf("\n\t\t packet exceeded snapshot");
340 void slow_marker_lacp_print(register const u_char *tptr, register u_int tlen) {
342 const struct tlv_header_t *tlv_header;
343 const u_char *tlv_tptr;
344 u_int tlv_len, tlv_tlen;
347 const struct lacp_marker_tlv_terminator_t *lacp_marker_tlv_terminator;
348 const struct lacp_tlv_actor_partner_info_t *lacp_tlv_actor_partner_info;
349 const struct lacp_tlv_collector_info_t *lacp_tlv_collector_info;
350 const struct marker_tlv_marker_info_t *marker_tlv_marker_info;
354 /* did we capture enough for fully decoding the tlv header ? */
355 TCHECK2(*tptr, sizeof(struct tlv_header_t));
356 tlv_header = (const struct tlv_header_t *)tptr;
357 tlv_len = tlv_header->length;
359 printf("\n\t%s TLV (0x%02x), length %u",
360 tok2str(slow_tlv_values,
362 (slow_com_header->proto_subtype << 8) + tlv_header->type),
366 if ((tlv_len < sizeof(struct tlv_header_t) ||
368 tlv_header->type != LACP_TLV_TERMINATOR &&
369 tlv_header->type != MARKER_TLV_TERMINATOR) {
370 printf("\n\t-----trailing data-----");
371 print_unknown_data(tptr+sizeof(struct tlv_header_t),"\n\t ",tlen);
375 tlv_tptr=tptr+sizeof(struct tlv_header_t);
376 tlv_tlen=tlv_len-sizeof(struct tlv_header_t);
378 /* did we capture enough for fully decoding the tlv ? */
379 TCHECK2(*tptr, tlv_len);
381 switch((slow_com_header->proto_subtype << 8) + tlv_header->type) {
383 /* those two TLVs have the same structure -> fall through */
384 case ((SLOW_PROTO_LACP << 8) + LACP_TLV_ACTOR_INFO):
385 case ((SLOW_PROTO_LACP << 8) + LACP_TLV_PARTNER_INFO):
386 tlv_ptr.lacp_tlv_actor_partner_info = (const struct lacp_tlv_actor_partner_info_t *)tlv_tptr;
388 printf("\n\t System %s, System Priority %u, Key %u" \
389 ", Port %u, Port Priority %u\n\t State Flags [%s]",
390 etheraddr_string(tlv_ptr.lacp_tlv_actor_partner_info->sys),
391 EXTRACT_16BITS(tlv_ptr.lacp_tlv_actor_partner_info->sys_pri),
392 EXTRACT_16BITS(tlv_ptr.lacp_tlv_actor_partner_info->key),
393 EXTRACT_16BITS(tlv_ptr.lacp_tlv_actor_partner_info->port),
394 EXTRACT_16BITS(tlv_ptr.lacp_tlv_actor_partner_info->port_pri),
395 bittok2str(lacp_tlv_actor_partner_info_state_values,
397 tlv_ptr.lacp_tlv_actor_partner_info->state));
401 case ((SLOW_PROTO_LACP << 8) + LACP_TLV_COLLECTOR_INFO):
402 tlv_ptr.lacp_tlv_collector_info = (const struct lacp_tlv_collector_info_t *)tlv_tptr;
404 printf("\n\t Max Delay %u",
405 EXTRACT_16BITS(tlv_ptr.lacp_tlv_collector_info->max_delay));
409 case ((SLOW_PROTO_MARKER << 8) + MARKER_TLV_MARKER_INFO):
410 tlv_ptr.marker_tlv_marker_info = (const struct marker_tlv_marker_info_t *)tlv_tptr;
412 printf("\n\t Request System %s, Request Port %u, Request Transaction ID 0x%08x",
413 etheraddr_string(tlv_ptr.marker_tlv_marker_info->req_sys),
414 EXTRACT_16BITS(tlv_ptr.marker_tlv_marker_info->req_port),
415 EXTRACT_32BITS(tlv_ptr.marker_tlv_marker_info->req_trans_id));
419 /* those two TLVs have the same structure -> fall through */
420 case ((SLOW_PROTO_LACP << 8) + LACP_TLV_TERMINATOR):
421 case ((SLOW_PROTO_MARKER << 8) + LACP_TLV_TERMINATOR):
422 tlv_ptr.lacp_marker_tlv_terminator = (const struct lacp_marker_tlv_terminator_t *)tlv_tptr;
424 tlv_len = sizeof(tlv_ptr.lacp_marker_tlv_terminator->pad) +
425 sizeof(struct tlv_header_t);
426 /* tell the user that we modified the length field */
428 printf(" (=%u)",tlv_len);
429 /* we have messed around with the length field - now we need to check
430 * again if there are enough bytes on the wire for the hexdump */
431 TCHECK2(tlv_ptr.lacp_marker_tlv_terminator->pad[0],
432 sizeof(tlv_ptr.lacp_marker_tlv_terminator->pad));
439 print_unknown_data(tlv_tptr,"\n\t ",tlv_tlen);
442 /* do we want to see an additional hexdump ? */
444 print_unknown_data(tptr+sizeof(struct tlv_header_t),"\n\t ",
445 tlv_len-sizeof(struct tlv_header_t));
453 printf("\n\t\t packet exceeded snapshot");
456 void slow_oam_print(register const u_char *tptr, register u_int tlen) {
460 struct slow_oam_common_header_t {
465 struct slow_oam_tlv_header_t {
471 const struct slow_oam_common_header_t *slow_oam_common_header;
472 const struct slow_oam_tlv_header_t *slow_oam_tlv_header;
476 const struct slow_oam_info_t *slow_oam_info;
477 const struct slow_oam_link_event_t *slow_oam_link_event;
478 const struct slow_oam_variablerequest_t *slow_oam_variablerequest;
479 const struct slow_oam_variableresponse_t *slow_oam_variableresponse;
480 const struct slow_oam_loopbackctrl_t *slow_oam_loopbackctrl;
483 ptr.slow_oam_common_header = (struct slow_oam_common_header_t *)tptr;
484 tptr += sizeof(struct slow_oam_common_header_t);
485 tlen -= sizeof(struct slow_oam_common_header_t);
487 printf("\n\tCode %s OAM PDU, Flags [%s]",
488 tok2str(slow_oam_code_values, "Unknown (%u)", ptr.slow_oam_common_header->code),
489 bittok2str(slow_oam_flag_values,
491 EXTRACT_16BITS(&ptr.slow_oam_common_header->flags)));
493 switch (ptr.slow_oam_common_header->code) {
494 case SLOW_OAM_CODE_INFO:
496 ptr.slow_oam_tlv_header = (const struct slow_oam_tlv_header_t *)tptr;
497 printf("\n\t %s Information Type (%u), length %u",
498 tok2str(slow_oam_info_type_values, "Reserved",
499 ptr.slow_oam_tlv_header->type),
500 ptr.slow_oam_tlv_header->type,
501 ptr.slow_oam_tlv_header->length);
504 switch (ptr.slow_oam_tlv_header->type) {
505 case SLOW_OAM_INFO_TYPE_END_OF_TLV:
506 if (ptr.slow_oam_tlv_header->length != 0) {
507 printf("\n\t ERROR: illegal length - should be 0");
511 case SLOW_OAM_INFO_TYPE_LOCAL: /* identical format - fall through */
512 case SLOW_OAM_INFO_TYPE_REMOTE:
513 tlv.slow_oam_info = (const struct slow_oam_info_t *)tptr;
515 if (tlv.slow_oam_info->info_length !=
516 sizeof(struct slow_oam_info_t)) {
517 printf("\n\t ERROR: illegal length - should be %lu",
518 (unsigned long) sizeof(struct slow_oam_info_t));
522 printf("\n\t OAM-Version %u, Revision %u",
523 tlv.slow_oam_info->oam_version,
524 EXTRACT_16BITS(&tlv.slow_oam_info->revision));
526 printf("\n\t State-Parser-Action %s, State-MUX-Action %s",
527 tok2str(slow_oam_info_type_state_parser_values, "Reserved",
528 tlv.slow_oam_info->state & OAM_INFO_TYPE_PARSER_MASK),
529 tok2str(slow_oam_info_type_state_mux_values, "Reserved",
530 tlv.slow_oam_info->state & OAM_INFO_TYPE_MUX_MASK));
531 printf("\n\t OAM-Config Flags [%s], OAM-PDU-Config max-PDU size %u",
532 bittok2str(slow_oam_info_type_oam_config_values, "none",
533 tlv.slow_oam_info->oam_config),
534 EXTRACT_16BITS(&tlv.slow_oam_info->oam_pdu_config) &
535 OAM_INFO_TYPE_PDU_SIZE_MASK);
536 printf("\n\t OUI %s (0x%06x), Vendor-Private 0x%08x",
537 tok2str(oui_values, "Unknown",
538 EXTRACT_24BITS(&tlv.slow_oam_info->oui)),
539 EXTRACT_24BITS(&tlv.slow_oam_info->oui),
540 EXTRACT_32BITS(&tlv.slow_oam_info->vendor_private));
543 case SLOW_OAM_INFO_TYPE_ORG_SPECIFIC:
552 /* infinite loop check */
553 if (!ptr.slow_oam_tlv_header->length) {
557 /* do we also want to see a hex dump ? */
558 if (vflag > 1 || hexdump==TRUE) {
559 print_unknown_data(tptr,"\n\t ",
560 ptr.slow_oam_tlv_header->length);
563 tlen -= ptr.slow_oam_tlv_header->length;
564 tptr += ptr.slow_oam_tlv_header->length;
568 case SLOW_OAM_CODE_EVENT_NOTIF:
570 ptr.slow_oam_tlv_header = (const struct slow_oam_tlv_header_t *)tptr;
571 printf("\n\t %s Link Event Type (%u), length %u",
572 tok2str(slow_oam_link_event_values, "Reserved",
573 ptr.slow_oam_tlv_header->type),
574 ptr.slow_oam_tlv_header->type,
575 ptr.slow_oam_tlv_header->length);
578 switch (ptr.slow_oam_tlv_header->type) {
579 case SLOW_OAM_LINK_EVENT_END_OF_TLV:
580 if (ptr.slow_oam_tlv_header->length != 0) {
581 printf("\n\t ERROR: illegal length - should be 0");
585 case SLOW_OAM_LINK_EVENT_ERR_SYM_PER: /* identical format - fall through */
586 case SLOW_OAM_LINK_EVENT_ERR_FRM:
587 case SLOW_OAM_LINK_EVENT_ERR_FRM_PER:
588 case SLOW_OAM_LINK_EVENT_ERR_FRM_SUMM:
589 tlv.slow_oam_link_event = (const struct slow_oam_link_event_t *)tptr;
591 if (tlv.slow_oam_link_event->event_length !=
592 sizeof(struct slow_oam_link_event_t)) {
593 printf("\n\t ERROR: illegal length - should be %lu",
594 (unsigned long) sizeof(struct slow_oam_link_event_t));
598 printf("\n\t Timestamp %u ms, Errored Window %" PRIu64
599 "\n\t Errored Threshold %" PRIu64
600 "\n\t Errors %" PRIu64
601 "\n\t Error Running Total %" PRIu64
602 "\n\t Event Running Total %u",
603 EXTRACT_16BITS(&tlv.slow_oam_link_event->time_stamp)*100,
604 EXTRACT_64BITS(&tlv.slow_oam_link_event->window),
605 EXTRACT_64BITS(&tlv.slow_oam_link_event->threshold),
606 EXTRACT_64BITS(&tlv.slow_oam_link_event->errors),
607 EXTRACT_64BITS(&tlv.slow_oam_link_event->errors_running_total),
608 EXTRACT_32BITS(&tlv.slow_oam_link_event->event_running_total));
611 case SLOW_OAM_LINK_EVENT_ORG_SPECIFIC:
620 /* infinite loop check */
621 if (!ptr.slow_oam_tlv_header->length) {
625 /* do we also want to see a hex dump ? */
626 if (vflag > 1 || hexdump==TRUE) {
627 print_unknown_data(tptr,"\n\t ",
628 ptr.slow_oam_tlv_header->length);
631 tlen -= ptr.slow_oam_tlv_header->length;
632 tptr += ptr.slow_oam_tlv_header->length;
636 case SLOW_OAM_CODE_LOOPBACK_CTRL:
637 tlv.slow_oam_loopbackctrl = (const struct slow_oam_loopbackctrl_t *)tptr;
638 printf("\n\t Command %s (%u)",
639 tok2str(slow_oam_loopbackctrl_cmd_values,
641 tlv.slow_oam_loopbackctrl->command),
642 tlv.slow_oam_loopbackctrl->command);
648 * FIXME those are the defined codes that lack a decoder
649 * you are welcome to contribute code ;-)
651 case SLOW_OAM_CODE_VAR_REQUEST:
652 case SLOW_OAM_CODE_VAR_RESPONSE:
653 case SLOW_OAM_CODE_PRIVATE:
656 print_unknown_data(tptr,"\n\t ", tlen);