contrib/tcpdump/print-slow.c

   1 /*
   2  * Copyright (c) 1998-2006 The TCPDUMP project
   3  *
   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.
  14  *
  15  * support for the IEEE "slow protocols" LACP, MARKER as per 802.3ad
  16  *                                       OAM as per 802.3ah
  17  *
  18  * Original code by Hannes Gredler (hannes@gredler.at)
  19  */
  20
  21 /* \summary: IEEE "slow protocols" (802.3ad/802.3ah) printer */
  22
  23 #ifdef HAVE_CONFIG_H
  24 #include <config.h>
  25 #endif
  26
  27 #include "netdissect-stdinc.h"
  28
  29 #define ND_LONGJMP_FROM_TCHECK
  30 #include "netdissect.h"
  31 #include "extract.h"
  32 #include "addrtoname.h"
  33 #include "oui.h"
  34
  35
  36 #define SLOW_PROTO_LACP                     1
  37 #define SLOW_PROTO_MARKER                   2
  38 #define SLOW_PROTO_OAM                      3
  39
  40 #define LACP_VERSION                        1
  41 #define MARKER_VERSION                      1
  42
  43 static const struct tok slow_proto_values[] = {
  44     { SLOW_PROTO_LACP, "LACP" },
  45     { SLOW_PROTO_MARKER, "MARKER" },
  46     { SLOW_PROTO_OAM, "OAM" },
  47     { 0, NULL}
  48 };
  49
  50 static const struct tok slow_oam_flag_values[] = {
  51     { 0x0001, "Link Fault" },
  52     { 0x0002, "Dying Gasp" },
  53     { 0x0004, "Critical Event" },
  54     { 0x0008, "Local Evaluating" },
  55     { 0x0010, "Local Stable" },
  56     { 0x0020, "Remote Evaluating" },
  57     { 0x0040, "Remote Stable" },
  58     { 0, NULL}
  59 };
  60
  61 #define SLOW_OAM_CODE_INFO          0x00
  62 #define SLOW_OAM_CODE_EVENT_NOTIF   0x01
  63 #define SLOW_OAM_CODE_VAR_REQUEST   0x02
  64 #define SLOW_OAM_CODE_VAR_RESPONSE  0x03
  65 #define SLOW_OAM_CODE_LOOPBACK_CTRL 0x04
  66 #define SLOW_OAM_CODE_PRIVATE       0xfe
  67
  68 static const struct tok slow_oam_code_values[] = {
  69     { SLOW_OAM_CODE_INFO, "Information" },
  70     { SLOW_OAM_CODE_EVENT_NOTIF, "Event Notification" },
  71     { SLOW_OAM_CODE_VAR_REQUEST, "Variable Request" },
  72     { SLOW_OAM_CODE_VAR_RESPONSE, "Variable Response" },
  73     { SLOW_OAM_CODE_LOOPBACK_CTRL, "Loopback Control" },
  74     { SLOW_OAM_CODE_PRIVATE, "Vendor Private" },
  75     { 0, NULL}
  76 };
  77
  78 struct slow_oam_info_t {
  79     nd_uint8_t info_type;
  80     nd_uint8_t info_length;
  81     nd_uint8_t oam_version;
  82     nd_uint16_t revision;
  83     nd_uint8_t state;
  84     nd_uint8_t oam_config;
  85     nd_uint16_t oam_pdu_config;
  86     nd_uint24_t oui;
  87     nd_uint32_t vendor_private;
  88 };
  89
  90 #define SLOW_OAM_INFO_TYPE_END_OF_TLV 0x00
  91 #define SLOW_OAM_INFO_TYPE_LOCAL 0x01
  92 #define SLOW_OAM_INFO_TYPE_REMOTE 0x02
  93 #define SLOW_OAM_INFO_TYPE_ORG_SPECIFIC 0xfe
  94
  95 static const struct tok slow_oam_info_type_values[] = {
  96     { SLOW_OAM_INFO_TYPE_END_OF_TLV, "End of TLV marker" },
  97     { SLOW_OAM_INFO_TYPE_LOCAL, "Local" },
  98     { SLOW_OAM_INFO_TYPE_REMOTE, "Remote" },
  99     { SLOW_OAM_INFO_TYPE_ORG_SPECIFIC, "Organization specific" },
 100     { 0, NULL}
 101 };
 102
 103 #define OAM_INFO_TYPE_PARSER_MASK 0x3
 104 static const struct tok slow_oam_info_type_state_parser_values[] = {
 105     { 0x00, "forwarding" },
 106     { 0x01, "looping back" },
 107     { 0x02, "discarding" },
 108     { 0x03, "reserved" },
 109     { 0, NULL}
 110 };
 111
 112 #define OAM_INFO_TYPE_MUX_MASK 0x4
 113 static const struct tok slow_oam_info_type_state_mux_values[] = {
 114     { 0x00, "forwarding" },
 115     { 0x04, "discarding" },
 116     { 0, NULL}
 117 };
 118
 119 static const struct tok slow_oam_info_type_oam_config_values[] = {
 120     { 0x01, "Active" },
 121     { 0x02, "Unidirectional" },
 122     { 0x04, "Remote-Loopback" },
 123     { 0x08, "Link-Events" },
 124     { 0x10, "Variable-Retrieval" },
 125     { 0, NULL}
 126 };
 127
 128 /* 11 Bits */
 129 #define OAM_INFO_TYPE_PDU_SIZE_MASK 0x7ff
 130
 131 #define SLOW_OAM_LINK_EVENT_END_OF_TLV 0x00
 132 #define SLOW_OAM_LINK_EVENT_ERR_SYM_PER 0x01
 133 #define SLOW_OAM_LINK_EVENT_ERR_FRM 0x02
 134 #define SLOW_OAM_LINK_EVENT_ERR_FRM_PER 0x03
 135 #define SLOW_OAM_LINK_EVENT_ERR_FRM_SUMM 0x04
 136 #define SLOW_OAM_LINK_EVENT_ORG_SPECIFIC 0xfe
 137
 138 static const struct tok slow_oam_link_event_values[] = {
 139     { SLOW_OAM_LINK_EVENT_END_OF_TLV, "End of TLV marker" },
 140     { SLOW_OAM_LINK_EVENT_ERR_SYM_PER, "Errored Symbol Period Event" },
 141     { SLOW_OAM_LINK_EVENT_ERR_FRM, "Errored Frame Event" },
 142     { SLOW_OAM_LINK_EVENT_ERR_FRM_PER, "Errored Frame Period Event" },
 143     { SLOW_OAM_LINK_EVENT_ERR_FRM_SUMM, "Errored Frame Seconds Summary Event" },
 144     { SLOW_OAM_LINK_EVENT_ORG_SPECIFIC, "Organization specific" },
 145     { 0, NULL}
 146 };
 147
 148 struct slow_oam_link_event_t {
 149     nd_uint8_t event_type;
 150     nd_uint8_t event_length;
 151     nd_uint16_t time_stamp;
 152     nd_uint64_t window;
 153     nd_uint64_t threshold;
 154     nd_uint64_t errors;
 155     nd_uint64_t errors_running_total;
 156     nd_uint32_t event_running_total;
 157 };
 158
 159 struct slow_oam_variablerequest_t {
 160     nd_uint8_t branch;
 161     nd_uint16_t leaf;
 162 };
 163
 164 struct slow_oam_variableresponse_t {
 165     nd_uint8_t branch;
 166     nd_uint16_t leaf;
 167     nd_uint8_t length;
 168 };
 169
 170 struct slow_oam_loopbackctrl_t {
 171     nd_uint8_t command;
 172 };
 173
 174 static const struct tok slow_oam_loopbackctrl_cmd_values[] = {
 175     { 0x01, "Enable OAM Remote Loopback" },
 176     { 0x02, "Disable OAM Remote Loopback" },
 177     { 0, NULL}
 178 };
 179
 180 struct tlv_header_t {
 181     nd_uint8_t type;
 182     nd_uint8_t length;
 183 };
 184
 185 #define LACP_MARKER_TLV_TERMINATOR     0x00  /* same code for LACP and Marker */
 186
 187 #define LACP_TLV_ACTOR_INFO            0x01
 188 #define LACP_TLV_PARTNER_INFO          0x02
 189 #define LACP_TLV_COLLECTOR_INFO        0x03
 190
 191 #define MARKER_TLV_MARKER_INFO         0x01
 192
 193 static const struct tok slow_tlv_values[] = {
 194     { (SLOW_PROTO_LACP << 8) + LACP_MARKER_TLV_TERMINATOR, "Terminator"},
 195     { (SLOW_PROTO_LACP << 8) + LACP_TLV_ACTOR_INFO, "Actor Information"},
 196     { (SLOW_PROTO_LACP << 8) + LACP_TLV_PARTNER_INFO, "Partner Information"},
 197     { (SLOW_PROTO_LACP << 8) + LACP_TLV_COLLECTOR_INFO, "Collector Information"},
 198
 199     { (SLOW_PROTO_MARKER << 8) + LACP_MARKER_TLV_TERMINATOR, "Terminator"},
 200     { (SLOW_PROTO_MARKER << 8) + MARKER_TLV_MARKER_INFO, "Marker Information"},
 201     { 0, NULL}
 202 };
 203
 204 struct lacp_tlv_actor_partner_info_t {
 205     nd_uint16_t sys_pri;
 206     nd_mac_addr sys;
 207     nd_uint16_t key;
 208     nd_uint16_t port_pri;
 209     nd_uint16_t port;
 210     nd_uint8_t state;
 211     nd_byte    pad[3];
 212 };
 213
 214 static const struct tok lacp_tlv_actor_partner_info_state_values[] = {
 215     { 0x01, "Activity"},
 216     { 0x02, "Timeout"},
 217     { 0x04, "Aggregation"},
 218     { 0x08, "Synchronization"},
 219     { 0x10, "Collecting"},
 220     { 0x20, "Distributing"},
 221     { 0x40, "Default"},
 222     { 0x80, "Expired"},
 223     { 0, NULL}
 224 };
 225
 226 struct lacp_tlv_collector_info_t {
 227     nd_uint16_t max_delay;
 228     nd_byte     pad[12];
 229 };
 230
 231 struct marker_tlv_marker_info_t {
 232     nd_uint16_t req_port;
 233     nd_mac_addr req_sys;
 234     nd_uint32_t req_trans_id;
 235     nd_byte     pad[2];
 236 };
 237
 238 struct lacp_marker_tlv_terminator_t {
 239     nd_byte     pad[50];
 240 };
 241
 242 static void slow_marker_lacp_print(netdissect_options *, const u_char *, u_int, u_int);
 243 static void slow_oam_print(netdissect_options *, const u_char *, u_int);
 244
 245 void
 246 slow_print(netdissect_options *ndo,
 247            const u_char *pptr, u_int len)
 248 {
 249     int print_version;
 250     u_int subtype;
 251
 252     ndo->ndo_protocol = "slow";
 253     if (len < 1)
 254         goto tooshort;
 255     subtype = GET_U_1(pptr);
 256
 257     /*
 258      * Sanity checking of the header.
 259      */
 260     switch (subtype) {
 261     case SLOW_PROTO_LACP:
 262         if (len < 2)
 263             goto tooshort;
 264         if (GET_U_1(pptr + 1) != LACP_VERSION) {
 265             ND_PRINT("LACP version %u packet not supported",
 266                      GET_U_1(pptr + 1));
 267             return;
 268         }
 269         print_version = 1;
 270         break;
 271
 272     case SLOW_PROTO_MARKER:
 273         if (len < 2)
 274             goto tooshort;
 275         if (GET_U_1(pptr + 1) != MARKER_VERSION) {
 276             ND_PRINT("MARKER version %u packet not supported",
 277                      GET_U_1(pptr + 1));
 278             return;
 279         }
 280         print_version = 1;
 281         break;
 282
 283     case SLOW_PROTO_OAM: /* fall through */
 284         print_version = 0;
 285         break;
 286
 287     default:
 288         /* print basic information and exit */
 289         print_version = -1;
 290         break;
 291     }
 292
 293     if (print_version == 1) {
 294         ND_PRINT("%sv%u, length %u",
 295                tok2str(slow_proto_values, "unknown (%u)", subtype),
 296                GET_U_1((pptr + 1)),
 297                len);
 298     } else {
 299         /* some slow protos don't have a version number in the header */
 300         ND_PRINT("%s, length %u",
 301                tok2str(slow_proto_values, "unknown (%u)", subtype),
 302                len);
 303     }
 304
 305     /* unrecognized subtype */
 306     if (print_version == -1) {
 307         print_unknown_data(ndo, pptr, "\n\t", len);
 308         return;
 309     }
 310
 311     if (!ndo->ndo_vflag)
 312         return;
 313
 314     switch (subtype) {
 315     default: /* should not happen */
 316         break;
 317
 318     case SLOW_PROTO_OAM:
 319         /* skip subtype */
 320         len -= 1;
 321         pptr += 1;
 322         slow_oam_print(ndo, pptr, len);
 323         break;
 324
 325     case SLOW_PROTO_LACP:   /* LACP and MARKER share the same semantics */
 326     case SLOW_PROTO_MARKER:
 327         /* skip subtype and version */
 328         len -= 2;
 329         pptr += 2;
 330         slow_marker_lacp_print(ndo, pptr, len, subtype);
 331         break;
 332     }
 333     return;
 334
 335 tooshort:
 336     if (!ndo->ndo_vflag)
 337         ND_PRINT(" (packet is too short)");
 338     else
 339         ND_PRINT("\n\t\t packet is too short");
 340 }
 341
 342 static void
 343 slow_marker_lacp_print(netdissect_options *ndo,
 344                        const u_char *tptr, u_int tlen,
 345                        u_int proto_subtype)
 346 {
 347     const struct tlv_header_t *tlv_header;
 348     const u_char *tlv_tptr;
 349     u_int tlv_type, tlv_len, tlv_tlen;
 350
 351     union {
 352         const struct lacp_marker_tlv_terminator_t *lacp_marker_tlv_terminator;
 353         const struct lacp_tlv_actor_partner_info_t *lacp_tlv_actor_partner_info;
 354         const struct lacp_tlv_collector_info_t *lacp_tlv_collector_info;
 355         const struct marker_tlv_marker_info_t *marker_tlv_marker_info;
 356     } tlv_ptr;
 357
 358     while(tlen>0) {
 359         /* is the packet big enough to include the tlv header ? */
 360         if (tlen < sizeof(struct tlv_header_t))
 361             goto tooshort;
 362         /* did we capture enough for fully decoding the tlv header ? */
 363         tlv_header = (const struct tlv_header_t *)tptr;
 364         tlv_type = GET_U_1(tlv_header->type);
 365         tlv_len = GET_U_1(tlv_header->length);
 366
 367         ND_PRINT("\n\t%s TLV (0x%02x), length %u",
 368                tok2str(slow_tlv_values,
 369                        "Unknown",
 370                        (proto_subtype << 8) + tlv_type),
 371                tlv_type,
 372                tlv_len);
 373
 374         if (tlv_type == LACP_MARKER_TLV_TERMINATOR) {
 375             /*
 376              * This TLV has a length of zero, and means there are no
 377              * more TLVs to process.
 378              */
 379             return;
 380         }
 381
 382         /* length includes the type and length fields */
 383         if (tlv_len < sizeof(struct tlv_header_t)) {
 384             ND_PRINT("\n\t    ERROR: illegal length - should be >= %zu",
 385                      sizeof(struct tlv_header_t));
 386             return;
 387         }
 388
 389         /* is the packet big enough to include the tlv ? */
 390         if (tlen < tlv_len)
 391             goto tooshort;
 392         /* did we capture enough for fully decoding the tlv ? */
 393         ND_TCHECK_LEN(tptr, tlv_len);
 394
 395         tlv_tptr=tptr+sizeof(struct tlv_header_t);
 396         tlv_tlen=tlv_len-sizeof(struct tlv_header_t);
 397
 398         switch((proto_subtype << 8) + tlv_type) {
 399
 400             /* those two TLVs have the same structure -> fall through */
 401         case ((SLOW_PROTO_LACP << 8) + LACP_TLV_ACTOR_INFO):
 402         case ((SLOW_PROTO_LACP << 8) + LACP_TLV_PARTNER_INFO):
 403             if (tlv_tlen !=
 404                 sizeof(struct lacp_tlv_actor_partner_info_t)) {
 405                 ND_PRINT("\n\t    ERROR: illegal length - should be %zu",
 406                          sizeof(struct tlv_header_t) + sizeof(struct lacp_tlv_actor_partner_info_t));
 407                 goto badlength;
 408             }
 409
 410             tlv_ptr.lacp_tlv_actor_partner_info = (const struct lacp_tlv_actor_partner_info_t *)tlv_tptr;
 411
 412             ND_PRINT("\n\t  System %s, System Priority %u, Key %u"
 413                    ", Port %u, Port Priority %u\n\t  State Flags [%s]",
 414                    GET_ETHERADDR_STRING(tlv_ptr.lacp_tlv_actor_partner_info->sys),
 415                    GET_BE_U_2(tlv_ptr.lacp_tlv_actor_partner_info->sys_pri),
 416                    GET_BE_U_2(tlv_ptr.lacp_tlv_actor_partner_info->key),
 417                    GET_BE_U_2(tlv_ptr.lacp_tlv_actor_partner_info->port),
 418                    GET_BE_U_2(tlv_ptr.lacp_tlv_actor_partner_info->port_pri),
 419                    bittok2str(lacp_tlv_actor_partner_info_state_values,
 420                               "none",
 421                               GET_U_1(tlv_ptr.lacp_tlv_actor_partner_info->state)));
 422
 423             break;
 424
 425         case ((SLOW_PROTO_LACP << 8) + LACP_TLV_COLLECTOR_INFO):
 426             if (tlv_tlen !=
 427                 sizeof(struct lacp_tlv_collector_info_t)) {
 428                 ND_PRINT("\n\t    ERROR: illegal length - should be %zu",
 429                          sizeof(struct tlv_header_t) + sizeof(struct lacp_tlv_collector_info_t));
 430                 goto badlength;
 431             }
 432
 433             tlv_ptr.lacp_tlv_collector_info = (const struct lacp_tlv_collector_info_t *)tlv_tptr;
 434
 435             ND_PRINT("\n\t  Max Delay %u",
 436                    GET_BE_U_2(tlv_ptr.lacp_tlv_collector_info->max_delay));
 437
 438             break;
 439
 440         case ((SLOW_PROTO_MARKER << 8) + MARKER_TLV_MARKER_INFO):
 441             if (tlv_tlen !=
 442                 sizeof(struct marker_tlv_marker_info_t)) {
 443                 ND_PRINT("\n\t    ERROR: illegal length - should be %zu",
 444                          sizeof(struct tlv_header_t) + sizeof(struct marker_tlv_marker_info_t));
 445                 goto badlength;
 446             }
 447
 448             tlv_ptr.marker_tlv_marker_info = (const struct marker_tlv_marker_info_t *)tlv_tptr;
 449
 450             ND_PRINT("\n\t  Request System %s, Request Port %u, Request Transaction ID 0x%08x",
 451                    GET_ETHERADDR_STRING(tlv_ptr.marker_tlv_marker_info->req_sys),
 452                    GET_BE_U_2(tlv_ptr.marker_tlv_marker_info->req_port),
 453                    GET_BE_U_4(tlv_ptr.marker_tlv_marker_info->req_trans_id));
 454
 455             break;
 456
 457         default:
 458             if (ndo->ndo_vflag <= 1)
 459                 print_unknown_data(ndo, tlv_tptr, "\n\t  ", tlv_tlen);
 460             break;
 461         }
 462
 463     badlength:
 464         /* do we want to see an additional hexdump ? */
 465         if (ndo->ndo_vflag > 1) {
 466             print_unknown_data(ndo, tptr+sizeof(struct tlv_header_t), "\n\t  ",
 467                                tlv_len-sizeof(struct tlv_header_t));
 468         }
 469
 470         tptr+=tlv_len;
 471         tlen-=tlv_len;
 472     }
 473     return;
 474
 475 tooshort:
 476     ND_PRINT("\n\t\t packet is too short");
 477 }
 478
 479 static void
 480 slow_oam_print(netdissect_options *ndo,
 481                const u_char *tptr, u_int tlen)
 482 {
 483     uint8_t code;
 484     uint8_t type, length;
 485     uint8_t state;
 486     uint8_t command;
 487     u_int hexdump;
 488
 489     struct slow_oam_common_header_t {
 490         nd_uint16_t flags;
 491         nd_uint8_t code;
 492     };
 493
 494     struct slow_oam_tlv_header_t {
 495         nd_uint8_t type;
 496         nd_uint8_t length;
 497     };
 498
 499     union {
 500         const struct slow_oam_common_header_t *slow_oam_common_header;
 501         const struct slow_oam_tlv_header_t *slow_oam_tlv_header;
 502     } ptr;
 503
 504     union {
 505         const struct slow_oam_info_t *slow_oam_info;
 506         const struct slow_oam_link_event_t *slow_oam_link_event;
 507         const struct slow_oam_variablerequest_t *slow_oam_variablerequest;
 508         const struct slow_oam_variableresponse_t *slow_oam_variableresponse;
 509         const struct slow_oam_loopbackctrl_t *slow_oam_loopbackctrl;
 510     } tlv;
 511
 512     ptr.slow_oam_common_header = (const struct slow_oam_common_header_t *)tptr;
 513     if (tlen < sizeof(*ptr.slow_oam_common_header))
 514         goto tooshort;
 515     ND_TCHECK_SIZE(ptr.slow_oam_common_header);
 516     tptr += sizeof(struct slow_oam_common_header_t);
 517     tlen -= sizeof(struct slow_oam_common_header_t);
 518
 519     code = GET_U_1(ptr.slow_oam_common_header->code);
 520     ND_PRINT("\n\tCode %s OAM PDU, Flags [%s]",
 521            tok2str(slow_oam_code_values, "Unknown (%u)", code),
 522            bittok2str(slow_oam_flag_values,
 523                       "none",
 524                       GET_BE_U_2(ptr.slow_oam_common_header->flags)));
 525
 526     switch (code) {
 527     case SLOW_OAM_CODE_INFO:
 528         while (tlen > 0) {
 529             ptr.slow_oam_tlv_header = (const struct slow_oam_tlv_header_t *)tptr;
 530             if (tlen < sizeof(*ptr.slow_oam_tlv_header))
 531                 goto tooshort;
 532             ND_TCHECK_SIZE(ptr.slow_oam_tlv_header);
 533             type = GET_U_1(ptr.slow_oam_tlv_header->type);
 534             length = GET_U_1(ptr.slow_oam_tlv_header->length);
 535             ND_PRINT("\n\t  %s Information Type (%u), length %u",
 536                    tok2str(slow_oam_info_type_values, "Reserved", type),
 537                    type,
 538                    length);
 539
 540             if (type == SLOW_OAM_INFO_TYPE_END_OF_TLV) {
 541                 /*
 542                  * As IEEE Std 802.3-2015 says for the End of TLV Marker,
 543                  * "(the length and value of the Type 0x00 TLV can be ignored)".
 544                  */
 545                 return;
 546             }
 547
 548             /* length includes the type and length fields */
 549             if (length < sizeof(struct slow_oam_tlv_header_t)) {
 550                 ND_PRINT("\n\t    ERROR: illegal length - should be >= %zu",
 551                          sizeof(struct slow_oam_tlv_header_t));
 552                 return;
 553             }
 554
 555             if (tlen < length)
 556                 goto tooshort;
 557             ND_TCHECK_LEN(tptr, length);
 558
 559             hexdump = FALSE;
 560             switch (type) {
 561             case SLOW_OAM_INFO_TYPE_LOCAL: /* identical format - fall through */
 562             case SLOW_OAM_INFO_TYPE_REMOTE:
 563                 tlv.slow_oam_info = (const struct slow_oam_info_t *)tptr;
 564
 565                 if (GET_U_1(tlv.slow_oam_info->info_length) !=
 566                     sizeof(struct slow_oam_info_t)) {
 567                     ND_PRINT("\n\t    ERROR: illegal length - should be %zu",
 568                            sizeof(struct slow_oam_info_t));
 569                     hexdump = TRUE;
 570                     goto badlength_code_info;
 571                 }
 572
 573                 ND_PRINT("\n\t    OAM-Version %u, Revision %u",
 574                        GET_U_1(tlv.slow_oam_info->oam_version),
 575                        GET_BE_U_2(tlv.slow_oam_info->revision));
 576
 577                 state = GET_U_1(tlv.slow_oam_info->state);
 578                 ND_PRINT("\n\t    State-Parser-Action %s, State-MUX-Action %s",
 579                        tok2str(slow_oam_info_type_state_parser_values, "Reserved",
 580                                state & OAM_INFO_TYPE_PARSER_MASK),
 581                        tok2str(slow_oam_info_type_state_mux_values, "Reserved",
 582                                state & OAM_INFO_TYPE_MUX_MASK));
 583                 ND_PRINT("\n\t    OAM-Config Flags [%s], OAM-PDU-Config max-PDU size %u",
 584                        bittok2str(slow_oam_info_type_oam_config_values, "none",
 585                                   GET_U_1(tlv.slow_oam_info->oam_config)),
 586                        GET_BE_U_2(tlv.slow_oam_info->oam_pdu_config) &
 587                        OAM_INFO_TYPE_PDU_SIZE_MASK);
 588                 ND_PRINT("\n\t    OUI %s (0x%06x), Vendor-Private 0x%08x",
 589                        tok2str(oui_values, "Unknown",
 590                                GET_BE_U_3(tlv.slow_oam_info->oui)),
 591                        GET_BE_U_3(tlv.slow_oam_info->oui),
 592                        GET_BE_U_4(tlv.slow_oam_info->vendor_private));
 593                 break;
 594
 595             case SLOW_OAM_INFO_TYPE_ORG_SPECIFIC:
 596                 hexdump = TRUE;
 597                 break;
 598
 599             default:
 600                 hexdump = TRUE;
 601                 break;
 602             }
 603
 604         badlength_code_info:
 605             /* do we also want to see a hex dump ? */
 606             if (ndo->ndo_vflag > 1 || hexdump==TRUE) {
 607                 print_unknown_data(ndo, tptr, "\n\t  ",
 608                                    length);
 609             }
 610
 611             tlen -= length;
 612             tptr += length;
 613         }
 614         break;
 615
 616     case SLOW_OAM_CODE_EVENT_NOTIF:
 617         /* Sequence number */
 618         if (tlen < 2)
 619             goto tooshort;
 620         ND_PRINT("\n\t  Sequence Number %u", GET_BE_U_2(tptr));
 621         tlen -= 2;
 622         tptr += 2;
 623
 624         /* TLVs */
 625         while (tlen > 0) {
 626             ptr.slow_oam_tlv_header = (const struct slow_oam_tlv_header_t *)tptr;
 627             if (tlen < sizeof(*ptr.slow_oam_tlv_header))
 628                 goto tooshort;
 629             type = GET_U_1(ptr.slow_oam_tlv_header->type);
 630             length = GET_U_1(ptr.slow_oam_tlv_header->length);
 631             ND_PRINT("\n\t  %s Link Event Type (%u), length %u",
 632                    tok2str(slow_oam_link_event_values, "Reserved",
 633                            type),
 634                    type,
 635                    length);
 636
 637             if (type == SLOW_OAM_INFO_TYPE_END_OF_TLV) {
 638                 /*
 639                  * As IEEE Std 802.3-2015 says for the End of TLV Marker,
 640                  * "(the length and value of the Type 0x00 TLV can be ignored)".
 641                  */
 642                 return;
 643             }
 644
 645             /* length includes the type and length fields */
 646             if (length < sizeof(struct slow_oam_tlv_header_t)) {
 647                 ND_PRINT("\n\t    ERROR: illegal length - should be >= %zu",
 648                          sizeof(struct slow_oam_tlv_header_t));
 649                 return;
 650             }
 651
 652             if (tlen < length)
 653                 goto tooshort;
 654             ND_TCHECK_LEN(tptr, length);
 655
 656             hexdump = FALSE;
 657             switch (type) {
 658             case SLOW_OAM_LINK_EVENT_ERR_SYM_PER: /* identical format - fall through */
 659             case SLOW_OAM_LINK_EVENT_ERR_FRM:
 660             case SLOW_OAM_LINK_EVENT_ERR_FRM_PER:
 661             case SLOW_OAM_LINK_EVENT_ERR_FRM_SUMM:
 662                 tlv.slow_oam_link_event = (const struct slow_oam_link_event_t *)tptr;
 663
 664                 if (GET_U_1(tlv.slow_oam_link_event->event_length) !=
 665                     sizeof(struct slow_oam_link_event_t)) {
 666                     ND_PRINT("\n\t    ERROR: illegal length - should be %zu",
 667                              sizeof(struct slow_oam_link_event_t));
 668                     hexdump = TRUE;
 669                     goto badlength_event_notif;
 670                 }
 671
 672                 ND_PRINT("\n\t    Timestamp %u ms, Errored Window %" PRIu64
 673                        "\n\t    Errored Threshold %" PRIu64
 674                        "\n\t    Errors %" PRIu64
 675                        "\n\t    Error Running Total %" PRIu64
 676                        "\n\t    Event Running Total %u",
 677                        GET_BE_U_2(tlv.slow_oam_link_event->time_stamp)*100,
 678                        GET_BE_U_8(tlv.slow_oam_link_event->window),
 679                        GET_BE_U_8(tlv.slow_oam_link_event->threshold),
 680                        GET_BE_U_8(tlv.slow_oam_link_event->errors),
 681                        GET_BE_U_8(tlv.slow_oam_link_event->errors_running_total),
 682                        GET_BE_U_4(tlv.slow_oam_link_event->event_running_total));
 683                 break;
 684
 685             case SLOW_OAM_LINK_EVENT_ORG_SPECIFIC:
 686                 hexdump = TRUE;
 687                 break;
 688
 689             default:
 690                 hexdump = TRUE;
 691                 break;
 692             }
 693
 694         badlength_event_notif:
 695             /* do we also want to see a hex dump ? */
 696             if (ndo->ndo_vflag > 1 || hexdump==TRUE) {
 697                 print_unknown_data(ndo, tptr, "\n\t  ",
 698                                    length);
 699             }
 700
 701             tlen -= length;
 702             tptr += length;
 703         }
 704         break;
 705
 706     case SLOW_OAM_CODE_LOOPBACK_CTRL:
 707         tlv.slow_oam_loopbackctrl = (const struct slow_oam_loopbackctrl_t *)tptr;
 708         if (tlen < sizeof(*tlv.slow_oam_loopbackctrl))
 709             goto tooshort;
 710         command = GET_U_1(tlv.slow_oam_loopbackctrl->command);
 711         ND_PRINT("\n\t  Command %s (%u)",
 712                tok2str(slow_oam_loopbackctrl_cmd_values,
 713                        "Unknown",
 714                        command),
 715                command);
 716         tptr ++;
 717         tlen --;
 718         break;
 719
 720         /*
 721          * FIXME those are the defined codes that lack a decoder
 722          * you are welcome to contribute code ;-)
 723          */
 724     case SLOW_OAM_CODE_VAR_REQUEST:
 725     case SLOW_OAM_CODE_VAR_RESPONSE:
 726     case SLOW_OAM_CODE_PRIVATE:
 727     default:
 728         if (ndo->ndo_vflag <= 1) {
 729             print_unknown_data(ndo, tptr, "\n\t  ", tlen);
 730         }
 731         break;
 732     }
 733     return;
 734
 735 tooshort:
 736     ND_PRINT("\n\t\t packet is too short");
 737 }