1/* 2 * Copyright (c) 1994, 1995, 1996, 1997 3 * The Regents of the University of California. All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that: (1) source code distributions 7 * retain the above copyright notice and this paragraph in its entirety, (2) 8 * distributions including binary code include the above copyright notice and 9 * this paragraph in its entirety in the documentation or other materials 10 * provided with the distribution, and (3) all advertising materials mentioning 11 * features or use of this software display the following acknowledgement: 12 * ``This product includes software developed by the University of California, 13 * Lawrence Berkeley Laboratory and its contributors.'' Neither the name of 14 * the University nor the names of its contributors may be used to endorse 15 * or promote products derived from this software without specific prior 16 * written permission. 17 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED 18 * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF 19 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 20 */ 21 22/* \summary: Asynchronous Transfer Mode (ATM) printer */ 23 24#ifdef HAVE_CONFIG_H 25#include <config.h> 26#endif 27 28#include "netdissect-stdinc.h" 29 30#define ND_LONGJMP_FROM_TCHECK 31#include "netdissect.h" 32#include "extract.h" 33#include "addrtoname.h" 34#include "atm.h" 35#include "llc.h" 36 37/* start of the original atmuni31.h */ 38 39/* 40 * Copyright (c) 1997 Yen Yen Lim and North Dakota State University 41 * All rights reserved. 42 * 43 * Redistribution and use in source and binary forms, with or without 44 * modification, are permitted provided that the following conditions 45 * are met: 46 * 1. Redistributions of source code must retain the above copyright 47 * notice, this list of conditions and the following disclaimer. 48 * 2. Redistributions in binary form must reproduce the above copyright 49 * notice, this list of conditions and the following disclaimer in the 50 * documentation and/or other materials provided with the distribution. 51 * 3. All advertising materials mentioning features or use of this software 52 * must display the following acknowledgement: 53 * This product includes software developed by Yen Yen Lim and 54 North Dakota State University 55 * 4. The name of the author may not be used to endorse or promote products 56 * derived from this software without specific prior written permission. 57 * 58 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 59 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 60 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 61 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, 62 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 63 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 64 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 65 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 66 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 67 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 68 * POSSIBILITY OF SUCH DAMAGE. 69 */ 70 71/* Based on UNI3.1 standard by ATM Forum */ 72 73/* ATM traffic types based on VPI=0 and (the following VCI */ 74#define VCI_PPC 0x05 /* Point-to-point signal msg */ 75#define VCI_BCC 0x02 /* Broadcast signal msg */ 76#define VCI_OAMF4SC 0x03 /* Segment OAM F4 flow cell */ 77#define VCI_OAMF4EC 0x04 /* End-to-end OAM F4 flow cell */ 78#define VCI_METAC 0x01 /* Meta signal msg */ 79#define VCI_ILMIC 0x10 /* ILMI msg */ 80 81/* Q.2931 signalling messages */ 82#define CALL_PROCEED 0x02 /* call proceeding */ 83#define CONNECT 0x07 /* connect */ 84#define CONNECT_ACK 0x0f /* connect_ack */ 85#define SETUP 0x05 /* setup */ 86#define RELEASE 0x4d /* release */ 87#define RELEASE_DONE 0x5a /* release_done */ 88#define RESTART 0x46 /* restart */ 89#define RESTART_ACK 0x4e /* restart ack */ 90#define STATUS 0x7d /* status */ 91#define STATUS_ENQ 0x75 /* status ack */ 92#define ADD_PARTY 0x80 /* add party */ 93#define ADD_PARTY_ACK 0x81 /* add party ack */ 94#define ADD_PARTY_REJ 0x82 /* add party rej */ 95#define DROP_PARTY 0x83 /* drop party */ 96#define DROP_PARTY_ACK 0x84 /* drop party ack */ 97 98/* Information Element Parameters in the signalling messages */ 99#define CAUSE 0x08 /* cause */ 100#define ENDPT_REF 0x54 /* endpoint reference */ 101#define AAL_PARA 0x58 /* ATM adaptation layer parameters */ 102#define TRAFF_DESCRIP 0x59 /* atm traffic descriptors */ 103#define CONNECT_ID 0x5a /* connection identifier */ 104#define QOS_PARA 0x5c /* quality of service parameters */ 105#define B_HIGHER 0x5d /* broadband higher layer information */ 106#define B_BEARER 0x5e /* broadband bearer capability */ 107#define B_LOWER 0x5f /* broadband lower information */ 108#define CALLING_PARTY 0x6c /* calling party number */ 109#define CALLED_PARTY 0x70 /* called party nmber */ 110 111#define Q2931 0x09 112 113/* Q.2931 signalling general messages format */ 114#define PROTO_POS 0 /* offset of protocol discriminator */ 115#define CALL_REF_POS 2 /* offset of call reference value */ 116#define MSG_TYPE_POS 5 /* offset of message type */ 117#if 0 118#define MSG_LEN_POS 7 /* offset of message length */ 119#define IE_BEGIN_POS 9 /* offset of first information element */ 120 121/* format of signalling messages */ 122#define TYPE_POS 0 123#define LEN_POS 2 124#define FIELD_BEGIN_POS 4 125#endif 126 127/* end of the original atmuni31.h */ 128 129 130#define OAM_CRC10_MASK 0x3ff 131#define OAM_PAYLOAD_LEN 48 132#define OAM_FUNCTION_SPECIFIC_LEN 45 /* this excludes crc10 and cell-type/function-type */ 133#define OAM_CELLTYPE_FUNCTYPE_LEN 1 134 135static const struct tok oam_f_values[] = { 136 { VCI_OAMF4SC, "OAM F4 (segment)" }, 137 { VCI_OAMF4EC, "OAM F4 (end)" }, 138 { 0, NULL } 139}; 140 141static const struct tok atm_pty_values[] = { 142 { 0x0, "user data, uncongested, SDU 0" }, 143 { 0x1, "user data, uncongested, SDU 1" }, 144 { 0x2, "user data, congested, SDU 0" }, 145 { 0x3, "user data, congested, SDU 1" }, 146 { 0x4, "VCC OAM F5 flow segment" }, 147 { 0x5, "VCC OAM F5 flow end-to-end" }, 148 { 0x6, "Traffic Control and resource Mgmt" }, 149 { 0, NULL } 150}; 151 152#define OAM_CELLTYPE_FM 0x1 153#define OAM_CELLTYPE_PM 0x2 154#define OAM_CELLTYPE_AD 0x8 155#define OAM_CELLTYPE_SM 0xf 156 157static const struct tok oam_celltype_values[] = { 158 { OAM_CELLTYPE_FM, "Fault Management" }, 159 { OAM_CELLTYPE_PM, "Performance Management" }, 160 { OAM_CELLTYPE_AD, "activate/deactivate" }, 161 { OAM_CELLTYPE_SM, "System Management" }, 162 { 0, NULL } 163}; 164 165#define OAM_FM_FUNCTYPE_AIS 0x0 166#define OAM_FM_FUNCTYPE_RDI 0x1 167#define OAM_FM_FUNCTYPE_CONTCHECK 0x4 168#define OAM_FM_FUNCTYPE_LOOPBACK 0x8 169 170static const struct tok oam_fm_functype_values[] = { 171 { OAM_FM_FUNCTYPE_AIS, "AIS" }, 172 { OAM_FM_FUNCTYPE_RDI, "RDI" }, 173 { OAM_FM_FUNCTYPE_CONTCHECK, "Continuity Check" }, 174 { OAM_FM_FUNCTYPE_LOOPBACK, "Loopback" }, 175 { 0, NULL } 176}; 177 178static const struct tok oam_pm_functype_values[] = { 179 { 0x0, "Forward Monitoring" }, 180 { 0x1, "Backward Reporting" }, 181 { 0x2, "Monitoring and Reporting" }, 182 { 0, NULL } 183}; 184 185static const struct tok oam_ad_functype_values[] = { 186 { 0x0, "Performance Monitoring" }, 187 { 0x1, "Continuity Check" }, 188 { 0, NULL } 189}; 190 191#define OAM_FM_LOOPBACK_INDICATOR_MASK 0x1 192 193static const struct tok oam_fm_loopback_indicator_values[] = { 194 { 0x0, "Reply" }, 195 { 0x1, "Request" }, 196 { 0, NULL } 197}; 198 199static const struct uint_tokary oam_celltype2tokary[] = { 200 { OAM_CELLTYPE_FM, oam_fm_functype_values }, 201 { OAM_CELLTYPE_PM, oam_pm_functype_values }, 202 { OAM_CELLTYPE_AD, oam_ad_functype_values }, 203 /* uint2tokary() does not use array termination. */ 204}; 205 206/* 207 * Print an RFC 1483 LLC-encapsulated ATM frame. 208 */ 209static u_int 210atm_llc_print(netdissect_options *ndo, 211 const u_char *p, int length, int caplen) 212{ 213 int llc_hdrlen; 214 215 llc_hdrlen = llc_print(ndo, p, length, caplen, NULL, NULL); 216 if (llc_hdrlen < 0) { 217 /* packet not known, print raw packet */ 218 if (!ndo->ndo_suppress_default_print) 219 ND_DEFAULTPRINT(p, caplen); 220 llc_hdrlen = -llc_hdrlen; 221 } 222 return (llc_hdrlen); 223} 224 225/* 226 * Given a SAP value, generate the LLC header value for a UI packet 227 * with that SAP as the source and destination SAP. 228 */ 229#define LLC_UI_HDR(sap) ((sap)<<16 | (sap<<8) | 0x03) 230 231/* 232 * This is the top level routine of the printer. 'p' points 233 * to the LLC/SNAP header of the packet, 'h->ts' is the timestamp, 234 * 'h->len' is the length of the packet off the wire, and 'h->caplen' 235 * is the number of bytes actually captured. 236 */ 237void 238atm_if_print(netdissect_options *ndo, 239 const struct pcap_pkthdr *h, const u_char *p) 240{ 241 u_int caplen = h->caplen; 242 u_int length = h->len; 243 uint32_t llchdr; 244 u_int hdrlen = 0; 245 246 ndo->ndo_protocol = "atm"; 247 248 /* Cisco Style NLPID ? */ 249 if (GET_U_1(p) == LLC_UI) { 250 if (ndo->ndo_eflag) 251 ND_PRINT("CNLPID "); 252 ndo->ndo_ll_hdr_len += 1; 253 isoclns_print(ndo, p + 1, length - 1); 254 return; 255 } 256 257 /* 258 * Must have at least a DSAP, an SSAP, and the first byte of the 259 * control field. 260 */ 261 262 /* 263 * Extract the presumed LLC header into a variable, for quick 264 * testing. 265 * Then check for a header that's neither a header for a SNAP 266 * packet nor an RFC 2684 routed NLPID-formatted PDU nor 267 * an 802.2-but-no-SNAP IP packet. 268 */ 269 llchdr = GET_BE_U_3(p); 270 if (llchdr != LLC_UI_HDR(LLCSAP_SNAP) && 271 llchdr != LLC_UI_HDR(LLCSAP_ISONS) && 272 llchdr != LLC_UI_HDR(LLCSAP_IP)) { 273 /* 274 * XXX - assume 802.6 MAC header from Fore driver. 275 * 276 * Unfortunately, the above list doesn't check for 277 * all known SAPs, doesn't check for headers where 278 * the source and destination SAP aren't the same, 279 * and doesn't check for non-UI frames. It also 280 * runs the risk of an 802.6 MAC header that happens 281 * to begin with one of those values being 282 * incorrectly treated as an 802.2 header. 283 * 284 * So is that Fore driver still around? And, if so, 285 * is it still putting 802.6 MAC headers on ATM 286 * packets? If so, could it be changed to use a 287 * new DLT_IEEE802_6 value if we added it? 288 */ 289 if (ndo->ndo_eflag) 290 ND_PRINT("%08x%08x %08x%08x ", 291 GET_BE_U_4(p), 292 GET_BE_U_4(p + 4), 293 GET_BE_U_4(p + 8), 294 GET_BE_U_4(p + 12)); 295 /* Always cover the full header. */ 296 ND_TCHECK_LEN(p, 20); 297 p += 20; 298 length -= 20; 299 caplen -= 20; 300 hdrlen += 20; 301 } 302 ndo->ndo_ll_hdr_len += hdrlen; 303 ndo->ndo_ll_hdr_len += atm_llc_print(ndo, p, length, caplen); 304} 305 306/* 307 * ATM signalling. 308 */ 309static const struct tok msgtype2str[] = { 310 { CALL_PROCEED, "Call_proceeding" }, 311 { CONNECT, "Connect" }, 312 { CONNECT_ACK, "Connect_ack" }, 313 { SETUP, "Setup" }, 314 { RELEASE, "Release" }, 315 { RELEASE_DONE, "Release_complete" }, 316 { RESTART, "Restart" }, 317 { RESTART_ACK, "Restart_ack" }, 318 { STATUS, "Status" }, 319 { STATUS_ENQ, "Status_enquiry" }, 320 { ADD_PARTY, "Add_party" }, 321 { ADD_PARTY_ACK, "Add_party_ack" }, 322 { ADD_PARTY_REJ, "Add_party_reject" }, 323 { DROP_PARTY, "Drop_party" }, 324 { DROP_PARTY_ACK, "Drop_party_ack" }, 325 { 0, NULL } 326}; 327 328static void 329sig_print(netdissect_options *ndo, 330 const u_char *p) 331{ 332 uint32_t call_ref; 333 334 if (GET_U_1(p + PROTO_POS) == Q2931) { 335 /* 336 * protocol:Q.2931 for User to Network Interface 337 * (UNI 3.1) signalling 338 */ 339 ND_PRINT("Q.2931"); 340 ND_PRINT(":%s ", 341 tok2str(msgtype2str, "msgtype#%u", GET_U_1(p + MSG_TYPE_POS))); 342 343 /* 344 * The call reference comes before the message type, 345 * so if we know we have the message type, which we 346 * do from the caplen test above, we also know we have 347 * the call reference. 348 */ 349 call_ref = GET_BE_U_3(p + CALL_REF_POS); 350 ND_PRINT("CALL_REF:0x%06x", call_ref); 351 } else { 352 /* SSCOP with some unknown protocol atop it */ 353 ND_PRINT("SSCOP, proto %u ", GET_U_1(p + PROTO_POS)); 354 } 355} 356 357/* 358 * Print an ATM PDU (such as an AAL5 PDU). 359 */ 360void 361atm_print(netdissect_options *ndo, 362 u_int vpi, u_int vci, u_int traftype, const u_char *p, u_int length, 363 u_int caplen) 364{ 365 ndo->ndo_protocol = "atm"; 366 if (ndo->ndo_eflag) 367 ND_PRINT("VPI:%u VCI:%u ", vpi, vci); 368 369 if (vpi == 0) { 370 switch (vci) { 371 372 case VCI_PPC: 373 sig_print(ndo, p); 374 return; 375 376 case VCI_BCC: 377 ND_PRINT("broadcast sig: "); 378 return; 379 380 case VCI_OAMF4SC: /* fall through */ 381 case VCI_OAMF4EC: 382 oam_print(ndo, p, length, ATM_OAM_HEC); 383 return; 384 385 case VCI_METAC: 386 ND_PRINT("meta: "); 387 return; 388 389 case VCI_ILMIC: 390 ND_PRINT("ilmi: "); 391 snmp_print(ndo, p, length); 392 return; 393 } 394 } 395 396 switch (traftype) { 397 398 case ATM_LLC: 399 default: 400 /* 401 * Assumes traffic is LLC if unknown. 402 */ 403 atm_llc_print(ndo, p, length, caplen); 404 break; 405 406 case ATM_LANE: 407 lane_print(ndo, p, length, caplen); 408 break; 409 } 410} 411 412struct oam_fm_loopback_t { 413 nd_uint8_t loopback_indicator; 414 nd_uint32_t correlation_tag; 415 nd_byte loopback_id[12]; 416 nd_byte source_id[12]; 417 nd_byte unused[16]; 418}; 419 420struct oam_fm_ais_rdi_t { 421 nd_uint8_t failure_type; 422 nd_byte failure_location[16]; 423 nd_byte unused[28]; 424}; 425 426void 427oam_print(netdissect_options *ndo, 428 const u_char *p, u_int length, u_int hec) 429{ 430 uint32_t cell_header; 431 uint16_t vpi, vci, cksum, cksum_shouldbe, idx; 432 uint8_t cell_type, func_type, payload, clp; 433 const struct tok *oam_functype_str; 434 435 union { 436 const struct oam_fm_loopback_t *oam_fm_loopback; 437 const struct oam_fm_ais_rdi_t *oam_fm_ais_rdi; 438 } oam_ptr; 439 440 ndo->ndo_protocol = "oam"; 441 cell_header = GET_BE_U_4(p + hec); 442 cell_type = (GET_U_1((p + ATM_HDR_LEN_NOHEC + hec)) >> 4) & 0x0f; 443 func_type = GET_U_1((p + ATM_HDR_LEN_NOHEC + hec)) & 0x0f; 444 445 vpi = (cell_header>>20)&0xff; 446 vci = (cell_header>>4)&0xffff; 447 payload = (cell_header>>1)&0x7; 448 clp = cell_header&0x1; 449 450 ND_PRINT("%s, vpi %u, vci %u, payload [ %s ], clp %u, length %u", 451 tok2str(oam_f_values, "OAM F5", vci), 452 vpi, vci, 453 tok2str(atm_pty_values, "Unknown", payload), 454 clp, length); 455 456 if (!ndo->ndo_vflag) { 457 return; 458 } 459 460 ND_PRINT("\n\tcell-type %s (%u)", 461 tok2str(oam_celltype_values, "unknown", cell_type), 462 cell_type); 463 464 oam_functype_str = uint2tokary(oam_celltype2tokary, cell_type); 465 if (oam_functype_str == NULL) 466 ND_PRINT(", func-type unknown (%u)", func_type); 467 else 468 ND_PRINT(", func-type %s (%u)", 469 tok2str(oam_functype_str, "none", func_type), 470 func_type); 471 472 p += ATM_HDR_LEN_NOHEC + hec; 473 474 switch (cell_type << 4 | func_type) { 475 case (OAM_CELLTYPE_FM << 4 | OAM_FM_FUNCTYPE_LOOPBACK): 476 oam_ptr.oam_fm_loopback = (const struct oam_fm_loopback_t *)(p + OAM_CELLTYPE_FUNCTYPE_LEN); 477 ND_TCHECK_SIZE(oam_ptr.oam_fm_loopback); 478 ND_PRINT("\n\tLoopback-Indicator %s, Correlation-Tag 0x%08x", 479 tok2str(oam_fm_loopback_indicator_values, 480 "Unknown", 481 GET_U_1(oam_ptr.oam_fm_loopback->loopback_indicator) & OAM_FM_LOOPBACK_INDICATOR_MASK), 482 GET_BE_U_4(oam_ptr.oam_fm_loopback->correlation_tag)); 483 ND_PRINT("\n\tLocation-ID "); 484 for (idx = 0; idx < sizeof(oam_ptr.oam_fm_loopback->loopback_id); idx++) { 485 if (idx % 2) { 486 ND_PRINT("%04x ", 487 GET_BE_U_2(&oam_ptr.oam_fm_loopback->loopback_id[idx])); 488 } 489 } 490 ND_PRINT("\n\tSource-ID "); 491 for (idx = 0; idx < sizeof(oam_ptr.oam_fm_loopback->source_id); idx++) { 492 if (idx % 2) { 493 ND_PRINT("%04x ", 494 GET_BE_U_2(&oam_ptr.oam_fm_loopback->source_id[idx])); 495 } 496 } 497 break; 498 499 case (OAM_CELLTYPE_FM << 4 | OAM_FM_FUNCTYPE_AIS): 500 case (OAM_CELLTYPE_FM << 4 | OAM_FM_FUNCTYPE_RDI): 501 oam_ptr.oam_fm_ais_rdi = (const struct oam_fm_ais_rdi_t *)(p + OAM_CELLTYPE_FUNCTYPE_LEN); 502 ND_TCHECK_SIZE(oam_ptr.oam_fm_ais_rdi); 503 ND_PRINT("\n\tFailure-type 0x%02x", 504 GET_U_1(oam_ptr.oam_fm_ais_rdi->failure_type)); 505 ND_PRINT("\n\tLocation-ID "); 506 for (idx = 0; idx < sizeof(oam_ptr.oam_fm_ais_rdi->failure_location); idx++) { 507 if (idx % 2) { 508 ND_PRINT("%04x ", 509 GET_BE_U_2(&oam_ptr.oam_fm_ais_rdi->failure_location[idx])); 510 } 511 } 512 break; 513 514 case (OAM_CELLTYPE_FM << 4 | OAM_FM_FUNCTYPE_CONTCHECK): 515 /* FIXME */ 516 break; 517 518 default: 519 break; 520 } 521 522 /* crc10 checksum verification */ 523 cksum = GET_BE_U_2(p + OAM_CELLTYPE_FUNCTYPE_LEN + OAM_FUNCTION_SPECIFIC_LEN) 524 & OAM_CRC10_MASK; 525 cksum_shouldbe = verify_crc10_cksum(0, p, OAM_PAYLOAD_LEN); 526 527 ND_PRINT("\n\tcksum 0x%03x (%scorrect)", 528 cksum, 529 cksum_shouldbe == 0 ? "" : "in"); 530} 531