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 Connectivity Fault Management Protocols as per 802.1ag.
17 * Original code by Hannes Gredler (hannes@juniper.net)
21 static const char rcsid
[] _U_
=
22 "@(#) $Header: /tcpdump/master/tcpdump/print-cfm.c,v 1.3 2006-10-29 23:10:07 hannes Exp $";
29 #include <tcpdump-stdinc.h>
35 #include "interface.h"
38 #include "addrtoname.h"
45 const char * cfm_egress_id_string(register const u_char
*);
46 int cfm_mgmt_addr_print(register const u_char
*);
48 struct cfm_common_header_t
{
49 u_int8_t mdlevel_version
;
52 u_int8_t first_tlv_offset
;
56 #define CFM_EXTRACT_VERSION(x) (((x)&0x1f))
57 #define CFM_EXTRACT_MD_LEVEL(x) (((x)&0xe0)>>5)
59 #define CFM_OPCODE_CCM 1
60 #define CFM_OPCODE_LBR 2
61 #define CFM_OPCODE_LBM 3
62 #define CFM_OPCODE_LTR 4
63 #define CFM_OPCODE_LTM 5
65 static const struct tok cfm_opcode_values
[] = {
66 { CFM_OPCODE_CCM
, "Continouity Check Message"},
67 { CFM_OPCODE_LBR
, "Loopback Reply"},
68 { CFM_OPCODE_LBM
, "Loopback Message"},
69 { CFM_OPCODE_LTR
, "Linktrace Reply"},
70 { CFM_OPCODE_LTM
, "Linktrace Message"},
80 u_int8_t md_nameformat
;
81 u_int8_t md_namelength
;
82 u_int8_t md_name
[46]; /* md name and short ma name */
83 u_int8_t reserved_itu
[16];
88 * Timer Bases for the CCM Interval field.
89 * Expressed in units of seconds.
91 const float ccm_interval_base
[8] = {0, 0.003333, 0.01, 0.1, 1, 10, 60, 600};
92 #define CCM_INTERVAL_MIN_MULTIPLIER 3.25
93 #define CCM_INTERVAL_MAX_MULTIPLIER 3.5
95 #define CFM_CCM_RDI_FLAG 0x80
96 #define CFM_EXTRACT_CCM_INTERVAL(x) (((x)&0x07))
98 #define CFM_CCM_MD_FORMAT_8021 0
99 #define CFM_CCM_MD_FORMAT_NONE 1
100 #define CFM_CCM_MD_FORMAT_DNS 2
101 #define CFM_CCM_MD_FORMAT_MAC 3
102 #define CFM_CCM_MD_FORMAT_CHAR 4
104 static const struct tok cfm_md_nameformat_values
[] = {
105 { CFM_CCM_MD_FORMAT_8021
, "IEEE 802.1"},
106 { CFM_CCM_MD_FORMAT_NONE
, "No MD Name present"},
107 { CFM_CCM_MD_FORMAT_DNS
, "DNS string"},
108 { CFM_CCM_MD_FORMAT_MAC
, "MAC + 16Bit Integer"},
109 { CFM_CCM_MD_FORMAT_CHAR
, "Character string"},
113 #define CFM_CCM_MA_FORMAT_8021 0
114 #define CFM_CCM_MA_FORMAT_VID 1
115 #define CFM_CCM_MA_FORMAT_CHAR 2
116 #define CFM_CCM_MA_FORMAT_INT 3
117 #define CFM_CCM_MA_FORMAT_VPN 4
119 static const struct tok cfm_ma_nameformat_values
[] = {
120 { CFM_CCM_MA_FORMAT_8021
, "IEEE 802.1"},
121 { CFM_CCM_MA_FORMAT_VID
, "Primary VID"},
122 { CFM_CCM_MA_FORMAT_CHAR
, "Character string"},
123 { CFM_CCM_MA_FORMAT_INT
, "16Bit Integer"},
124 { CFM_CCM_MA_FORMAT_VPN
, "RFC2685 VPN-ID"},
129 u_int8_t transaction_id
[4];
130 u_int8_t reserved
[4];
134 u_int8_t transaction_id
[4];
135 u_int8_t egress_id
[8];
137 u_int8_t original_mac
[ETHER_ADDR_LEN
];
138 u_int8_t target_mac
[ETHER_ADDR_LEN
];
139 u_int8_t reserved
[3];
142 static const struct tok cfm_ltm_flag_values
[] = {
143 { 0x80, "Use Forwarding-DB only"},
148 u_int8_t transaction_id
[4];
149 u_int8_t last_egress_id
[8];
150 u_int8_t next_egress_id
[8];
152 u_int8_t replay_action
;
153 u_int8_t reserved
[6];
156 static const struct tok cfm_ltr_flag_values
[] = {
157 { 0x80, "Forwarded"},
158 { 0x40, "Terminal MEP"},
162 static const struct tok cfm_ltr_replay_action_values
[] = {
164 { 2, "Filtering DB"},
170 #define CFM_TLV_END 0
171 #define CFM_TLV_SENDER_ID 1
172 #define CFM_TLV_PORT_STATUS 2
173 #define CFM_TLV_INTERFACE_STATUS 3
174 #define CFM_TLV_DATA 4
175 #define CFM_TLV_REPLY_INGRESS 5
176 #define CFM_TLV_REPLY_EGRESS 6
177 #define CFM_TLV_PRIVATE 31
179 static const struct tok cfm_tlv_values
[] = {
180 { CFM_TLV_END
, "End"},
181 { CFM_TLV_SENDER_ID
, "Sender ID"},
182 { CFM_TLV_PORT_STATUS
, "Port status"},
183 { CFM_TLV_INTERFACE_STATUS
, "Interface status"},
184 { CFM_TLV_DATA
, "Data"},
185 { CFM_TLV_REPLY_INGRESS
, "Reply Ingress"},
186 { CFM_TLV_REPLY_EGRESS
, "Reply Egress"},
187 { CFM_TLV_PRIVATE
, "Organization Specific"},
195 struct cfm_tlv_header_t
{
200 /* FIXME define TLV formats */
202 static const struct tok cfm_tlv_port_status_values
[] = {
208 static const struct tok cfm_tlv_interface_status_values
[] = {
214 { 7, "lower Layer down"},
218 #define CFM_CHASSIS_ID_CHASSIS_COMPONENT 1
219 #define CFM_CHASSIS_ID_INTERFACE_ALIAS 2
220 #define CFM_CHASSIS_ID_PORT_COMPONENT 3
221 #define CFM_CHASSIS_ID_MAC_ADDRESS 4
222 #define CFM_CHASSIS_ID_NETWORK_ADDRESS 5
223 #define CFM_CHASSIS_ID_INTERFACE_NAME 6
224 #define CFM_CHASSIS_ID_LOCAL 7
226 static const struct tok cfm_tlv_senderid_chassisid_values
[] = {
228 { CFM_CHASSIS_ID_CHASSIS_COMPONENT
, "Chassis component"},
229 { CFM_CHASSIS_ID_INTERFACE_ALIAS
, "Interface alias"},
230 { CFM_CHASSIS_ID_PORT_COMPONENT
, "Port component"},
231 { CFM_CHASSIS_ID_MAC_ADDRESS
, "MAC address"},
232 { CFM_CHASSIS_ID_NETWORK_ADDRESS
, "Network address"},
233 { CFM_CHASSIS_ID_INTERFACE_NAME
, "Interface name"},
234 { CFM_CHASSIS_ID_LOCAL
, "Locally assigned"},
240 cfm_mgmt_addr_print(register const u_char
*tptr
) {
242 u_int mgmt_addr_type
;
243 u_int hexdump
= FALSE
;
246 * Altough AFIs are tpically 2 octects wide,
247 * 802.1ab specifies that this field width
250 mgmt_addr_type
= *tptr
;
251 printf("\n\t Management Address Type %s (%u)",
252 tok2str(af_values
, "Unknown", mgmt_addr_type
),
256 * Resolve the passed in Address.
258 switch(mgmt_addr_type
) {
260 printf(", %s", ipaddr_string(tptr
+ 1));
264 printf(", %s", ip6addr_string(tptr
+ 1));
276 * The egress-ID string is a 16-Bit string plus a MAC address.
279 cfm_egress_id_string(register const u_char
*tptr
) {
280 static char egress_id_buffer
[80];
282 snprintf(egress_id_buffer
, sizeof(egress_id_buffer
),
284 EXTRACT_16BITS(tptr
),
285 etheraddr_string(tptr
+2));
287 return egress_id_buffer
;
291 cfm_print(register const u_char
*pptr
, register u_int length
) {
293 const struct cfm_common_header_t
*cfm_common_header
;
294 const struct cfm_tlv_header_t
*cfm_tlv_header
;
295 const u_int8_t
*tptr
, *tlv_ptr
, *ma_name
, *ma_nameformat
, *ma_namelength
;
296 u_int hexdump
, tlen
, cfm_tlv_len
, cfm_tlv_type
, ccm_interval
;
300 const struct cfm_ccm_t
*cfm_ccm
;
301 const struct cfm_lbm_t
*cfm_lbm
;
302 const struct cfm_ltm_t
*cfm_ltm
;
303 const struct cfm_ltr_t
*cfm_ltr
;
307 cfm_common_header
= (const struct cfm_common_header_t
*)pptr
;
308 TCHECK(*cfm_common_header
);
311 * Sanity checking of the header.
313 if (CFM_EXTRACT_VERSION(cfm_common_header
->mdlevel_version
) != CFM_VERSION
) {
314 printf("CFMv%u not supported, length %u",
315 CFM_EXTRACT_VERSION(cfm_common_header
->mdlevel_version
), length
);
319 printf("CFMv%u %s, MD Level %u, length %u",
320 CFM_EXTRACT_VERSION(cfm_common_header
->mdlevel_version
),
321 tok2str(cfm_opcode_values
, "unknown (%u)", cfm_common_header
->opcode
),
322 CFM_EXTRACT_MD_LEVEL(cfm_common_header
->mdlevel_version
),
326 * In non-verbose mode just print the opcode and md-level.
332 printf("\n\tFirst TLV offset %u", cfm_common_header
->first_tlv_offset
);
334 tptr
+= sizeof(const struct cfm_common_header_t
);
335 tlen
= length
- sizeof(struct cfm_common_header_t
);
337 switch (cfm_common_header
->opcode
) {
339 msg_ptr
.cfm_ccm
= (const struct cfm_ccm_t
*)tptr
;
341 ccm_interval
= CFM_EXTRACT_CCM_INTERVAL(cfm_common_header
->flags
);
342 printf(", Flags [CCM Interval %u%s]",
344 cfm_common_header
->flags
& CFM_CCM_RDI_FLAG
?
348 * Resolve the CCM interval field.
351 printf("\n\t CCM Interval %.3fs"
352 ", min CCM Lifetime %.3fs, max CCM Lifetime %.3fs",
353 ccm_interval_base
[ccm_interval
],
354 ccm_interval_base
[ccm_interval
] * CCM_INTERVAL_MIN_MULTIPLIER
,
355 ccm_interval_base
[ccm_interval
] * CCM_INTERVAL_MAX_MULTIPLIER
);
358 printf("\n\t Sequence Number 0x%08x, MA-End-Point-ID 0x%04x",
359 EXTRACT_32BITS(msg_ptr
.cfm_ccm
->sequence
),
360 EXTRACT_16BITS(msg_ptr
.cfm_ccm
->ma_epi
));
364 * Resolve the MD fields.
366 printf("\n\t MD Name Format %s (%u), MD Name length %u",
367 tok2str(cfm_md_nameformat_values
, "Unknown",
368 msg_ptr
.cfm_ccm
->md_nameformat
),
369 msg_ptr
.cfm_ccm
->md_nameformat
,
370 msg_ptr
.cfm_ccm
->md_namelength
);
372 if (msg_ptr
.cfm_ccm
->md_nameformat
!= CFM_CCM_MD_FORMAT_NONE
) {
373 printf("\n\t MD Name: ");
374 switch (msg_ptr
.cfm_ccm
->md_nameformat
) {
375 case CFM_CCM_MD_FORMAT_DNS
:
376 case CFM_CCM_MD_FORMAT_CHAR
:
377 safeputs(msg_ptr
.cfm_ccm
->md_name
, msg_ptr
.cfm_ccm
->md_namelength
);
380 case CFM_CCM_MD_FORMAT_MAC
:
381 printf("\n\t MAC %s", etheraddr_string(
382 msg_ptr
.cfm_ccm
->md_name
));
385 /* FIXME add printers for those MD formats - hexdump for now */
386 case CFM_CCM_MA_FORMAT_8021
:
388 print_unknown_data(msg_ptr
.cfm_ccm
->md_name
, "\n\t ",
389 msg_ptr
.cfm_ccm
->md_namelength
);
395 * Resolve the MA fields.
397 ma_nameformat
= msg_ptr
.cfm_ccm
->md_name
+ msg_ptr
.cfm_ccm
->md_namelength
;
398 ma_namelength
= msg_ptr
.cfm_ccm
->md_name
+ msg_ptr
.cfm_ccm
->md_namelength
+ 1;
399 ma_name
= msg_ptr
.cfm_ccm
->md_name
+ msg_ptr
.cfm_ccm
->md_namelength
+ 2;
401 printf("\n\t MA Name-Format %s (%u), MA name length %u",
402 tok2str(cfm_ma_nameformat_values
, "Unknown",
407 printf("\n\t MA Name: ");
408 switch (*ma_nameformat
) {
409 case CFM_CCM_MA_FORMAT_CHAR
:
410 safeputs(ma_name
, *ma_namelength
);
413 /* FIXME add printers for those MA formats - hexdump for now */
414 case CFM_CCM_MA_FORMAT_8021
:
415 case CFM_CCM_MA_FORMAT_VID
:
416 case CFM_CCM_MA_FORMAT_INT
:
417 case CFM_CCM_MA_FORMAT_VPN
:
419 print_unknown_data(ma_name
, "\n\t ", *ma_namelength
);
424 printf(", Flags [%s]",
425 bittok2str(cfm_ltm_flag_values
, "none", cfm_common_header
->flags
));
427 printf("\n\t Transaction-ID 0x%08x, Egress-ID %s, ttl %u",
428 EXTRACT_32BITS(msg_ptr
.cfm_ltm
->transaction_id
),
429 cfm_egress_id_string(msg_ptr
.cfm_ltm
->egress_id
),
430 msg_ptr
.cfm_ltm
->ttl
);
432 printf("\n\t Original-MAC %s, Target-MAC %s",
433 etheraddr_string(msg_ptr
.cfm_ltm
->original_mac
),
434 etheraddr_string(msg_ptr
.cfm_ltm
->target_mac
));
438 printf(", Flags [%s]",
439 bittok2str(cfm_ltr_flag_values
, "none", cfm_common_header
->flags
));
441 printf("\n\t Transaction-ID 0x%08x, Last-Egress-ID %s",
442 EXTRACT_32BITS(msg_ptr
.cfm_ltr
->transaction_id
),
443 cfm_egress_id_string(msg_ptr
.cfm_ltr
->last_egress_id
));
445 printf("\n\t Next-Egress-ID %s, ttl %u",
446 cfm_egress_id_string(msg_ptr
.cfm_ltr
->next_egress_id
),
447 msg_ptr
.cfm_ltr
->ttl
);
449 printf("\n\t Replay-Action %s (%u)",
450 tok2str(cfm_ltr_replay_action_values
,
452 msg_ptr
.cfm_ltr
->replay_action
),
453 msg_ptr
.cfm_ltr
->replay_action
);
457 * No message decoder yet.
458 * Hexdump everything up until the start of the TLVs
463 if (tlen
> cfm_common_header
->first_tlv_offset
) {
464 print_unknown_data(tptr
, "\n\t ",
465 tlen
- cfm_common_header
->first_tlv_offset
);
471 * Sanity check for not walking off.
473 if (tlen
<= cfm_common_header
->first_tlv_offset
) {
477 tptr
+= cfm_common_header
->first_tlv_offset
;
478 tlen
-= cfm_common_header
->first_tlv_offset
;
481 cfm_tlv_header
= (const struct cfm_tlv_header_t
*)tptr
;
483 /* Enough to read the tlv type ? */
485 cfm_tlv_type
=cfm_tlv_header
->type
;
487 if (cfm_tlv_type
!= CFM_TLV_END
) {
488 /* did we capture enough for fully decoding the object header ? */
489 TCHECK2(*tptr
, sizeof(struct cfm_tlv_header_t
));
490 cfm_tlv_len
=EXTRACT_16BITS(&cfm_tlv_header
->length
);
495 printf("\n\t%s TLV (0x%02x), length %u",
496 tok2str(cfm_tlv_values
, "Unknown", cfm_tlv_type
),
500 /* sanity check for not walking off and infinite loop check. */
501 if ((cfm_tlv_type
!= CFM_TLV_END
) &&
502 ((cfm_tlv_len
+ sizeof(struct cfm_tlv_header_t
) > tlen
) ||
504 print_unknown_data(tptr
,"\n\t ",tlen
);
508 tptr
+= sizeof(struct cfm_tlv_header_t
);
509 tlen
-= sizeof(struct cfm_tlv_header_t
);
512 /* did we capture enough for fully decoding the object ? */
513 if (cfm_tlv_type
!= CFM_TLV_END
) {
514 TCHECK2(*tptr
, cfm_tlv_len
);
518 switch(cfm_tlv_type
) {
520 /* we are done - bail out */
523 case CFM_TLV_PORT_STATUS
:
524 printf(", Status: %s (%u)",
525 tok2str(cfm_tlv_port_status_values
, "Unknown", *tptr
),
529 case CFM_TLV_INTERFACE_STATUS
:
530 printf(", Status: %s (%u)",
531 tok2str(cfm_tlv_interface_status_values
, "Unknown", *tptr
),
535 case CFM_TLV_PRIVATE
:
536 printf(", Vendor: %s (%u), Sub-Type %u",
537 tok2str(oui_values
,"Unknown", EXTRACT_24BITS(tptr
)),
538 EXTRACT_24BITS(tptr
),
543 case CFM_TLV_SENDER_ID
:
545 u_int chassis_id_type
, chassis_id_length
;
546 u_int mgmt_addr_length
;
549 * Check if there is a Chassis-ID.
551 chassis_id_length
= *tptr
;
552 if (chassis_id_length
> tlen
) {
560 if (chassis_id_length
) {
561 chassis_id_type
= *tptr
;
562 printf("\n\t Chassis-ID Type %s (%u), Chassis-ID length %u",
563 tok2str(cfm_tlv_senderid_chassisid_values
,
569 switch (chassis_id_type
) {
570 case CFM_CHASSIS_ID_MAC_ADDRESS
:
571 printf("\n\t MAC %s", etheraddr_string(tptr
+1));
574 case CFM_CHASSIS_ID_NETWORK_ADDRESS
:
575 hexdump
|= cfm_mgmt_addr_print(tptr
);
578 case CFM_CHASSIS_ID_INTERFACE_NAME
: /* fall through */
579 case CFM_CHASSIS_ID_INTERFACE_ALIAS
:
580 case CFM_CHASSIS_ID_LOCAL
:
581 case CFM_CHASSIS_ID_CHASSIS_COMPONENT
:
582 case CFM_CHASSIS_ID_PORT_COMPONENT
:
583 safeputs(tptr
+1, chassis_id_length
);
592 tptr
+= chassis_id_length
;
593 tlen
-= chassis_id_length
;
596 * Check if there is a Management Address.
598 mgmt_addr_length
= *tptr
;
599 if (mgmt_addr_length
> tlen
) {
607 if (mgmt_addr_length
) {
608 hexdump
|= cfm_mgmt_addr_print(tptr
);
611 tptr
+= mgmt_addr_length
;
612 tlen
-= mgmt_addr_length
;
618 * FIXME those are the defined TLVs that lack a decoder
619 * you are welcome to contribute code ;-)
623 case CFM_TLV_REPLY_INGRESS
:
624 case CFM_TLV_REPLY_EGRESS
:
629 /* do we want to see an additional hexdump ? */
630 if (hexdump
|| vflag
> 1)
631 print_unknown_data(tlv_ptr
, "\n\t ", cfm_tlv_len
);
638 printf("\n\t\t packet exceeded snapshot");