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.5 2006-05-18 08:23:26 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
;
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 static const struct tok slow_oam_loopbackctrl_cmd_values
[] = {
182 { 0x01, "Enable OAM Remote Loopback" },
183 { 0x02, "Disable OAM Remote Loopback" },
187 struct tlv_header_t
{
192 #define LACP_TLV_TERMINATOR 0x00
193 #define LACP_TLV_ACTOR_INFO 0x01
194 #define LACP_TLV_PARTNER_INFO 0x02
195 #define LACP_TLV_COLLECTOR_INFO 0x03
197 #define MARKER_TLV_TERMINATOR 0x00
198 #define MARKER_TLV_MARKER_INFO 0x01
200 static const struct tok slow_tlv_values
[] = {
201 { (SLOW_PROTO_LACP
<< 8) + LACP_TLV_TERMINATOR
, "Terminator"},
202 { (SLOW_PROTO_LACP
<< 8) + LACP_TLV_ACTOR_INFO
, "Actor Information"},
203 { (SLOW_PROTO_LACP
<< 8) + LACP_TLV_PARTNER_INFO
, "Partner Information"},
204 { (SLOW_PROTO_LACP
<< 8) + LACP_TLV_COLLECTOR_INFO
, "Collector Information"},
206 { (SLOW_PROTO_MARKER
<< 8) + MARKER_TLV_TERMINATOR
, "Terminator"},
207 { (SLOW_PROTO_MARKER
<< 8) + MARKER_TLV_MARKER_INFO
, "Marker Information"},
211 struct lacp_tlv_actor_partner_info_t
{
213 u_int8_t sys
[ETHER_ADDR_LEN
];
215 u_int8_t port_pri
[2];
221 static const struct tok lacp_tlv_actor_partner_info_state_values
[] = {
224 { 0x04, "Aggregation"},
225 { 0x08, "Synchronization"},
226 { 0x10, "Collecting"},
227 { 0x20, "Distributing"},
233 struct lacp_tlv_collector_info_t
{
234 u_int8_t max_delay
[2];
238 struct marker_tlv_marker_info_t
{
239 u_int8_t req_port
[2];
240 u_int8_t req_sys
[ETHER_ADDR_LEN
];
241 u_int8_t req_trans_id
[4];
245 struct lacp_marker_tlv_terminator_t
{
249 void slow_marker_lacp_print(register const u_char
*, register u_int
);
250 void slow_oam_print(register const u_char
*, register u_int
);
252 const struct slow_common_header_t
*slow_com_header
;
255 slow_print(register const u_char
*pptr
, register u_int len
) {
259 slow_com_header
= (const struct slow_common_header_t
*)pptr
;
260 TCHECK(*slow_com_header
);
263 * Sanity checking of the header.
265 switch (slow_com_header
->proto_subtype
) {
266 case SLOW_PROTO_LACP
:
267 if (slow_com_header
->version
!= LACP_VERSION
) {
268 printf("LACP version %u packet not supported",slow_com_header
->version
);
274 case SLOW_PROTO_MARKER
:
275 if (slow_com_header
->version
!= MARKER_VERSION
) {
276 printf("MARKER version %u packet not supported",slow_com_header
->version
);
282 case SLOW_PROTO_OAM
: /* fall through */
287 /* print basic information and exit */
293 printf("%sv%u, length %u",
294 tok2str(slow_proto_values
, "unknown (%u)",slow_com_header
->proto_subtype
),
295 slow_com_header
->version
,
298 /* some slow protos don't have a version number in the header */
299 printf("%s, length %u",
300 tok2str(slow_proto_values
, "unknown (%u)",slow_com_header
->proto_subtype
),
304 /* unrecognized subtype */
305 if (print_version
== -1) {
306 print_unknown_data(pptr
, "\n\t", len
);
313 switch (slow_com_header
->proto_subtype
) {
314 default: /* should not happen */
318 /* skip proto_subtype */
319 slow_oam_print(pptr
+1, len
-1);
322 case SLOW_PROTO_LACP
: /* LACP and MARKER share the same semantics */
323 case SLOW_PROTO_MARKER
:
324 /* skip slow_common_header */
325 len
-= sizeof(const struct slow_common_header_t
);
326 pptr
+= sizeof(const struct slow_common_header_t
);
327 slow_marker_lacp_print(pptr
, len
);
333 printf("\n\t\t packet exceeded snapshot");
336 void slow_marker_lacp_print(register const u_char
*tptr
, register u_int tlen
) {
338 const struct tlv_header_t
*tlv_header
;
339 const u_char
*tlv_tptr
;
340 u_int tlv_len
, tlv_tlen
;
343 const struct lacp_marker_tlv_terminator_t
*lacp_marker_tlv_terminator
;
344 const struct lacp_tlv_actor_partner_info_t
*lacp_tlv_actor_partner_info
;
345 const struct lacp_tlv_collector_info_t
*lacp_tlv_collector_info
;
346 const struct marker_tlv_marker_info_t
*marker_tlv_marker_info
;
350 /* did we capture enough for fully decoding the tlv header ? */
351 TCHECK2(*tptr
, sizeof(struct tlv_header_t
));
352 tlv_header
= (const struct tlv_header_t
*)tptr
;
353 tlv_len
= tlv_header
->length
;
355 printf("\n\t%s TLV (0x%02x), length %u",
356 tok2str(slow_tlv_values
,
358 (slow_com_header
->proto_subtype
<< 8) + tlv_header
->type
),
362 if ((tlv_len
< sizeof(struct tlv_header_t
) ||
364 tlv_header
->type
!= LACP_TLV_TERMINATOR
&&
365 tlv_header
->type
!= MARKER_TLV_TERMINATOR
) {
366 printf("\n\t-----trailing data-----");
367 print_unknown_data(tptr
+sizeof(sizeof(struct tlv_header_t
)),"\n\t ",tlen
);
371 tlv_tptr
=tptr
+sizeof(struct tlv_header_t
);
372 tlv_tlen
=tlv_len
-sizeof(struct tlv_header_t
);
374 /* did we capture enough for fully decoding the tlv ? */
375 TCHECK2(*tptr
, tlv_len
);
377 switch((slow_com_header
->proto_subtype
<< 8) + tlv_header
->type
) {
379 /* those two TLVs have the same structure -> fall through */
380 case ((SLOW_PROTO_LACP
<< 8) + LACP_TLV_ACTOR_INFO
):
381 case ((SLOW_PROTO_LACP
<< 8) + LACP_TLV_PARTNER_INFO
):
382 tlv_ptr
.lacp_tlv_actor_partner_info
= (const struct lacp_tlv_actor_partner_info_t
*)tlv_tptr
;
384 printf("\n\t System %s, System Priority %u, Key %u" \
385 ", Port %u, Port Priority %u\n\t State Flags [%s]",
386 etheraddr_string(tlv_ptr
.lacp_tlv_actor_partner_info
->sys
),
387 EXTRACT_16BITS(tlv_ptr
.lacp_tlv_actor_partner_info
->sys_pri
),
388 EXTRACT_16BITS(tlv_ptr
.lacp_tlv_actor_partner_info
->key
),
389 EXTRACT_16BITS(tlv_ptr
.lacp_tlv_actor_partner_info
->port
),
390 EXTRACT_16BITS(tlv_ptr
.lacp_tlv_actor_partner_info
->port_pri
),
391 bittok2str(lacp_tlv_actor_partner_info_state_values
,
393 tlv_ptr
.lacp_tlv_actor_partner_info
->state
));
397 case ((SLOW_PROTO_LACP
<< 8) + LACP_TLV_COLLECTOR_INFO
):
398 tlv_ptr
.lacp_tlv_collector_info
= (const struct lacp_tlv_collector_info_t
*)tlv_tptr
;
400 printf("\n\t Max Delay %u",
401 EXTRACT_16BITS(tlv_ptr
.lacp_tlv_collector_info
->max_delay
));
405 case ((SLOW_PROTO_MARKER
<< 8) + MARKER_TLV_MARKER_INFO
):
406 tlv_ptr
.marker_tlv_marker_info
= (const struct marker_tlv_marker_info_t
*)tlv_tptr
;
408 printf("\n\t Request System %s, Request Port %u, Request Transaction ID 0x%08x",
409 etheraddr_string(tlv_ptr
.marker_tlv_marker_info
->req_sys
),
410 EXTRACT_16BITS(tlv_ptr
.marker_tlv_marker_info
->req_port
),
411 EXTRACT_32BITS(tlv_ptr
.marker_tlv_marker_info
->req_trans_id
));
415 /* those two TLVs have the same structure -> fall through */
416 case ((SLOW_PROTO_LACP
<< 8) + LACP_TLV_TERMINATOR
):
417 case ((SLOW_PROTO_MARKER
<< 8) + LACP_TLV_TERMINATOR
):
418 tlv_ptr
.lacp_marker_tlv_terminator
= (const struct lacp_marker_tlv_terminator_t
*)tlv_tptr
;
420 tlv_len
= sizeof(tlv_ptr
.lacp_marker_tlv_terminator
->pad
) +
421 sizeof(struct tlv_header_t
);
422 /* tell the user that we modified the length field */
424 printf(" (=%u)",tlv_len
);
425 /* we have messed around with the length field - now we need to check
426 * again if there are enough bytes on the wire for the hexdump */
427 TCHECK2(tlv_ptr
.lacp_marker_tlv_terminator
->pad
[0],
428 sizeof(tlv_ptr
.lacp_marker_tlv_terminator
->pad
));
435 print_unknown_data(tlv_tptr
,"\n\t ",tlv_tlen
);
438 /* do we want to see an additional hexdump ? */
440 print_unknown_data(tptr
+sizeof(sizeof(struct tlv_header_t
)),"\n\t ",
441 tlv_len
-sizeof(struct tlv_header_t
));
449 printf("\n\t\t packet exceeded snapshot");
452 void slow_oam_print(register const u_char
*tptr
, register u_int tlen
) {
456 struct slow_oam_common_header_t
{
461 struct slow_oam_tlv_header_t
{
467 const struct slow_oam_common_header_t
*slow_oam_common_header
;
468 const struct slow_oam_tlv_header_t
*slow_oam_tlv_header
;
472 const struct slow_oam_info_t
*slow_oam_info
;
473 const struct slow_oam_link_event_t
*slow_oam_link_event
;
474 const struct slow_oam_variablerequest_t
*slow_oam_variablerequest
;
475 const struct slow_oam_variableresponse_t
*slow_oam_variableresponse
;
478 ptr
.slow_oam_common_header
= (struct slow_oam_common_header_t
*)tptr
;
479 tptr
+= sizeof(struct slow_oam_common_header_t
);
480 tlen
-= sizeof(struct slow_oam_common_header_t
);
482 printf("\n\tCode %s OAM PDU, Flags [%s]",
483 tok2str(slow_oam_code_values
, "Unknown (%u)", ptr
.slow_oam_common_header
->code
),
484 bittok2str(slow_oam_flag_values
,
486 EXTRACT_16BITS(&ptr
.slow_oam_common_header
->flags
)));
488 switch (ptr
.slow_oam_common_header
->code
) {
489 case SLOW_OAM_CODE_INFO
:
491 ptr
.slow_oam_tlv_header
= (const struct slow_oam_tlv_header_t
*)tptr
;
492 printf("\n\t %s Information Type (%u), length %u",
493 tok2str(slow_oam_info_type_values
, "Reserved",
494 ptr
.slow_oam_tlv_header
->type
),
495 ptr
.slow_oam_tlv_header
->type
,
496 ptr
.slow_oam_tlv_header
->length
);
499 switch (ptr
.slow_oam_tlv_header
->type
) {
500 case SLOW_OAM_INFO_TYPE_END_OF_TLV
:
501 if (ptr
.slow_oam_tlv_header
->length
!= 0) {
502 printf("\n\t ERROR: illegal length - should be 0");
506 case SLOW_OAM_INFO_TYPE_LOCAL
: /* identical format - fall through */
507 case SLOW_OAM_INFO_TYPE_REMOTE
:
508 tlv
.slow_oam_info
= (const struct slow_oam_info_t
*)tptr
;
510 if (tlv
.slow_oam_info
->info_length
!=
511 sizeof(struct slow_oam_info_t
)) {
512 printf("\n\t ERROR: illegal length - should be %u",
513 sizeof(struct slow_oam_info_t
));
517 printf("\n\t OAM-Version %u, Revision %u",
518 tlv
.slow_oam_info
->oam_version
,
519 EXTRACT_16BITS(&tlv
.slow_oam_info
->revision
));
521 printf("\n\t State-MUX-Action %s, State-Parser-Action %s",
522 tok2str(slow_oam_info_type_state_parser_values
, "Reserved",
523 tlv
.slow_oam_info
->state
& OAM_INFO_TYPE_PARSER_MASK
),
524 tok2str(slow_oam_info_type_state_mux_values
, "Reserved",
525 tlv
.slow_oam_info
->state
& OAM_INFO_TYPE_MUX_MASK
));
526 printf("\n\t OAM-Config Flags [%s], OAM-PDU-Config max-PDU size %u",
527 bittok2str(slow_oam_info_type_oam_config_values
, "none",
528 tlv
.slow_oam_info
->oam_config
),
529 EXTRACT_16BITS(&tlv
.slow_oam_info
->oam_pdu_config
) &
530 OAM_INFO_TYPE_PDU_SIZE_MASK
);
531 printf("\n\t OUI %s (0x%06x), Vendor-Private 0x%08x",
532 tok2str(oui_values
, "Unknown",
533 EXTRACT_24BITS(&tlv
.slow_oam_info
->oui
)),
534 EXTRACT_24BITS(&tlv
.slow_oam_info
->oui
),
535 EXTRACT_32BITS(&tlv
.slow_oam_info
->vendor_private
));
538 case SLOW_OAM_INFO_TYPE_ORG_SPECIFIC
:
547 /* infinite loop check */
548 if (!ptr
.slow_oam_tlv_header
->length
) {
552 /* do we also want to see a hex dump ? */
553 if (vflag
> 1 || hexdump
==TRUE
) {
554 print_unknown_data(tptr
,"\n\t ",
555 ptr
.slow_oam_tlv_header
->length
);
558 tlen
-= ptr
.slow_oam_tlv_header
->length
;
559 tptr
+= ptr
.slow_oam_tlv_header
->length
;
563 case SLOW_OAM_CODE_EVENT_NOTIF
:
565 ptr
.slow_oam_tlv_header
= (const struct slow_oam_tlv_header_t
*)tptr
;
566 printf("\n\t %s Link Event Type (%u), length %u",
567 tok2str(slow_oam_link_event_values
, "Reserved",
568 ptr
.slow_oam_tlv_header
->type
),
569 ptr
.slow_oam_tlv_header
->type
,
570 ptr
.slow_oam_tlv_header
->length
);
573 switch (ptr
.slow_oam_tlv_header
->type
) {
574 case SLOW_OAM_LINK_EVENT_END_OF_TLV
:
575 if (ptr
.slow_oam_tlv_header
->length
!= 0) {
576 printf("\n\t ERROR: illegal length - should be 0");
580 case SLOW_OAM_LINK_EVENT_ERR_SYM_PER
: /* identical format - fall through */
581 case SLOW_OAM_LINK_EVENT_ERR_FRM
:
582 case SLOW_OAM_LINK_EVENT_ERR_FRM_PER
:
583 case SLOW_OAM_LINK_EVENT_ERR_FRM_SUMM
:
584 tlv
.slow_oam_link_event
= (const struct slow_oam_link_event_t
*)tptr
;
586 if (tlv
.slow_oam_link_event
->event_length
!=
587 sizeof(struct slow_oam_link_event_t
)) {
588 printf("\n\t ERROR: illegal length - should be %u",
589 sizeof(struct slow_oam_link_event_t
));
593 printf("\n\t Timestamp %u ms, Errored Window %" PRIu64
594 "\n\t Errored Threshold %" PRIu64
595 "\n\t Errors %" PRIu64
596 "\n\t Error Running Total %" PRIu64
597 "\n\t Event Running Total %u",
598 EXTRACT_16BITS(&tlv
.slow_oam_link_event
->time_stamp
)*100,
599 EXTRACT_64BITS(&tlv
.slow_oam_link_event
->window
),
600 EXTRACT_64BITS(&tlv
.slow_oam_link_event
->threshold
),
601 EXTRACT_64BITS(&tlv
.slow_oam_link_event
->errors
),
602 EXTRACT_64BITS(&tlv
.slow_oam_link_event
->errors_running_total
),
603 EXTRACT_32BITS(&tlv
.slow_oam_link_event
->event_running_total
));
606 case SLOW_OAM_LINK_EVENT_ORG_SPECIFIC
:
615 /* infinite loop check */
616 if (!ptr
.slow_oam_tlv_header
->length
) {
620 /* do we also want to see a hex dump ? */
621 if (vflag
> 1 || hexdump
==TRUE
) {
622 print_unknown_data(tptr
,"\n\t ",
623 ptr
.slow_oam_tlv_header
->length
);
626 tlen
-= ptr
.slow_oam_tlv_header
->length
;
627 tptr
+= ptr
.slow_oam_tlv_header
->length
;
632 * FIXME those are the defined codes that lack a decoder
633 * you are welcome to contribute code ;-)
635 case SLOW_OAM_CODE_VAR_REQUEST
:
636 case SLOW_OAM_CODE_VAR_RESPONSE
:
637 case SLOW_OAM_CODE_LOOPBACK_CTRL
:
638 case SLOW_OAM_CODE_PRIVATE
:
641 print_unknown_data(tptr
,"\n\t ", tlen
);