/* packet-lnpdqp-template.c * Routines for Local Number Portability Database Query Protocol dissection * * SPDX-License-Identifier: GPL-2.0-or-later * * Ref GR-533 i2 2001 */ #include "config.h" #include #include #include #include "packet-ber.h" #define PNAME "Local Number Portability Database Query" #define PSNAME "LNPDQP" #define PFNAME "lnpdqp" /* * Operation Code is partitioned into: * Operation Family = ConnectionControl, no Reply Required (4) * Operation Specifier = Connect (1) */ #define LNPDQP_ANSI_TCAP_OPCODE_CC 0x0401 /* * Operation Code is partitioned into: * Operation Family = ProvideInstruction, Reply Required (131) 0x83 * Operation Specifier = Start (1) */ /* Excluding H bit */ #define LNPDQP_ANSI_TCAP_OPCODE_PI 0x0301 void proto_reg_handoff_lnpdqp(void); void proto_register_lnpdqp(void); /* Initialize the protocol and registered fields */ static int proto_lnpdqp; static int hf_lnpdqp_type_of_digits; static int hf_lnpdqp_nature_of_number; static int hf_lnpdqp_digits_enc; static int hf_lnpdqp_np; static int hf_lnpdqp_nr_digits; static int hf_lnpdqp_bcd_digits; static int hf_lnpdqp_ia5_digits; /* asn2wrs/the ber dissector does not handle the same tag used multiple times * in asn1 description, do some magic to handle. */ static int hf_lnpdqp_networkRoutingNumber; /* Digits */ static int hf_lnpdqp_callingPartyANI; /* Digits */ static int hf_lnpdqp_originatingLATA; /* Digits */ static int hf_lnpdqp_carrierID; /* Digits */ #include "packet-lnpdqp-hf.c" static int ett_lnpdqp; static int ett_lnpdqp_digitstype; static int ett_lnpdqp_digits; #include "packet-lnpdqp-ett.c" /* Type of Digits (octet 1, bits A-H) */ static const value_string lnpdqp_type_of_digits_vals[] = { { 0, "Not Used" }, { 1, "Dialed Number or Called Party Number" }, { 2, "Calling Party Number" }, { 3, "Caller Interaction" }, { 4, "Routing Number" }, { 5, "Billing Number" }, { 6, "Destination Number" }, { 7, "LATA" }, { 8, "Carrier" }, { 9, "Last Calling Party" }, { 10, "Last Party Called" }, { 11, "Calling Directory Number" }, { 12, "VMSR Identifier" }, { 13, "Original Called Number" }, { 14, "Redirecting Number" }, { 15, "Connected Number" }, { 0, NULL } }; #if 0 XXXX Currently unused /* Nature of Number (octet 2, bits A-H )*/ static const true_false_string lnpdqp_na_bool_val = { "International", "National" }; static const true_false_string lnpdqp_pi_bool_val = { "Presentation Restricted", "Presentation Allowed" }; static const true_false_string lnpdqp_navail_bool_val = { "Number is not available", "Number is available" }; static const true_false_string lnpdqp_si_bool_val = { "User provided, screening passed", "User provided, not screened" }; #endif static const value_string lnpdqp_na_vals[] = { { 0, "National, No Presentation Restricted"}, { 1, "International, No Presentation Restricted"}, { 2, "National, Presentation Restricted"}, { 3, "International, Presentation Restricted"}, { 0, NULL } }; /* Encoding (octet 3, bits A-D) */ static const value_string lnpdqp_digits_enc_vals[] = { { 0, "Not used"}, { 1, "BCD"}, { 2, "IA5"}, { 3, "Octet string"}, { 0, NULL } }; /* Numbering Plan (octet 3, bits E-H) */ static const value_string lnpdqp_np_vals[] = { { 0, "Unknown or not applicable"}, { 1, "ISDN Numbering Plan (ITU Rec. E.164)"}, { 2, "Telephony Numbering (ITU-T Rec. E.164,E.163)"}, { 3, "Data Numbering (ITU-T Rec. X.121)"}, { 4, "Telex Numbering (ITU-T Rec. F.69)"}, { 5, "Maritime Mobile Numbering"}, { 6, "Land Mobile Numbering (ITU-T Rec. E.212)"}, { 7, "Private Numbering Plan"}, { 0, NULL } }; /* * OriginatingStationType ::= OCTET STRING (SIZE(1)) * The following codes are used in the originating line information field: * 00000010 } Binary values administered by the North * to } American Numbering Administration * 01100011 } * Ref http://www.nanpa.com/number_resource_info/ani_ii_assignments.html */ static const value_string lnpdqp_OriginatingStationType_vals[] = { { 0, "Plain Old Telephone Service (POTS) - non-coin service requiring no special treatment"}, { 1, "Multiparty line (more than 2) - ANI cannot be provided on 4 or 8 party lines. "}, { 2, "ANI Failure "}, /* 03-05 Unassigned */ { 6, "Station Level Rating "}, { 7, "Special Operator Handling Required"}, /* 08-09 Unassigned */ { 10, "Not assignable - conflict with 10X test code"}, /* 11 Unassigned */ /* 12-19 Not assignable - conflict with international outpulsing code */ { 20, "Automatic Identified Outward Dialing (AIOD)"}, /* 21-22 Unassigned */ /* To lasy to do these */ { 61, "Cellular/Wireless PCS (Type 1) "}, { 62, "Cellular/Wireless PCS (Type 2) "}, { 63, "Cellular/Wireless PCS (Roaming)"}, { 0, NULL } }; static void dissect_lnpdqp_digits_type(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree _U_, asn1_ctx_t *actx _U_){ uint8_t octet , no_of_digits; int offset = 0; char *digit_str; proto_tree *subtree; subtree = proto_item_add_subtree(actx->created_item, ett_lnpdqp_digitstype); /* Octet 1 Type of Digits*/ proto_tree_add_item(subtree, hf_lnpdqp_type_of_digits, tvb, offset, 1, ENC_BIG_ENDIAN); offset++; /* Octet 2 Nature of Number*/ proto_tree_add_item(subtree, hf_lnpdqp_nature_of_number, tvb, offset, 1, ENC_BIG_ENDIAN); offset++; /* Octet 3 Numbering Plan |Encoding Scheme| */ octet = tvb_get_uint8(tvb,offset); proto_tree_add_item(subtree, hf_lnpdqp_np, tvb, offset, 1, ENC_BIG_ENDIAN); proto_tree_add_item(subtree, hf_lnpdqp_digits_enc, tvb, offset, 1, ENC_BIG_ENDIAN); offset++; /* Octet 4 Number of Digits */ switch ((octet&0xf)){ case 1: /* BCD Coding */ no_of_digits = tvb_get_uint8(tvb,offset); proto_tree_add_item(subtree, hf_lnpdqp_nr_digits, tvb, offset, 1, ENC_BIG_ENDIAN); if(no_of_digits == 0) return; offset++; proto_tree_add_item_ret_display_string(subtree, hf_lnpdqp_bcd_digits, tvb, offset, -1, ENC_KEYPAD_BC_TBCD|ENC_LITTLE_ENDIAN, pinfo->pool, &digit_str); proto_item_append_text(actx->created_item, " - %s", digit_str); break; case 2: /* IA5 Coding */ no_of_digits = tvb_get_uint8(tvb,offset); proto_tree_add_item(subtree, hf_lnpdqp_nr_digits, tvb, offset, 1, ENC_BIG_ENDIAN); if(no_of_digits == 0) return; offset++; proto_tree_add_item(subtree, hf_lnpdqp_ia5_digits, tvb, offset, -1, ENC_ASCII); proto_item_append_text(actx->created_item, " - %s", tvb_get_string_enc(pinfo->pool,tvb,offset,tvb_reported_length_remaining(tvb,offset), ENC_ASCII | ENC_NA)); break; default: break; } } #include "packet-lnpdqp-fn.c" static int dissect_lnpdqp_cc(tvbuff_t *tvb, packet_info *pinfo, proto_tree *parent_tree, void *data _U_) { proto_item *item=NULL; proto_tree *tree=NULL; asn1_ctx_t asn1_ctx; asn1_ctx_init(&asn1_ctx, ASN1_ENC_BER, true, pinfo); col_set_str(pinfo->cinfo, COL_PROTOCOL, PSNAME); col_set_str(pinfo->cinfo, COL_INFO, "ConnectionControl"); /* create display subtree for the protocol */ item = proto_tree_add_item(parent_tree, proto_lnpdqp, tvb, 0, -1, ENC_NA); tree = proto_item_add_subtree(item, ett_lnpdqp); return dissect_ConnectionControlArg_PDU(tvb, pinfo, tree, NULL); } static int dissect_lnpdqp_pi(tvbuff_t *tvb, packet_info *pinfo, proto_tree *parent_tree, void *data _U_) { proto_item *item=NULL; proto_tree *tree=NULL; asn1_ctx_t asn1_ctx; asn1_ctx_init(&asn1_ctx, ASN1_ENC_BER, true, pinfo); col_set_str(pinfo->cinfo, COL_PROTOCOL, PSNAME); col_set_str(pinfo->cinfo, COL_INFO, "ProvideInstruction"); /* create display subtree for the protocol */ item = proto_tree_add_item(parent_tree, proto_lnpdqp, tvb, 0, -1, ENC_NA); tree = proto_item_add_subtree(item, ett_lnpdqp); return dissect_ProvideInstructionArg_PDU(tvb, pinfo, tree, NULL); } void proto_register_lnpdqp(void) { /* List of fields */ static hf_register_info hf[] = { { &hf_lnpdqp_type_of_digits, { "Type of Digits", "lnpdqp.type_of_digits", FT_UINT8, BASE_DEC, VALS(lnpdqp_type_of_digits_vals), 0x0, NULL, HFILL }}, { &hf_lnpdqp_nature_of_number, { "Nature of Number", "lnpdqp.na", FT_UINT8, BASE_DEC, VALS(lnpdqp_na_vals), 0x0, NULL, HFILL }}, { &hf_lnpdqp_digits_enc, { "Encoding", "lnpdqp.enc", FT_UINT8, BASE_DEC, VALS(lnpdqp_digits_enc_vals), 0x0f, NULL, HFILL }}, { &hf_lnpdqp_np, { "Numbering Plan", "lnpdqp.np", FT_UINT8, BASE_DEC, VALS(lnpdqp_np_vals), 0xf0, NULL, HFILL }}, { &hf_lnpdqp_nr_digits, { "Number of Digits", "lnpdqp.nr_digits", FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL }}, { &hf_lnpdqp_bcd_digits, { "BCD digits", "lnpdqp.bcd_digits", FT_STRING, BASE_NONE, NULL, 0, NULL, HFILL }}, { &hf_lnpdqp_ia5_digits, { "IA5 digits", "lnpdqp.ia5_digits", FT_STRING, BASE_NONE, NULL, 0, NULL, HFILL }}, /* asn2wrs/the ber dissector does not handle the same tag used multiple times * in asn1 description, do some magic to handle. */ { &hf_lnpdqp_networkRoutingNumber, { "networkRoutingNumber", "lnpdqp.networkRoutingNumber", FT_BYTES, BASE_NONE, NULL, 0, "Digits", HFILL }}, { &hf_lnpdqp_callingPartyANI, { "callingPartyANI", "lnpdqp.callingPartyANI", FT_BYTES, BASE_NONE, NULL, 0, "Digits", HFILL }}, { &hf_lnpdqp_originatingLATA, { "originatingLATA", "lnpdqp.originatingLATA", FT_BYTES, BASE_NONE, NULL, 0, "Digits", HFILL }}, { &hf_lnpdqp_carrierID, { "carrierID", "lnpdqp.carrierID", FT_BYTES, BASE_NONE, NULL, 0, "Digits", HFILL }}, #include "packet-lnpdqp-hfarr.c" }; /* List of subtrees */ static int *ett[] = { &ett_lnpdqp, &ett_lnpdqp_digitstype, &ett_lnpdqp_digits, #include "packet-lnpdqp-ettarr.c" }; /* Register protocol */ proto_lnpdqp = proto_register_protocol(PNAME, PSNAME, PFNAME); register_dissector("lnpdqp_cc", dissect_lnpdqp_cc, proto_lnpdqp); register_dissector("lnpdqp_pi", dissect_lnpdqp_pi, proto_lnpdqp); /* Register fields and subtrees */ proto_register_field_array(proto_lnpdqp, hf, array_length(hf)); proto_register_subtree_array(ett, array_length(ett)); } void proto_reg_handoff_lnpdqp(void) { static dissector_handle_t lnpdqp_cc_handle, lnpdqp_pi_handle; lnpdqp_cc_handle = find_dissector("lnpdqp_cc"); lnpdqp_pi_handle = find_dissector("lnpdqp_pi"); dissector_add_uint("ansi_tcap.nat.opcode", LNPDQP_ANSI_TCAP_OPCODE_CC, lnpdqp_cc_handle); dissector_add_uint("ansi_tcap.nat.opcode", LNPDQP_ANSI_TCAP_OPCODE_PI, lnpdqp_pi_handle); } /* * Editor modelines * * Local Variables: * c-basic-offset: 4 * tab-width: 8 * indent-tabs-mode: nil * End: * * ex: set shiftwidth=4 tabstop=8 expandtab: * :indentSize=4:tabSize=8:noTabs=true: */