packet-m3ua.c

   1 /* packet-m3ua.c
   2  * Routines for MTP3 User Adaptation Layer dissection
   3  * It is hopefully (needs testing) compilant to
   4  * http://www.ietf.org/internet-drafts/draft-ietf-sigtran-m3ua-06.txt
   5  * http://www.ietf.org/internet-drafts/draft-ietf-sigtran-m3ua-12.txt
   6  * To do: - clean up the code
   7  *        - provide better handling of length parameters
   8  *        - provide good information in summary window
   9  *
  10  * Copyright 2000, 2001, 2002, Michael Tuexen <Michael.Tuexen@icn.siemens.de>
  11  *
  12  * $Id: packet-m3ua.c,v 1.19 2002/07/17 00:42:41 guy Exp $
  13  *
  14  * Ethereal - Network traffic analyzer
  15  * By Gerald Combs <gerald@ethereal.com>
  16  * Copyright 1998 Gerald Combs
  17  *
  18  * Copied from README.developer
  19  *
  20  * This program is free software; you can redistribute it and/or
  21  * modify it under the terms of the GNU General Public License
  22  * as published by the Free Software Foundation; either version 2
  23  * of the License, or (at your option) any later version.
  24  *
  25  * This program is distributed in the hope that it will be useful,
  26  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  27  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  28  * GNU General Public License for more details.
  29  *
  30  * You should have received a copy of the GNU General Public License
  31  * along with this program; if not, write to the Free Software
  32  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  33  */
  34
  35 #ifdef HAVE_CONFIG_H
  36 # include "config.h"
  37 #endif
  38
  39 #include <stdio.h>
  40 #include <stdlib.h>
  41
  42
  43 #ifdef HAVE_SYS_TYPES_H
  44 # include <sys/types.h>
  45 #endif
  46
  47 #ifdef HAVE_NETINET_IN_H
  48 # include <netinet/in.h>
  49 #endif
  50
  51 #include <string.h>
  52 #include <glib.h>
  53
  54 #include <epan/packet.h>
  55 #include "prefs.h"
  56
  57 #define SCTP_PORT_M3UA         2905
  58 #define M3UA_PAYLOAD_PROTO_ID  3
  59
  60 #define VERSION_LENGTH         1
  61 #define RESERVED_LENGTH        1
  62 #define MESSAGE_CLASS_LENGTH   1
  63 #define MESSAGE_TYPE_LENGTH    1
  64 #define MESSAGE_LENGTH_LENGTH  4
  65 #define COMMON_HEADER_LENGTH   (VERSION_LENGTH + RESERVED_LENGTH + MESSAGE_CLASS_LENGTH + \
  66                                 MESSAGE_TYPE_LENGTH + MESSAGE_LENGTH_LENGTH)
  67
  68 #define VERSION_OFFSET         0
  69 #define RESERVED_OFFSET        (VERSION_OFFSET + VERSION_LENGTH)
  70 #define MESSAGE_CLASS_OFFSET   (RESERVED_OFFSET + RESERVED_LENGTH)
  71 #define MESSAGE_TYPE_OFFSET    (MESSAGE_CLASS_OFFSET + MESSAGE_CLASS_LENGTH)
  72 #define MESSAGE_LENGTH_OFFSET  (MESSAGE_TYPE_OFFSET + MESSAGE_TYPE_LENGTH)
  73
  74 #define PARAMETER_TAG_LENGTH    2
  75 #define PARAMETER_LENGTH_LENGTH 2
  76 #define PARAMETER_HEADER_LENGTH (PARAMETER_TAG_LENGTH + PARAMETER_LENGTH_LENGTH)
  77
  78 #define PARAMETER_TAG_OFFSET    0
  79 #define PARAMETER_LENGTH_OFFSET (PARAMETER_TAG_OFFSET + PARAMETER_TAG_LENGTH)
  80 #define PARAMETER_VALUE_OFFSET  (PARAMETER_LENGTH_OFFSET + PARAMETER_LENGTH_LENGTH)
  81 #define PARAMETER_HEADER_OFFSET PARAMETER_TAG_OFFSET
  82
  83 #define V6_NETWORK_APPEARANCE_PARAMETER_TAG            1
  84 #define V6_PROTOCOL_DATA_1_PARAMETER_TAG               2
  85 #define V6_PROTOCOL_DATA_2_PARAMETER_TAG               3
  86 #define V6_INFO_PARAMETER_TAG                          4
  87 #define V6_AFFECTED_DESTINATIONS_PARAMETER_TAG         5
  88 #define V6_ROUTING_CONTEXT_PARAMETER_TAG               6
  89 #define V6_DIAGNOSTIC_INFORMATION_PARAMETER_TAG        7
  90 #define V6_HEARTBEAT_DATA_PARAMETER_TAG                8
  91 #define V6_USER_CAUSE_PARAMETER_TAG                    9
  92 #define V6_REASON_PARAMETER_TAG                       10
  93 #define V6_TRAFFIC_MODE_TYPE_PARAMETER_TAG            11
  94 #define V6_ERROR_CODE_PARAMETER_TAG                   12
  95 #define V6_STATUS_PARAMETER_TAG                       13
  96 #define V6_CONGESTION_INDICATION_PARAMETER_TAG        14
  97 #define V6_CONCERNED_DESTINATION_PARAMETER_TAG        15
  98 #define V6_ROUTING_KEY_PARAMETER_TAG                  16
  99 #define V6_REGISTRATION_RESULT_PARAMETER_TAG          17
 100 #define V6_DEREGISTRATION_RESULT_PARAMETER_TAG        18
 101 #define V6_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG 19
 102 #define V6_DESTINATION_POINT_CODE_PARAMETER_TAG       20
 103 #define V6_SERVICE_INDICATORS_PARAMETER_TAG           21
 104 #define V6_SUBSYSTEM_NUMBERS_PARAMETER_TAG            22
 105 #define V6_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG  23
 106 #define V6_CIRCUIT_RANGE_PARAMETER_TAG                24
 107 #define V6_REGISTRATION_RESULTS_PARAMETER_TAG         25
 108 #define V6_DEREGISTRATION_RESULTS_PARAMETER_TAG       26
 109
 110 static const value_string m3ua_v6_parameter_tag_values[] = {
 111   { V6_NETWORK_APPEARANCE_PARAMETER_TAG,           "Network appearance" },
 112   { V6_PROTOCOL_DATA_1_PARAMETER_TAG,              "Protocol data 1" },
 113   { V6_PROTOCOL_DATA_2_PARAMETER_TAG,              "Protocol data 2" },
 114   { V6_INFO_PARAMETER_TAG,                         "Info" },
 115   { V6_AFFECTED_DESTINATIONS_PARAMETER_TAG,        "Affected destinations" },
 116   { V6_ROUTING_CONTEXT_PARAMETER_TAG,              "Routing context" },
 117   { V6_DIAGNOSTIC_INFORMATION_PARAMETER_TAG,       "Diagnostic information" },
 118   { V6_HEARTBEAT_DATA_PARAMETER_TAG,               "Heartbeat data" },
 119   { V6_USER_CAUSE_PARAMETER_TAG,                   "User / Cause" },
 120   { V6_REASON_PARAMETER_TAG,                       "Reason" },
 121   { V6_TRAFFIC_MODE_TYPE_PARAMETER_TAG,            "Traffic mode type" },
 122   { V6_ERROR_CODE_PARAMETER_TAG,                   "Error code" },
 123   { V6_STATUS_PARAMETER_TAG,                       "Status" },
 124   { V6_CONGESTION_INDICATION_PARAMETER_TAG,        "Congestion indication" },
 125   { V6_CONCERNED_DESTINATION_PARAMETER_TAG,        "Concerned destination" },
 126   { V6_ROUTING_KEY_PARAMETER_TAG,                  "Routing Key" },
 127   { V6_REGISTRATION_RESULT_PARAMETER_TAG,          "Registration result" },
 128   { V6_DEREGISTRATION_RESULT_PARAMETER_TAG,        "De-registration result" },
 129   { V6_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG, "Local routing key identifier" },
 130   { V6_DESTINATION_POINT_CODE_PARAMETER_TAG,       "Destination point code" },
 131   { V6_SERVICE_INDICATORS_PARAMETER_TAG,           "Service indicators" },
 132   { V6_SUBSYSTEM_NUMBERS_PARAMETER_TAG,            "Subsystem numbers" },
 133   { V6_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG,  "Originating point code list" },
 134   { V6_CIRCUIT_RANGE_PARAMETER_TAG,                "Circuit range" },
 135   { V6_REGISTRATION_RESULTS_PARAMETER_TAG,         "Registration results" },
 136   { V6_DEREGISTRATION_RESULTS_PARAMETER_TAG,       "De-registration results" },
 137   { 0,                           NULL } };
 138
 139 #define V12_INFO_STRING_PARAMETER_TAG                  0x0004
 140 #define V12_ROUTING_CONTEXT_PARAMETER_TAG              0x0006
 141 #define V12_DIAGNOSTIC_INFORMATION_PARAMETER_TAG       0x0007
 142 #define V12_HEARTBEAT_DATA_PARAMETER_TAG               0x0009
 143 #define V12_TRAFFIC_MODE_TYPE_PARAMETER_TAG            0x000b
 144 #define V12_ERROR_CODE_PARAMETER_TAG                   0x000c
 145 #define V12_STATUS_PARAMETER_TAG                       0x000d
 146 #define V12_ASP_IDENTIFIER_PARAMETER_TAG               0x0011
 147 #define V12_AFFECTED_POINT_CODE_PARAMETER_TAG          0x0012
 148 #define V12_CORRELATION_IDENTIFIER_PARAMETER_TAG       0x0013
 149
 150 #define V12_NETWORK_APPEARANCE_PARAMETER_TAG           0x0200
 151 #define V12_USER_CAUSE_PARAMETER_TAG                   0x0204
 152 #define V12_CONGESTION_INDICATIONS_PARAMETER_TAG       0x0205
 153 #define V12_CONCERNED_DESTINATION_PARAMETER_TAG        0x0206
 154 #define V12_ROUTING_KEY_PARAMETER_TAG                  0x0207
 155 #define V12_REGISTRATION_RESULT_PARAMETER_TAG          0x0208
 156 #define V12_DEREGISTRATION_RESULT_PARAMETER_TAG        0x0209
 157 #define V12_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG 0x020a
 158 #define V12_DESTINATION_POINT_CODE_PARAMETER_TAG       0x020b
 159 #define V12_SERVICE_INDICATORS_PARAMETER_TAG           0x020c
 160 #define V12_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG  0x020e
 161 #define V12_CIRCUIT_RANGE_PARAMETER_TAG                0x020f
 162 #define V12_PROTOCOL_DATA_PARAMETER_TAG                0x0210
 163 #define V12_REGISTRATION_STATUS_PARAMETER_TAG          0x0212
 164 #define V12_DEREGISTRATION_STATUS_PARAMETER_TAG        0x0213
 165
 166 static const value_string m3ua_v12_parameter_tag_values[] = {
 167   { V12_INFO_STRING_PARAMETER_TAG,                  "Info string" } ,
 168   { V12_ROUTING_CONTEXT_PARAMETER_TAG,              "Routing context" } ,
 169   { V12_DIAGNOSTIC_INFORMATION_PARAMETER_TAG,       "Diagnostic Information" } ,
 170   { V12_HEARTBEAT_DATA_PARAMETER_TAG,               "Heartbeat data" } ,
 171   { V12_TRAFFIC_MODE_TYPE_PARAMETER_TAG,            "Traffic mode type" } ,
 172   { V12_ERROR_CODE_PARAMETER_TAG,                   "Error code" } ,
 173   { V12_STATUS_PARAMETER_TAG,                       "Status" } ,
 174   { V12_ASP_IDENTIFIER_PARAMETER_TAG,               "ASP identifier" } ,
 175   { V12_AFFECTED_POINT_CODE_PARAMETER_TAG,          "Affected point code" } ,
 176   { V12_CORRELATION_IDENTIFIER_PARAMETER_TAG,       "Correlation identifier" } ,
 177   { V12_NETWORK_APPEARANCE_PARAMETER_TAG,           "Network appearance" } ,
 178   { V12_USER_CAUSE_PARAMETER_TAG,                   "User / cause" } ,
 179   { V12_CONGESTION_INDICATIONS_PARAMETER_TAG,       "Congestion indications" } ,
 180   { V12_CONCERNED_DESTINATION_PARAMETER_TAG,        "Concerned destination" } ,
 181   { V12_ROUTING_KEY_PARAMETER_TAG,                  "Routing key" } ,
 182   { V12_REGISTRATION_RESULT_PARAMETER_TAG,          "Registration result" } ,
 183   { V12_DEREGISTRATION_RESULT_PARAMETER_TAG,        "Deregistration result" } ,
 184   { V12_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG, "Local routing key identifier" } ,
 185   { V12_DESTINATION_POINT_CODE_PARAMETER_TAG,       "Destination point code" } ,
 186   { V12_SERVICE_INDICATORS_PARAMETER_TAG,           "Service indicators" } ,
 187   { V12_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG,  "Originating point code list" } ,
 188   { V12_CIRCUIT_RANGE_PARAMETER_TAG,                "Circuit range" } ,
 189   { V12_PROTOCOL_DATA_PARAMETER_TAG,                "Protocol data" } ,
 190   { V12_REGISTRATION_STATUS_PARAMETER_TAG,          "Registration status" } ,
 191   { V12_DEREGISTRATION_STATUS_PARAMETER_TAG,        "Deregistration status" } ,
 192   { 0,                           NULL } };
 193
 194 #define PROTOCOL_VERSION_RELEASE_1             1
 195
 196 static const value_string m3ua_protocol_version_values[] = {
 197   { PROTOCOL_VERSION_RELEASE_1,  "Release 1" },
 198   { 0,                           NULL } };
 199
 200 #define MESSAGE_CLASS_MGMT_MESSAGE        0
 201 #define MESSAGE_CLASS_TFER_MESSAGE        1
 202 #define MESSAGE_CLASS_SSNM_MESSAGE        2
 203 #define MESSAGE_CLASS_ASPSM_MESSAGE       3
 204 #define MESSAGE_CLASS_ASPTM_MESSAGE       4
 205 #define MESSAGE_CLASS_RKM_MESSAGE         9
 206
 207 static const value_string m3ua_message_class_values[] = {
 208   { MESSAGE_CLASS_MGMT_MESSAGE,   "Management messages" },
 209   { MESSAGE_CLASS_TFER_MESSAGE,   "Transfer messages" },
 210   { MESSAGE_CLASS_SSNM_MESSAGE,   "SS7 signalling network management messages" },
 211   { MESSAGE_CLASS_ASPSM_MESSAGE,  "ASP state maintenance messages" },
 212   { MESSAGE_CLASS_ASPTM_MESSAGE,  "ASP traffic maintenance messages" },
 213   { MESSAGE_CLASS_RKM_MESSAGE,    "Routing key management messages" },
 214   { 0,                           NULL } };
 215
 216 #define MESSAGE_TYPE_ERR                  0
 217 #define MESSAGE_TYPE_NTFY                 1
 218
 219 #define MESSAGE_TYPE_DATA                 1
 220
 221 #define MESSAGE_TYPE_DUNA                 1
 222 #define MESSAGE_TYPE_DAVA                 2
 223 #define MESSAGE_TYPE_DAUD                 3
 224 #define MESSAGE_TYPE_SCON                 4
 225 #define MESSAGE_TYPE_DUPU                 5
 226 #define MESSAGE_TYPE_DRST                 6
 227
 228 #define MESSAGE_TYPE_UP                   1
 229 #define MESSAGE_TYPE_DOWN                 2
 230 #define MESSAGE_TYPE_BEAT                 3
 231 #define MESSAGE_TYPE_UP_ACK               4
 232 #define MESSAGE_TYPE_DOWN_ACK             5
 233 #define MESSAGE_TYPE_BEAT_ACK             6
 234
 235 #define MESSAGE_TYPE_ACTIVE               1
 236 #define MESSAGE_TYPE_INACTIVE             2
 237 #define MESSAGE_TYPE_ACTIVE_ACK           3
 238 #define MESSAGE_TYPE_INACTIVE_ACK         4
 239
 240 #define MESSAGE_TYPE_REG_REQ              1
 241 #define MESSAGE_TYPE_REG_RSP              2
 242 #define MESSAGE_TYPE_DEREG_REQ            3
 243 #define MESSAGE_TYPE_DEREG_RSP            4
 244
 245
 246 static const value_string m3ua_message_class_type_values[] = {
 247   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,           "Error (ERR)" },
 248   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,          "Notify (NTFY)" },
 249   { MESSAGE_CLASS_TFER_MESSAGE  * 256 + MESSAGE_TYPE_DATA,          "Payload data (DATA)" },
 250   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUNA,          "Destination unavailable (DUNA)" },
 251   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAVA,          "Destination available (DAVA)" },
 252   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAUD,          "Destination state audit (DAUD)" },
 253   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_SCON,          "SS7 Network congestion state (SCON)" },
 254   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUPU,          "Destination userpart unavailable (DUPU)" },
 255   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DRST,          "Destination Restricted (DRST)" },
 256   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,            "ASP up (UP)" },
 257   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,          "ASP down (DOWN)" },
 258   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,          "Heartbeat (BEAT)" },
 259   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,        "ASP up ack (UP ACK)" },
 260   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,      "ASP down ack (DOWN ACK)" },
 261   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,      "Heartbeat ack (BEAT ACK)" },
 262   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,       "ASP active (ACTIVE)" },
 263   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,     "ASP inactive (INACTIVE)" },
 264   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,   "ASP active ack (ACTIVE ACK)" },
 265   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK , "ASP inactive ack (INACTIVE ACK)" },
 266   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_REG_REQ ,      "Registration request (REG_REQ)" },
 267   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_REG_RSP ,      "Registration response (REG_RSP)" },
 268   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_REQ ,    "Deregistration request (DEREG_REQ)" },
 269   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_RSP ,    "Deregistration response (DEREG_RSP)" },
 270   { 0,                           NULL } };
 271
 272 static const value_string m3ua_message_class_type_acro_values[] = {
 273   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,           "ERR" },
 274   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,          "NTFY" },
 275   { MESSAGE_CLASS_TFER_MESSAGE  * 256 + MESSAGE_TYPE_DATA,          "DATA" },
 276   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUNA,          "DUNA" },
 277   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAVA,          "DAVA" },
 278   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAUD,          "DAUD" },
 279   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_SCON,          "SCON" },
 280   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUPU,          "DUPU" },
 281   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DRST,          "DRST" },
 282   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,            "ASP_UP" },
 283   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,          "ASP_DOWN" },
 284   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,          "BEAT" },
 285   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,        "ASP_UP_ACK" },
 286   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,      "ASP_DOWN_ACK" },
 287   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,      "BEAT_ACK" },
 288   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,       "ASP_ACTIVE" },
 289   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,     "ASP_INACTIVE" },
 290   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,   "ASP_ACTIVE_ACK" },
 291   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK , "ASP_INACTIVE_ACK" },
 292   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_REG_REQ ,      "REG_REQ" },
 293   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_REG_RSP ,      "REG_RSP" },
 294   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_REQ ,    "DEREG_REQ" },
 295   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_RSP ,    "DEREG_RSP" },
 296   { 0,                           NULL } };
 297
 298
 299
 300
 301
 302 #define PROTOCOL_DATA_OFFSET PARAMETER_VALUE_OFFSET
 303
 304
 305 #define UNSPECIFIED_REASON          0
 306 #define USER_UNAVAILABLE_REASON     1
 307 #define MANAGEMENT_BLOCKING_REASON  2
 308
 309 static const value_string m3ua_reason_values[] = {
 310   { UNSPECIFIED_REASON,                             "Unspecified" },
 311   { USER_UNAVAILABLE_REASON,                        "User unavailable" },
 312   { MANAGEMENT_BLOCKING_REASON,                     "Management blocking" },
 313   {0,                           NULL } };
 314
 315 #define REASON_LENGTH 4
 316 #define REASON_OFFSET PARAMETER_VALUE_OFFSET
 317
 318 #define TRAFFIC_MODE_TYPE_LENGTH 4
 319 #define TRAFFIC_MODE_TYPE_OFFSET PARAMETER_VALUE_OFFSET
 320
 321 /* Initialize the protocol and registered fields */
 322 static int proto_m3ua = -1;
 323 static int hf_m3ua_version = -1;
 324 static int hf_m3ua_reserved = -1;
 325 static int hf_m3ua_message_class = -1;
 326 static int hf_m3ua_message_type = -1;
 327 static int hf_m3ua_message_length = -1;
 328 static int hf_m3ua_parameter_tag = -1;
 329 static int hf_m3ua_parameter_length = -1;
 330 static int hf_m3ua_parameter_value = -1;
 331 static int hf_m3ua_parameter_padding = -1;
 332 static int hf_m3ua_network_appearance = -1;
 333 static int hf_m3ua_info_string = -1;
 334 static int hf_m3ua_routing_context = -1;
 335 static int hf_m3ua_diagnostic_information = -1;
 336 static int hf_m3ua_heartbeat_data = -1;
 337 static int hf_m3ua_error_code = -1;
 338 static int hf_m3ua_status_type = -1;
 339 static int hf_m3ua_status_info = -1;
 340 static int hf_m3ua_asp_identifier = -1;
 341 static int hf_m3ua_affected_point_code_mask = -1;
 342 static int hf_m3ua_affected_point_code_pc = -1;
 343 static int hf_m3ua_unavailability_cause = -1;
 344 static int hf_m3ua_user_identity = -1;
 345 static int hf_m3ua_reason = -1;
 346 static int hf_m3ua_traffic_mode_type = -1;
 347 static int hf_m3ua_congestion_reserved = -1;
 348 static int hf_m3ua_congestion_level = -1;
 349 static int hf_m3ua_concerned_dest_reserved = -1;
 350 static int hf_m3ua_concerned_dest_pc = -1;
 351 static int hf_m3ua_local_rk_identifier = -1;
 352 static int hf_m3ua_dpc_mask = -1;
 353 static int hf_m3ua_dpc_pc = -1;
 354 static int hf_m3ua_si = -1;
 355 static int hf_m3ua_ssn = -1;
 356 static int hf_m3ua_opc_list_mask = -1;
 357 static int hf_m3ua_opc_list_pc = -1;
 358 static int hf_m3ua_cic_range_mask = -1;
 359 static int hf_m3ua_cic_range_pc = -1;
 360 static int hf_m3ua_cic_range_upper = -1;
 361 static int hf_m3ua_cic_range_lower = -1;
 362 static int hf_m3ua_protocol_data_opc = -1;
 363 static int hf_m3ua_protocol_data_dpc = -1;
 364 static int hf_m3ua_protocol_data_si = -1;
 365 static int hf_m3ua_protocol_data_ni = -1;
 366 static int hf_m3ua_protocol_data_mp = -1;
 367 static int hf_m3ua_protocol_data_sls = -1;
 368 static int hf_m3ua_correlation_identifier = -1;
 369 static int hf_m3ua_registration_status = -1;
 370 static int hf_m3ua_deregistration_status = -1;
 371 static int hf_m3ua_registration_result_identifier = -1;
 372 static int hf_m3ua_registration_result_status = -1;
 373 static int hf_m3ua_registration_result_context = -1;
 374 static int hf_m3ua_deregistration_result_status = -1;
 375 static int hf_m3ua_deregistration_result_context = -1;
 376 static int hf_m3ua_li = -1;
 377
 378 /* Initialize the subtree pointers */
 379 static gint ett_m3ua = -1;
 380 static gint ett_m3ua_parameter = -1;
 381
 382 static module_t *m3ua_module;
 383 static dissector_handle_t mtp3_handle, data_handle;
 384 static dissector_table_t m3ua_si_dissector_table;
 385
 386 /* stuff for supporting multiple versions */
 387 #define M3UA_V6            1
 388 #define M3UA_V12           2
 389 static gint m3ua_version = M3UA_V12;
 390
 391 static void
 392 dissect_m3ua_parameters(tvbuff_t *, packet_info *, proto_tree *, proto_tree *);
 393
 394 static guint
 395 nr_of_padding_bytes (guint length)
 396 {
 397   guint remainder;
 398
 399   remainder = length % 4;
 400
 401   if (remainder == 0)
 402     return 0;
 403   else
 404     return 4 - remainder;
 405 }
 406
 407 static void
 408 dissect_m3ua_common_header(tvbuff_t *common_header_tvb, packet_info *pinfo, proto_tree *m3ua_tree)
 409 {
 410   guint8  version, reserved, message_class, message_type;
 411   guint32 message_length;
 412
 413   /* Extract the common header */
 414   version        = tvb_get_guint8(common_header_tvb, VERSION_OFFSET);
 415   reserved       = tvb_get_guint8(common_header_tvb, RESERVED_OFFSET);
 416   message_class  = tvb_get_guint8(common_header_tvb, MESSAGE_CLASS_OFFSET);
 417   message_type   = tvb_get_guint8(common_header_tvb, MESSAGE_TYPE_OFFSET);
 418   message_length = tvb_get_ntohl (common_header_tvb, MESSAGE_LENGTH_OFFSET);
 419
 420   if (check_col(pinfo->cinfo, COL_INFO)) {
 421     col_append_str(pinfo->cinfo, COL_INFO, val_to_str(message_class * 256 + message_type, m3ua_message_class_type_acro_values, "reserved"));
 422     col_append_str(pinfo->cinfo, COL_INFO, " ");
 423   }
 424
 425   if (m3ua_tree) {
 426     /* add the components of the common header to the protocol tree */
 427     proto_tree_add_uint(m3ua_tree, hf_m3ua_version, common_header_tvb, VERSION_OFFSET, VERSION_LENGTH, version);
 428     proto_tree_add_uint(m3ua_tree, hf_m3ua_reserved, common_header_tvb, RESERVED_OFFSET, RESERVED_LENGTH, reserved);
 429     proto_tree_add_uint(m3ua_tree, hf_m3ua_message_class, common_header_tvb, MESSAGE_CLASS_OFFSET, MESSAGE_CLASS_LENGTH, message_class);
 430     proto_tree_add_uint_format(m3ua_tree, hf_m3ua_message_type, common_header_tvb, MESSAGE_TYPE_OFFSET, MESSAGE_TYPE_LENGTH, message_type,
 431                                "Message type: %s (%u)",
 432                                val_to_str(message_class * 256 + message_type, m3ua_message_class_type_values, "reserved"), message_type);
 433     proto_tree_add_uint(m3ua_tree, hf_m3ua_message_length, common_header_tvb, MESSAGE_LENGTH_OFFSET, MESSAGE_LENGTH_LENGTH, message_length);
 434   }
 435 }
 436
 437 #define INFO_STRING_OFFSET PARAMETER_VALUE_OFFSET
 438
 439 static void
 440 dissect_m3ua_info_string_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 441 {
 442   guint16 length, info_string_length;
 443   char *info_string;
 444
 445   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 446
 447   info_string_length = length - PARAMETER_HEADER_LENGTH;
 448   info_string = (char *)tvb_get_ptr(parameter_tvb, INFO_STRING_OFFSET, info_string_length);
 449   proto_tree_add_string(parameter_tree, hf_m3ua_info_string, parameter_tvb, INFO_STRING_OFFSET, info_string_length, info_string);
 450   proto_item_set_text(parameter_item, "Info String (%.*s)", info_string_length, info_string);
 451 }
 452
 453 #define ROUTING_CONTEXT_LENGTH 4
 454
 455 static void
 456 dissect_m3ua_routing_context_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 457 {
 458   guint16 length, number_of_contexts, context_number;
 459   guint32 context;
 460   gint context_offset;
 461
 462   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 463   number_of_contexts = (length - PARAMETER_HEADER_LENGTH) / 4;
 464   context_offset = PARAMETER_VALUE_OFFSET;
 465   for(context_number=1; context_number <= number_of_contexts; context_number++) {
 466     context = tvb_get_ntohl(parameter_tvb, context_offset);
 467     proto_tree_add_uint(parameter_tree, hf_m3ua_routing_context, parameter_tvb, context_offset, ROUTING_CONTEXT_LENGTH, context);
 468     context_offset += ROUTING_CONTEXT_LENGTH;
 469   }
 470   proto_item_set_text(parameter_item, "Routing context parameter (%u context%s)", number_of_contexts, plurality(number_of_contexts, "", "s"));
 471 }
 472
 473 static void
 474 dissect_m3ua_diagnostic_information_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 475 {
 476   guint16 length, diagnostic_info_length;
 477
 478   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 479   diagnostic_info_length = length - PARAMETER_HEADER_LENGTH;
 480
 481   proto_tree_add_bytes(parameter_tree, hf_m3ua_diagnostic_information, parameter_tvb, PARAMETER_VALUE_OFFSET, diagnostic_info_length,
 482                                    tvb_get_ptr(parameter_tvb, PARAMETER_VALUE_OFFSET, diagnostic_info_length));
 483
 484   proto_item_set_text(parameter_item, "Diagnostic information (%u byte%s)", diagnostic_info_length, plurality(diagnostic_info_length, "", "s"));
 485 }
 486
 487 static void
 488 dissect_m3ua_heartbeat_data_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 489 {
 490   guint16 length, heartbeat_data_length;
 491
 492   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 493
 494   heartbeat_data_length = length - PARAMETER_HEADER_LENGTH;
 495
 496   proto_tree_add_bytes(parameter_tree, hf_m3ua_heartbeat_data, parameter_tvb, PARAMETER_VALUE_OFFSET, heartbeat_data_length,
 497                                    tvb_get_ptr(parameter_tvb, PARAMETER_VALUE_OFFSET, heartbeat_data_length));
 498
 499   proto_item_set_text(parameter_item, "Heartbeat data (%u byte%s)", heartbeat_data_length, plurality(heartbeat_data_length, "", "s"));
 500 }
 501
 502 #define OVER_RIDE_TYPE           1
 503 #define LOAD_SHARE_TYPE          2
 504 #define OVER_RIDE_STANDBY_TYPE   3
 505 #define LOAD_SHARE_STANDBY_TYPE  4
 506
 507 static const value_string m3ua_v6_traffic_mode_type_values[] = {
 508   { OVER_RIDE_TYPE ,                             "Over-ride" },
 509   { LOAD_SHARE_TYPE,                             "Load-share" },
 510   { OVER_RIDE_STANDBY_TYPE,                      "Over-ride (standby)" },
 511   { LOAD_SHARE_STANDBY_TYPE,                     "Load-share (standby)" },
 512   {0,                           NULL } };
 513
 514 static void
 515 dissect_m3ua_v6_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 516 {
 517   guint32 traffic_mode_type;
 518
 519   traffic_mode_type = tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET);
 520
 521   proto_tree_add_uint_format(parameter_tree, hf_m3ua_traffic_mode_type, parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH, traffic_mode_type,
 522                              "Traffic mode type: %u (%s)", traffic_mode_type, val_to_str(traffic_mode_type, m3ua_v6_traffic_mode_type_values, "unknown"));
 523   proto_item_set_text(parameter_item, "Traffic mode type parameter (%s)", val_to_str(traffic_mode_type, m3ua_v6_traffic_mode_type_values, "unknown"));
 524 }
 525
 526 #define BROADCAST_TYPE   3
 527
 528 static const value_string m3ua_v12_traffic_mode_type_values[] = {
 529   { OVER_RIDE_TYPE ,                             "Over-ride" },
 530   { LOAD_SHARE_TYPE,                             "Load-share" },
 531   { BROADCAST_TYPE,                              "Broadcast" },
 532   {0,                           NULL } };
 533
 534 static void
 535 dissect_m3ua_v12_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 536 {
 537   guint32 traffic_mode_type;
 538
 539   traffic_mode_type = tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET);
 540
 541   proto_tree_add_uint_format(parameter_tree, hf_m3ua_traffic_mode_type,
 542                                                parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH,
 543                                                traffic_mode_type, "Traffic mode type: %u (%s)",
 544                                                traffic_mode_type, val_to_str(traffic_mode_type, m3ua_v12_traffic_mode_type_values, "unknown"));
 545   proto_item_set_text(parameter_item, "Traffic mode type parameter (%s)", val_to_str(traffic_mode_type, m3ua_v12_traffic_mode_type_values, "unknown"));
 546 }
 547
 548 #define V6_INVALID_VERSION_ERROR_CODE               1
 549 #define V6_INVALID_NETWORK_APPEARANCE_ERROR_CODE    2
 550 #define V6_UNSUPPORTED_MESSAGE_CLASS_ERROR_CODE     3
 551 #define V6_UNSUPPORTED_MESSAGE_TYPE_ERROR_CODE      4
 552 #define V6_INVALID_TRAFFIC_HANDLING_MODE_ERROR_CODE 5
 553 #define V6_UNEXPECTED_MESSAGE_ERROR_CODE            6
 554 #define V6_PROTOCOL_ERROR_ERROR_CODE                7
 555 #define V6_INVALID_ROUTING_CONTEXT_ERROR_CODE       8
 556 #define V6_INVALID_STREAM_IDENTIFIER_ERROR_CODE     9
 557 #define V6_INVALID_PARAMETER_VALUE_ERROR_CODE      10
 558
 559 static const value_string m3ua_v6_error_code_values[] = {
 560   { V6_INVALID_VERSION_ERROR_CODE,               "Invalid version" },
 561   { V6_INVALID_NETWORK_APPEARANCE_ERROR_CODE,    "Invalid network appearance" },
 562   { V6_UNSUPPORTED_MESSAGE_CLASS_ERROR_CODE,     "Unsupported message class" },
 563   { V6_UNSUPPORTED_MESSAGE_TYPE_ERROR_CODE,      "Unsupported message type" },
 564   { V6_INVALID_TRAFFIC_HANDLING_MODE_ERROR_CODE, "Invalid traffic handling mode" },
 565   { V6_UNEXPECTED_MESSAGE_ERROR_CODE,            "Unexpected message" },
 566   { V6_PROTOCOL_ERROR_ERROR_CODE,                "Protocol error" },
 567   { V6_INVALID_ROUTING_CONTEXT_ERROR_CODE,       "Invalid routing context" },
 568   { V6_INVALID_STREAM_IDENTIFIER_ERROR_CODE,     "Invalid stream identifier" },
 569   { V6_INVALID_PARAMETER_VALUE_ERROR_CODE,       "Invalid parameter value" },
 570   { 0,                           NULL } };
 571
 572 #define ERROR_CODE_LENGTH 4
 573 #define ERROR_CODE_OFFSET PARAMETER_VALUE_OFFSET
 574
 575 static void
 576 dissect_m3ua_v6_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 577 {
 578   guint32 error_code;
 579
 580   error_code = tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET);
 581   proto_tree_add_uint_format(parameter_tree, hf_m3ua_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, error_code,
 582                              "Error code: %u (%s)", error_code, val_to_str(error_code, m3ua_v6_error_code_values, "unknown"));
 583   proto_item_set_text(parameter_item, "Error code parameter (%s)", val_to_str(error_code, m3ua_v6_error_code_values, "unknown"));
 584 }
 585
 586
 587 #define V12_INVALID_VERSION_ERROR_CODE                   0x01
 588 #define V12_UNSUPPORTED_MESSAGE_CLASS_ERROR_CODE         0x03
 589 #define V12_UNSUPPORTED_MESSAGE_TYPE_ERROR_CODE          0x04
 590 #define V12_UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR_CODE 0x05
 591 #define V12_UNEXPECTED_MESSAGE_ERROR_CODE                0x06
 592 #define V12_PROTOCOL_ERROR_ERROR_CODE                    0x07
 593 #define V12_INVALID_STREAM_IDENTIFIER_ERROR_CODE         0x09
 594 #define V12_REFUSED_ERROR_CODE                           0x0d
 595 #define V12_ASP_IDENTIFIER_REQUIRED_ERROR_CODE           0x0e
 596 #define V12_INVALID_ASP_IDENTIFIER_ERROR_CODE            0x0f
 597 #define V12_INVALID_PARAMETER_VALUE_ERROR_CODE           0x11
 598 #define V12_PARAMETER_FIELD_ERROR_CODE                   0x12
 599 #define V12_UNEXPECTED_PARAMETER_ERROR_CODE              0x13
 600 #define V12_DESTINATION_STATUS_UNKNOWN_ERROR_CODE        0x14
 601 #define V12_INVALID_NETWORK_APPEARANCE_ERROR_CODE        0x15
 602 #define V12_MISSING_PARAMETER_ERROR_CODE                 0x16
 603 #define V12_INVALID_ROUTING_CONTEXT_ERROR_CODE           0x19
 604 #define V12_NO_CONFIGURED_AS_FOR_ASP_ERROR_CODE          0x1a
 605
 606 static const value_string m3ua_v12_error_code_values[] = {
 607   { V12_INVALID_VERSION_ERROR_CODE,                   "Invalid version" },
 608   { V12_UNSUPPORTED_MESSAGE_CLASS_ERROR_CODE,         "Unsupported message class" },
 609   { V12_UNSUPPORTED_MESSAGE_TYPE_ERROR_CODE,          "Unsupported message type" },
 610   { V12_UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR_CODE, "Unsupported traffic handling mode" },
 611   { V12_UNEXPECTED_MESSAGE_ERROR_CODE,                "Unexpected message" },
 612   { V12_PROTOCOL_ERROR_ERROR_CODE,                    "Protocol error" },
 613   { V12_INVALID_STREAM_IDENTIFIER_ERROR_CODE,         "Invalid stream identifier" },
 614   { V12_REFUSED_ERROR_CODE,                           "Refused - management blocking" },
 615   { V12_ASP_IDENTIFIER_REQUIRED_ERROR_CODE,           "ASP identifier required" },
 616   { V12_INVALID_ASP_IDENTIFIER_ERROR_CODE,            "Invalid ASP identifier" },
 617   { V12_INVALID_PARAMETER_VALUE_ERROR_CODE,           "Invalid parameter value" },
 618   { V12_PARAMETER_FIELD_ERROR_CODE,                   "Parameter field error" },
 619   { V12_UNEXPECTED_PARAMETER_ERROR_CODE,              "Unexpected parameter" },
 620   { V12_DESTINATION_STATUS_UNKNOWN_ERROR_CODE,        "Destination status unknown" },
 621   { V12_INVALID_NETWORK_APPEARANCE_ERROR_CODE,        "Invalid network appearance" },
 622   { V12_MISSING_PARAMETER_ERROR_CODE,                 "Missing parameter" },
 623   { V12_INVALID_ROUTING_CONTEXT_ERROR_CODE,           "Invalid routing context" },
 624   { V12_NO_CONFIGURED_AS_FOR_ASP_ERROR_CODE,          "No configured AS for ASP" },
 625   { 0,                                            NULL } };
 626
 627 static void
 628 dissect_m3ua_v12_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 629 {
 630   guint32 error_code;
 631
 632   error_code = tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET);
 633   proto_tree_add_uint_format(parameter_tree, hf_m3ua_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, error_code,
 634                              "Error code: %u (%s)",error_code, val_to_str(error_code, m3ua_v12_error_code_values, "unknown"));
 635   proto_item_set_text(parameter_item, "Error code parameter (%s)", val_to_str(error_code, m3ua_v12_error_code_values, "unknown"));
 636 }
 637
 638 #define AS_STATE_CHANGE_TYPE       1
 639 #define OTHER_TYPE                 2
 640
 641 static const value_string m3ua_status_type_values[] = {
 642   { AS_STATE_CHANGE_TYPE,            "Application server state change" },
 643   { OTHER_TYPE,                      "Other" },
 644   { 0,                           NULL } };
 645
 646 #define RESERVED_INFO              1
 647 #define AS_INACTIVE_INFO           2
 648 #define AS_ACTIVE_INFO             3
 649 #define AS_PENDING_INFO            4
 650
 651 #define INSUFFICIENT_ASP_RES_INFO  1
 652 #define ALTERNATE_ASP_ACTIVE_INFO  2
 653 #define ASP_FAILURE_INFO           3
 654
 655 static const value_string m3ua_status_type_info_values[] = {
 656   { AS_STATE_CHANGE_TYPE * 256 * 256 + RESERVED_INFO,             "Reserved" },
 657   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_INACTIVE_INFO,          "Application server inactive" },
 658   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_ACTIVE_INFO,            "Application server active" },
 659   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_PENDING_INFO,           "Application server pending" },
 660   { OTHER_TYPE           * 256 * 256 + INSUFFICIENT_ASP_RES_INFO, "Insufficient ASP resources active in AS" },
 661   { OTHER_TYPE           * 256 * 256 + ALTERNATE_ASP_ACTIVE_INFO, "Alternate ASP active" },
 662   { OTHER_TYPE           * 256 * 256 + ASP_FAILURE_INFO,          "ASP Failure" },
 663   {0,                           NULL } };
 664
 665 #define STATUS_TYPE_LENGTH 2
 666 #define STATUS_INFO_LENGTH 2
 667
 668 #define STATUS_TYPE_OFFSET PARAMETER_VALUE_OFFSET
 669 #define STATUS_INFO_OFFSET (STATUS_TYPE_OFFSET + STATUS_TYPE_LENGTH)
 670
 671 static void
 672 dissect_m3ua_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 673 {
 674   guint16 status_type, status_info;
 675
 676   status_type = tvb_get_ntohs(parameter_tvb, STATUS_TYPE_OFFSET);
 677   status_info = tvb_get_ntohs(parameter_tvb, STATUS_INFO_OFFSET);
 678
 679   proto_tree_add_uint(parameter_tree, hf_m3ua_status_type, parameter_tvb, STATUS_TYPE_OFFSET, STATUS_TYPE_LENGTH, status_type);
 680   proto_tree_add_uint_format(parameter_tree, hf_m3ua_status_info, parameter_tvb, STATUS_INFO_OFFSET, STATUS_INFO_LENGTH, status_info,
 681                              "Status info: %s (%u)", val_to_str(status_type * 256 * 256 + status_info, m3ua_status_type_info_values, "unknown"), status_info);
 682
 683   proto_item_set_text(parameter_item,
 684                       "Status type / ID (%s)", val_to_str(status_type * 256 * 256 + status_info, m3ua_status_type_info_values, "unknown status information"));
 685 }
 686
 687 #define ASP_IDENTIFIER_OFFSET PARAMETER_VALUE_OFFSET
 688 #define ASP_IDENTIFIER_LENGTH  4
 689
 690 static void
 691 dissect_m3ua_asp_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 692 {
 693   guint32 identifier;
 694
 695   identifier = tvb_get_ntohl(parameter_tvb, ASP_IDENTIFIER_OFFSET);
 696   proto_tree_add_uint(parameter_tree, hf_m3ua_asp_identifier, parameter_tvb, ASP_IDENTIFIER_OFFSET, ASP_IDENTIFIER_LENGTH, identifier);
 697   proto_item_set_text(parameter_item, "ASP identifier (%u)", identifier);
 698 }
 699
 700 #define AFFECTED_MASK_LENGTH       1
 701 #define AFFECTED_PC_LENGTH         3
 702 #define AFFECTED_POINT_CODE_LENGTH (AFFECTED_MASK_LENGTH + AFFECTED_PC_LENGTH)
 703
 704 #define AFFECTED_MASK_OFFSET        0
 705 #define AFFECTED_PC_OFFSET         (AFFECTED_MASK_OFFSET + AFFECTED_MASK_LENGTH)
 706
 707 static void
 708 dissect_m3ua_affected_point_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 709 {
 710   guint8  mask;
 711   guint16 length, number_of_point_codes, point_code_number;
 712   guint32 pc;
 713   gint point_code_offset;
 714
 715   length                = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 716   number_of_point_codes = (length - PARAMETER_HEADER_LENGTH) / AFFECTED_POINT_CODE_LENGTH;
 717
 718   point_code_offset = PARAMETER_VALUE_OFFSET;
 719   for(point_code_number=1; point_code_number <= number_of_point_codes; point_code_number++) {
 720     mask = tvb_get_guint8(parameter_tvb, point_code_offset + AFFECTED_MASK_OFFSET);
 721     pc   = tvb_get_ntoh24(parameter_tvb, point_code_offset + AFFECTED_PC_OFFSET);
 722     proto_tree_add_uint(parameter_tree, hf_m3ua_affected_point_code_mask, parameter_tvb, point_code_offset + AFFECTED_MASK_OFFSET, AFFECTED_MASK_LENGTH, mask);
 723     proto_tree_add_uint(parameter_tree, hf_m3ua_affected_point_code_pc, parameter_tvb, point_code_offset + AFFECTED_PC_OFFSET, AFFECTED_PC_LENGTH, pc);
 724     point_code_offset += AFFECTED_POINT_CODE_LENGTH;
 725   };
 726   proto_item_set_text(parameter_item, "Affected point code parameter (%u point code%s)", number_of_point_codes, plurality(number_of_point_codes, "", "s"));
 727
 728 }
 729
 730 #define NETWORK_APPEARANCE_LENGTH 4
 731 #define NETWORK_APPEARANCE_OFFSET PARAMETER_VALUE_OFFSET
 732
 733 static void
 734 dissect_m3ua_network_appearance_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 735 {
 736   guint32 network_appearance;
 737
 738   network_appearance = tvb_get_ntohl(parameter_tvb, NETWORK_APPEARANCE_OFFSET);
 739   proto_tree_add_uint(parameter_tree, hf_m3ua_network_appearance, parameter_tvb, NETWORK_APPEARANCE_OFFSET, NETWORK_APPEARANCE_LENGTH, network_appearance);
 740   proto_item_set_text(parameter_item, "Network appearance: %u", network_appearance);
 741 }
 742
 743 #define UNKNOWN_UNAVAIL_CAUSE                  0
 744 #define UNEQUIPPED_REMOTE_USER_UNAVAIL_CAUSE   1
 745 #define INACCESSABLE_REMOTE_USER_UNAVAIL_CAUSE 2
 746
 747 static const value_string m3ua_unavailability_cause_values[] = {
 748   { UNKNOWN_UNAVAIL_CAUSE,                             "Unknown" },
 749   { UNEQUIPPED_REMOTE_USER_UNAVAIL_CAUSE,              "Unequipped remote user" },
 750   { INACCESSABLE_REMOTE_USER_UNAVAIL_CAUSE,            "Inaccessable remote user" },
 751   {0,                           NULL } };
 752
 753 #define RESERVED_0_USER_ID                0
 754 #define RESERVED_1_USER_ID                1
 755 #define RESERVED_2_USER_ID                2
 756 #define SCCP_USER_ID                      3
 757 #define TUP_USER_ID                       4
 758 #define ISUP_USER_ID                      5
 759 #define RESERVED_6_USER_ID                6
 760 #define RESERVED_7_USER_ID                7
 761 #define RESERVED_8_USER_ID                8
 762 #define BROADBAND_ISUP_USER_ID            9
 763 #define SATELLITE_ISUP_USER_ID           10
 764
 765 static const value_string m3ua_user_identity_values[] = {
 766   { RESERVED_0_USER_ID,                             "Reserved" },
 767   { RESERVED_1_USER_ID,                             "Reserved" },
 768   { RESERVED_2_USER_ID,                             "Reserved" },
 769   { SCCP_USER_ID,                                   "SCCP" },
 770   { TUP_USER_ID,                                    "TUP" },
 771   { ISUP_USER_ID,                                   "ISUP" },
 772   { RESERVED_6_USER_ID,                             "Reserved" },
 773   { RESERVED_7_USER_ID,                             "Reserved" },
 774   { RESERVED_8_USER_ID,                             "Reserved" },
 775   { BROADBAND_ISUP_USER_ID,                         "Broadband ISUP" },
 776   { SATELLITE_ISUP_USER_ID,                         "Satellite ISUP" },
 777   {0,                           NULL } };
 778
 779 #define CAUSE_LENGTH 2
 780 #define USER_LENGTH  2
 781
 782 #define CAUSE_OFFSET  PARAMETER_VALUE_OFFSET
 783 #define USER_OFFSET   (CAUSE_OFFSET + CAUSE_LENGTH)
 784
 785 static void
 786 dissect_m3ua_user_cause_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 787 {
 788   guint16 cause, user;
 789
 790   cause = tvb_get_ntohs(parameter_tvb, CAUSE_OFFSET);
 791   user  = tvb_get_ntohs(parameter_tvb, USER_OFFSET);
 792
 793   proto_tree_add_uint(parameter_tree, hf_m3ua_unavailability_cause, parameter_tvb, CAUSE_OFFSET, CAUSE_LENGTH, cause);
 794   proto_tree_add_uint(parameter_tree, hf_m3ua_user_identity, parameter_tvb, USER_OFFSET, USER_LENGTH, user);
 795   proto_item_set_text(parameter_item, "User / Cause parameter (%s: %s)",
 796                                   val_to_str(user, m3ua_user_identity_values, "Unknown user"),
 797                       val_to_str(cause, m3ua_unavailability_cause_values, "unknown cause"));
 798 }
 799
 800 static void
 801 dissect_m3ua_protocol_data_1_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_item *parameter_item)
 802 {
 803   guint16 length, protocol_data_length;
 804   tvbuff_t *payload_tvb;
 805
 806   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 807   protocol_data_length = length - PARAMETER_HEADER_LENGTH;
 808   payload_tvb          = tvb_new_subset(parameter_tvb, PROTOCOL_DATA_OFFSET, protocol_data_length, protocol_data_length);
 809   proto_item_set_text(parameter_item, "Protocol data (SS7 message of %u byte%s)", protocol_data_length, plurality(protocol_data_length, "", "s"));
 810   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH);
 811   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
 812
 813 }
 814
 815 #define LI_OCTETT_LENGTH 1
 816 #define LI_OCTETT_OFFSET PARAMETER_VALUE_OFFSET
 817
 818 static void
 819 dissect_m3ua_protocol_data_2_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 820 {
 821   guint8 li;
 822   guint16 length, protocol_data_length;
 823   tvbuff_t *payload_tvb;
 824
 825   length               = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 826   li                   = tvb_get_guint8(parameter_tvb, LI_OCTETT_OFFSET);
 827   protocol_data_length = length - PARAMETER_HEADER_LENGTH - LI_OCTETT_LENGTH;
 828   payload_tvb          = tvb_new_subset(parameter_tvb, PROTOCOL_DATA_OFFSET + LI_OCTETT_LENGTH, protocol_data_length, protocol_data_length);
 829   proto_tree_add_uint(parameter_tree, hf_m3ua_li, parameter_tvb, LI_OCTETT_OFFSET, LI_OCTETT_LENGTH, li);
 830   proto_item_set_text(parameter_item, "Protocol data (SS7 message of %u byte%s)", protocol_data_length, plurality(protocol_data_length, "", "s"));
 831   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH + LI_OCTETT_LENGTH);
 832   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
 833 }
 834
 835 static void
 836 dissect_m3ua_reason_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 837 {
 838   guint32 reason;
 839
 840   reason = tvb_get_ntohl(parameter_tvb, REASON_OFFSET);
 841
 842   proto_tree_add_uint(parameter_tree, hf_m3ua_reason, parameter_tvb, REASON_OFFSET, REASON_LENGTH, reason);
 843   proto_item_set_text(parameter_item, "Reason parameter (%s)", val_to_str(reason, m3ua_reason_values, "unknown"));
 844 }
 845
 846 #define NO_CONGESTION_LEVEL         0
 847 #define CONGESTION_LEVEL_1_LEVEL    1
 848 #define CONGESTION_LEVEL_2_LEVEL    2
 849 #define CONGESTION_LEVEL_3_LEVEL    3
 850
 851 static const value_string m3ua_congestion_level_values[] = {
 852   { NO_CONGESTION_LEVEL,                             "No congestion or undefined" },
 853   { CONGESTION_LEVEL_1_LEVEL,                        "Congestion level 1" },
 854   { CONGESTION_LEVEL_2_LEVEL,                        "Congestion level 2" },
 855   { CONGESTION_LEVEL_3_LEVEL,                        "Congestion level 3" },
 856   {0,                           NULL } };
 857
 858 #define CONG_IND_RESERVED_LENGTH    3
 859 #define CONG_IND_LEVEL_LENGTH       1
 860
 861 #define CONG_IND_RESERVED_OFFSET     PARAMETER_VALUE_OFFSET
 862 #define CONG_IND_LEVEL_OFFSET        (CONG_IND_RESERVED_OFFSET + CONG_IND_RESERVED_LENGTH)
 863
 864 static void
 865 dissect_m3ua_congestion_indication_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 866 {
 867   guint8 level;
 868
 869   level = tvb_get_guint8(parameter_tvb, CONG_IND_LEVEL_OFFSET);
 870
 871   proto_tree_add_bytes(parameter_tree, hf_m3ua_congestion_reserved, parameter_tvb, CONG_IND_RESERVED_OFFSET, CONG_IND_RESERVED_LENGTH,
 872                        tvb_get_ptr(parameter_tvb, CONG_IND_RESERVED_OFFSET, CONG_IND_RESERVED_LENGTH));
 873   proto_tree_add_uint(parameter_tree, hf_m3ua_congestion_level, parameter_tvb, CONG_IND_LEVEL_OFFSET, CONG_IND_LEVEL_LENGTH, level);
 874   proto_item_set_text(parameter_item, "Congestion indication(%s)", val_to_str(level, m3ua_congestion_level_values, "unknown"));
 875 }
 876
 877 #define CON_DEST_RESERVED_LENGTH    1
 878 #define CON_DEST_PC_LENGTH          3
 879
 880 #define CON_DEST_RESERVED_OFFSET    PARAMETER_VALUE_OFFSET
 881 #define CON_DEST_PC_OFFSET          (CON_DEST_RESERVED_OFFSET + CON_DEST_RESERVED_LENGTH)
 882
 883 static void
 884 dissect_m3ua_concerned_destination_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 885 {
 886   guint32 pc;
 887
 888   pc = tvb_get_ntoh24(parameter_tvb, CON_DEST_PC_OFFSET);
 889
 890   proto_tree_add_bytes(parameter_tree, hf_m3ua_concerned_dest_reserved, parameter_tvb, CON_DEST_RESERVED_OFFSET, CON_DEST_RESERVED_LENGTH,
 891                        tvb_get_ptr(parameter_tvb, CON_DEST_RESERVED_OFFSET, CON_DEST_RESERVED_LENGTH));
 892   proto_tree_add_uint(parameter_tree, hf_m3ua_concerned_dest_pc, parameter_tvb, CON_DEST_PC_OFFSET, CON_DEST_PC_LENGTH, pc);
 893   proto_item_set_text(parameter_item, "Concerned destination (%u)", pc);
 894 }
 895
 896 static void
 897 dissect_m3ua_routing_key_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 898 {
 899   tvbuff_t *parameters_tvb;
 900   guint16 length, parameters_length;
 901
 902   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 903   parameters_length = length - PARAMETER_HEADER_LENGTH;
 904   parameters_tvb          = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 905   dissect_m3ua_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 906   proto_item_set_text(parameter_item, "Routing key");
 907 }
 908
 909 static const value_string m3ua_registration_result_status_values[] = {
 910   { 0,           "Successfully Registered" } ,
 911   { 1,           "Error - Unknown" } ,
 912   { 2,           "Error - Invalid DPC" } ,
 913   { 3,           "Error - Invalid Network Appearance" } ,
 914   { 4,           "Error - Invalid Routing Key" } ,
 915   { 5,           "Error - Permission Denied" } ,
 916   { 6,           "Error - Overlapping (Non-unique) Routing Key" } ,
 917   { 7,           "Error - Routing Key not Provisioned" } ,
 918   { 8,           "Error - Insufficient Resources" } ,
 919   { 0,           NULL } };
 920
 921 #define REG_RES_IDENTIFIER_LENGTH 4
 922 #define REG_RES_STATUS_LENGTH     4
 923 #define REG_RES_CONTEXT_LENGTH    4
 924
 925 #define REG_RES_IDENTIFIER_OFFSET PARAMETER_VALUE_OFFSET
 926 #define REG_RES_STATUS_OFFSET     (REG_RES_IDENTIFIER_OFFSET + REG_RES_IDENTIFIER_LENGTH)
 927 #define REG_RES_CONTEXT_OFFSET    (REG_RES_STATUS_OFFSET + REG_RES_STATUS_LENGTH)
 928
 929 static void
 930 dissect_m3ua_v6_registration_result_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 931 {
 932   guint32 id, status, context;
 933
 934   id      = tvb_get_ntohl(parameter_tvb, REG_RES_IDENTIFIER_OFFSET);
 935   status  = tvb_get_ntohl(parameter_tvb, REG_RES_STATUS_OFFSET);
 936   context = tvb_get_ntohl(parameter_tvb, REG_RES_CONTEXT_OFFSET);
 937
 938   proto_tree_add_uint(parameter_tree, hf_m3ua_registration_result_identifier, parameter_tvb, REG_RES_IDENTIFIER_OFFSET, REG_RES_IDENTIFIER_LENGTH, id);
 939   proto_tree_add_uint(parameter_tree, hf_m3ua_registration_result_status, parameter_tvb, REG_RES_STATUS_OFFSET, REG_RES_STATUS_LENGTH, status);
 940   proto_tree_add_uint(parameter_tree, hf_m3ua_registration_result_context, parameter_tvb, REG_RES_CONTEXT_OFFSET, REG_RES_CONTEXT_LENGTH, context);
 941   proto_item_set_text(parameter_item, "Registration result");
 942 }
 943
 944 static void
 945 dissect_m3ua_v12_registration_result_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 946 {
 947   tvbuff_t *parameters_tvb;
 948   guint16 length, parameters_length;
 949
 950   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 951   parameters_length = length - PARAMETER_HEADER_LENGTH;
 952   parameters_tvb          = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 953   dissect_m3ua_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 954   proto_item_set_text(parameter_item, "Registration result");
 955 }
 956
 957 static const value_string m3ua_deregistration_result_status_values[] = {
 958   { 0,           "Successfully De-registered" } ,
 959   { 1,           "Error - Unknown" } ,
 960   { 2,           "Error - Invalid Routing context" } ,
 961   { 3,           "Error - Permission Denied" } ,
 962   { 4,           "Error - Not registered" } ,
 963   { 0,           NULL } };
 964
 965 #define DEREG_RES_CONTEXT_LENGTH 4
 966 #define DEREG_RES_STATUS_LENGTH  4
 967
 968 #define DEREG_RES_CONTEXT_OFFSET PARAMETER_VALUE_OFFSET
 969 #define DEREG_RES_STATUS_OFFSET  (DEREG_RES_CONTEXT_OFFSET + DEREG_RES_CONTEXT_LENGTH)
 970
 971 static void
 972 dissect_m3ua_v6_deregistration_result_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 973 {
 974   guint32 status, context;
 975
 976   context = tvb_get_ntohl(parameter_tvb, DEREG_RES_CONTEXT_OFFSET);
 977   status  = tvb_get_ntohl(parameter_tvb, DEREG_RES_STATUS_OFFSET);
 978
 979   proto_tree_add_uint(parameter_tree, hf_m3ua_deregistration_result_context, parameter_tvb, DEREG_RES_CONTEXT_OFFSET, DEREG_RES_CONTEXT_LENGTH, context);
 980   proto_tree_add_uint(parameter_tree, hf_m3ua_deregistration_result_status, parameter_tvb, DEREG_RES_STATUS_OFFSET, DEREG_RES_STATUS_LENGTH, status);
 981   proto_item_set_text(parameter_item, "De-registration result");
 982
 983 }
 984
 985 static void
 986 dissect_m3ua_v12_deregistration_result_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 987 {
 988   tvbuff_t *parameters_tvb;
 989   guint16 length, parameters_length;
 990
 991   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 992   parameters_length = length - PARAMETER_HEADER_LENGTH;
 993   parameters_tvb          = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 994   dissect_m3ua_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 995   proto_item_set_text(parameter_item, "Deregistration result");
 996 }
 997
 998
 999 #define LOCAL_RK_IDENTIFIER_OFFSET PARAMETER_VALUE_OFFSET
1000 #define LOCAL_RK_IDENTIFIER_LENGTH 4
1001
1002 static void
1003 dissect_m3ua_local_routing_key_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1004 {
1005   guint32 id;
1006
1007   id = tvb_get_ntohl(parameter_tvb, LOCAL_RK_IDENTIFIER_OFFSET);
1008   proto_tree_add_uint(parameter_tree, hf_m3ua_local_rk_identifier, parameter_tvb, LOCAL_RK_IDENTIFIER_OFFSET, LOCAL_RK_IDENTIFIER_LENGTH, id);
1009   proto_item_set_text(parameter_item, "Local routing key identifier (%u)", id);
1010 }
1011
1012 #define DPC_MASK_LENGTH    1
1013 #define DPC_PC_LENGTH      3
1014
1015 #define DPC_MASK_OFFSET    PARAMETER_VALUE_OFFSET
1016 #define DPC_PC_OFFSET      (DPC_MASK_OFFSET + DPC_MASK_LENGTH)
1017
1018 static void
1019 dissect_m3ua_destination_point_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1020 {
1021   guint32 pc;
1022   guint8  mask;
1023
1024   mask = tvb_get_guint8(parameter_tvb, DPC_MASK_OFFSET);
1025   pc   = tvb_get_ntoh24(parameter_tvb, DPC_PC_OFFSET);
1026
1027   proto_tree_add_uint(parameter_tree, hf_m3ua_dpc_mask, parameter_tvb, DPC_MASK_OFFSET, DPC_MASK_LENGTH, mask);
1028   proto_tree_add_uint(parameter_tree, hf_m3ua_dpc_pc, parameter_tvb, DPC_PC_OFFSET, DPC_PC_LENGTH, pc);
1029   proto_item_set_text(parameter_item, "Destination point code (%u)", pc);
1030 }
1031
1032 #define SI_LENGTH 1
1033
1034 static void
1035 dissect_m3ua_service_indicators_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1036 {
1037   guint8  si;
1038   guint16 length, number_of_sis, si_number;
1039   gint si_offset;
1040
1041   length        = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1042   number_of_sis = length - PARAMETER_HEADER_LENGTH;
1043
1044   si_offset = PARAMETER_VALUE_OFFSET;
1045   for(si_number=1; si_number <= number_of_sis; si_number++) {
1046     si = tvb_get_guint8(parameter_tvb, si_offset);
1047     proto_tree_add_uint(parameter_tree, hf_m3ua_si, parameter_tvb, si_offset, SI_LENGTH, si);
1048     si_offset += SI_LENGTH;
1049   };
1050   proto_item_set_text(parameter_item, "Service indicators (%u indicator%s)", number_of_sis, plurality(number_of_sis, "", "s"));
1051
1052 }
1053 #define SSN_LENGTH 1
1054
1055 static void
1056 dissect_m3ua_subsystem_numbers_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1057 {
1058   guint8  ssn;
1059   guint16 length, number_of_ssns, ssn_number;
1060   gint ssn_offset;
1061
1062   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1063   number_of_ssns = length - PARAMETER_HEADER_LENGTH;
1064
1065   ssn_offset = PARAMETER_VALUE_OFFSET;
1066   for(ssn_number=1; ssn_number <= number_of_ssns; ssn_number++) {
1067     ssn = tvb_get_guint8(parameter_tvb, ssn_offset);
1068     proto_tree_add_uint(parameter_tree, hf_m3ua_ssn, parameter_tvb, ssn_offset, SSN_LENGTH, ssn);
1069     ssn_offset += SSN_LENGTH;
1070   };
1071   proto_item_set_text(parameter_item, "Subsystem numbers (%u number%s)", number_of_ssns, plurality(number_of_ssns, "", "s"));
1072
1073 }
1074
1075 #define OPC_MASK_LENGTH             1
1076 #define OPC_PC_LENGTH               3
1077 #define OPC_LENGTH                  (OPC_MASK_LENGTH + OPC_PC_LENGTH)
1078 #define OPC_MASK_OFFSET             0
1079 #define OPC_PC_OFFSET               (OPC_MASK_OFFSET + OPC_MASK_LENGTH)
1080
1081 static void
1082 dissect_m3ua_originating_point_code_list_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1083 {
1084   guint8  mask;
1085   guint16 length, number_of_point_codes, point_code_number;
1086   guint32 pc;
1087   gint point_code_offset;
1088
1089   length                = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1090   number_of_point_codes = (length - PARAMETER_HEADER_LENGTH) / 4;
1091
1092   point_code_offset = PARAMETER_VALUE_OFFSET;
1093   for(point_code_number=1; point_code_number <= number_of_point_codes; point_code_number++) {
1094     mask = tvb_get_guint8(parameter_tvb, point_code_offset + AFFECTED_MASK_OFFSET);
1095     pc   = tvb_get_ntoh24(parameter_tvb, point_code_offset + AFFECTED_PC_OFFSET);
1096     proto_tree_add_uint(parameter_tree, hf_m3ua_opc_list_mask, parameter_tvb, point_code_offset + OPC_MASK_OFFSET, OPC_MASK_LENGTH, mask);
1097     proto_tree_add_uint(parameter_tree, hf_m3ua_opc_list_pc, parameter_tvb, point_code_offset + OPC_PC_OFFSET, OPC_PC_LENGTH, pc);
1098     point_code_offset += OPC_LENGTH;
1099   };
1100   proto_item_set_text(parameter_item, "Originating point code list (%u point code%s)", number_of_point_codes, plurality(number_of_point_codes, "", "s"));
1101 }
1102
1103 #define CIC_RANGE_MASK_LENGTH             1
1104 #define CIC_RANGE_PC_LENGTH               3
1105 #define CIC_RANGE_LOWER_LENGTH            2
1106 #define CIC_RANGE_UPPER_LENGTH            2
1107 #define CIC_RANGE_LENGTH                  (CIC_RANGE_MASK_LENGTH + CIC_RANGE_PC_LENGTH + CIC_RANGE_LOWER_LENGTH + CIC_RANGE_UPPER_LENGTH)
1108 #define CIC_RANGE_MASK_OFFSET             0
1109 #define CIC_RANGE_PC_OFFSET               (CIC_RANGE_MASK_OFFSET + CIC_RANGE_MASK_LENGTH)
1110 #define CIC_RANGE_LOWER_OFFSET            (CIC_RANGE_PC_OFFSET + CIC_RANGE_PC_LENGTH)
1111 #define CIC_RANGE_UPPER_OFFSET            (CIC_RANGE_LOWER_OFFSET + CIC_RANGE_LOWER_LENGTH)
1112
1113 static void
1114 dissect_m3ua_circuit_range_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1115 {
1116   guint8  mask;
1117   guint16 length, number_of_point_codes, point_code_number, lower, upper;
1118   guint32 pc;
1119   gint point_code_offset;
1120
1121   length                = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1122   number_of_point_codes = (length - PARAMETER_HEADER_LENGTH) / CIC_RANGE_LENGTH;
1123
1124   point_code_offset = PARAMETER_VALUE_OFFSET;
1125   for(point_code_number = 1; point_code_number <= number_of_point_codes; point_code_number++) {
1126     mask  = tvb_get_guint8(parameter_tvb, point_code_offset + CIC_RANGE_MASK_OFFSET);
1127     pc    = tvb_get_ntoh24(parameter_tvb, point_code_offset + CIC_RANGE_PC_OFFSET);
1128     lower = tvb_get_ntohs(parameter_tvb, point_code_offset + CIC_RANGE_LOWER_OFFSET);
1129     upper = tvb_get_ntohs(parameter_tvb, point_code_offset + CIC_RANGE_UPPER_OFFSET);
1130
1131     proto_tree_add_uint(parameter_tree, hf_m3ua_cic_range_mask, parameter_tvb, point_code_offset + CIC_RANGE_MASK_OFFSET, CIC_RANGE_MASK_LENGTH, mask);
1132     proto_tree_add_uint(parameter_tree, hf_m3ua_cic_range_pc, parameter_tvb, point_code_offset + CIC_RANGE_PC_OFFSET, CIC_RANGE_PC_LENGTH, pc);
1133     proto_tree_add_uint(parameter_tree, hf_m3ua_cic_range_lower, parameter_tvb, point_code_offset + CIC_RANGE_LOWER_OFFSET, CIC_RANGE_LOWER_LENGTH, lower);
1134     proto_tree_add_uint(parameter_tree, hf_m3ua_cic_range_upper, parameter_tvb, point_code_offset + CIC_RANGE_UPPER_OFFSET, CIC_RANGE_UPPER_LENGTH, upper);
1135     point_code_offset += CIC_RANGE_LENGTH;
1136   };
1137   proto_item_set_text(parameter_item, "Circuit range (%u range%s)", number_of_point_codes, plurality(number_of_point_codes, "", "s"));
1138 }
1139
1140 #define DATA_OPC_LENGTH   4
1141 #define DATA_DPC_LENGTH   4
1142 #define DATA_SI_LENGTH    1
1143 #define DATA_NI_LENGTH    1
1144 #define DATA_MP_LENGTH    1
1145 #define DATA_SLS_LENGTH   1
1146 #define DATA_HDR_LENGTH   (DATA_OPC_LENGTH + DATA_DPC_LENGTH + DATA_SI_LENGTH + DATA_NI_LENGTH + DATA_MP_LENGTH + DATA_SLS_LENGTH)
1147
1148 #define DATA_OPC_OFFSET   PARAMETER_VALUE_OFFSET
1149 #define DATA_DPC_OFFSET   (DATA_OPC_OFFSET + DATA_OPC_LENGTH)
1150 #define DATA_SI_OFFSET    (DATA_DPC_OFFSET + DATA_DPC_LENGTH)
1151 #define DATA_NI_OFFSET    (DATA_SI_OFFSET + DATA_SI_LENGTH)
1152 #define DATA_MP_OFFSET    (DATA_NI_OFFSET + DATA_NI_LENGTH)
1153 #define DATA_SLS_OFFSET   (DATA_MP_OFFSET + DATA_MP_LENGTH)
1154 #define DATA_ULP_OFFSET   (DATA_SLS_OFFSET + DATA_SLS_LENGTH)
1155
1156 static void
1157 dissect_m3ua_protocol_data_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
1158 {
1159   guint32 opc, dpc;
1160   guint16 length, ulp_length;
1161   guint8 si, ni, mp, sls;
1162   tvbuff_t *payload_tvb;
1163
1164   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1165   ulp_length = length - PARAMETER_HEADER_LENGTH - DATA_HDR_LENGTH;
1166   payload_tvb          = tvb_new_subset(parameter_tvb, DATA_ULP_OFFSET, ulp_length, ulp_length);
1167   opc = tvb_get_ntohl(parameter_tvb, DATA_OPC_OFFSET);
1168   dpc = tvb_get_ntohl(parameter_tvb, DATA_DPC_OFFSET);
1169   si  = tvb_get_guint8(parameter_tvb, DATA_SI_OFFSET);
1170   ni  = tvb_get_guint8(parameter_tvb, DATA_NI_OFFSET);
1171   mp  = tvb_get_guint8(parameter_tvb, DATA_MP_OFFSET);
1172   sls = tvb_get_guint8(parameter_tvb, DATA_SLS_OFFSET);
1173   proto_tree_add_uint(parameter_tree, hf_m3ua_protocol_data_opc, parameter_tvb, DATA_OPC_OFFSET, DATA_OPC_LENGTH, opc);
1174   proto_tree_add_uint(parameter_tree, hf_m3ua_protocol_data_dpc, parameter_tvb, DATA_DPC_OFFSET, DATA_DPC_LENGTH, dpc);
1175   proto_tree_add_uint(parameter_tree, hf_m3ua_protocol_data_si,  parameter_tvb, DATA_SI_OFFSET,  DATA_SI_LENGTH,  si);
1176   proto_tree_add_uint(parameter_tree, hf_m3ua_protocol_data_ni,  parameter_tvb, DATA_NI_OFFSET,  DATA_NI_LENGTH,  ni);
1177   proto_tree_add_uint(parameter_tree, hf_m3ua_protocol_data_mp,  parameter_tvb, DATA_MP_OFFSET,  DATA_MP_LENGTH,  mp);
1178   proto_tree_add_uint(parameter_tree, hf_m3ua_protocol_data_sls, parameter_tvb, DATA_SLS_OFFSET, DATA_SLS_LENGTH, sls);
1179
1180   proto_item_set_text(parameter_item, "Protocol data (SS7 message of %u byte%s)", ulp_length, plurality(ulp_length, "", "s"));
1181   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH + DATA_HDR_LENGTH);
1182
1183   if (!dissector_try_port(m3ua_si_dissector_table, si, payload_tvb, pinfo, tree)) {
1184     call_dissector(data_handle, payload_tvb, pinfo, tree);
1185   }
1186 }
1187
1188 #define CORR_ID_OFFSET PARAMETER_VALUE_OFFSET
1189 #define CORR_ID_LENGTH 4
1190
1191 static void
1192 dissect_m3ua_correlation_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1193 {
1194   guint32 id;
1195
1196   id = tvb_get_ntohl(parameter_tvb, CORR_ID_OFFSET);
1197   proto_tree_add_uint(parameter_tree, hf_m3ua_correlation_identifier, parameter_tvb, CORR_ID_OFFSET, CORR_ID_LENGTH, id);
1198   proto_item_set_text(parameter_item, "Correlation Identifer (%u)", id);
1199 }
1200
1201 #define REG_STATUS_LENGTH  4
1202 #define REG_STATUS_OFFSET  PARAMETER_VALUE_OFFSET
1203
1204 static const value_string m3ua_registration_status_values[] = {
1205   {  0,           "Successfully Registered" },
1206   {  1,           "Error - Unknown" },
1207   {  2,           "Error - Invalid DPC" },
1208   {  3,           "Error - Invalid Network Appearance" },
1209   {  4,           "Error - Invalid Routing Key" },
1210   {  5,           "Error - Permission Denied" },
1211   {  6,           "Error - Cannot Support Unique Routing" },
1212   {  7,           "Error - Routing Key not Currently Provisioned" },
1213   {  8,           "Error - Insufficient Resources" },
1214   {  9,           "Error - Unsupported RK parameter Field" },
1215   { 10,           "Error - Unsupported/Invalid Traffic Handling Mode" },
1216   {  0,           NULL } };
1217
1218 static void
1219 dissect_m3ua_registration_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1220 {
1221   guint32 status;
1222
1223   status = tvb_get_ntohl(parameter_tvb, REG_STATUS_OFFSET);
1224   proto_tree_add_uint(parameter_tree, hf_m3ua_registration_status, parameter_tvb, REG_STATUS_OFFSET, REG_STATUS_LENGTH, status);
1225   proto_item_set_text(parameter_item, "Registration status (%s)", val_to_str(status, m3ua_registration_status_values, "unknown"));
1226 }
1227
1228 #define DEREG_STATUS_LENGTH  4
1229 #define DEREG_STATUS_OFFSET  PARAMETER_VALUE_OFFSET
1230
1231 static const value_string m3ua_deregistration_status_values[] = {
1232   { 0,          "Successfully Deregistered" },
1233   { 1,          "Error - Unknown" },
1234   { 2,          "Error - Invalid Routing Context" },
1235   { 3,          "Error - Permission Denied" },
1236   { 4,          "Error - Not Registered" },
1237   { 5,          "Error - ASP Currently Active for Routing Context" },
1238   { 0,          NULL } };
1239
1240 static void
1241 dissect_m3ua_deregistration_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1242 {
1243   guint32 status;
1244
1245   status = tvb_get_ntohl(parameter_tvb, DEREG_STATUS_OFFSET);
1246   proto_tree_add_uint(parameter_tree, hf_m3ua_deregistration_status, parameter_tvb, DEREG_STATUS_OFFSET, DEREG_STATUS_LENGTH, status);
1247   proto_item_set_text(parameter_item, "Deregistration status (%s)", val_to_str(status, m3ua_deregistration_status_values, "unknown"));
1248 }
1249
1250 static void
1251 dissect_m3ua_registration_results_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
1252 {
1253   tvbuff_t *parameters_tvb;
1254   guint16 length, parameters_length;
1255
1256   length            = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1257   parameters_length = length - PARAMETER_HEADER_LENGTH;
1258   parameters_tvb    = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
1259   dissect_m3ua_parameters(parameters_tvb, pinfo, tree, parameter_tree);
1260   proto_item_set_text(parameter_item, "Registration results");
1261 }
1262
1263 static void
1264 dissect_m3ua_deregistration_results_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
1265 {
1266   tvbuff_t *parameters_tvb;
1267   guint16 length, parameters_length;
1268
1269   length            = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1270   parameters_length = length - PARAMETER_HEADER_LENGTH;
1271   parameters_tvb    = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
1272   dissect_m3ua_parameters(parameters_tvb, pinfo, tree, parameter_tree);
1273   proto_item_set_text(parameter_item, "Deregistration results");
1274 }
1275
1276 static void
1277 dissect_m3ua_unknown_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1278 {
1279   guint16 tag, length, parameter_value_length;
1280
1281   tag    = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1282   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1283
1284   parameter_value_length = length - PARAMETER_HEADER_LENGTH;
1285
1286   proto_tree_add_bytes(parameter_tree, hf_m3ua_parameter_value, parameter_tvb, PARAMETER_VALUE_OFFSET, parameter_value_length,
1287                        tvb_get_ptr(parameter_tvb, PARAMETER_VALUE_OFFSET, parameter_value_length));
1288
1289   proto_item_set_text(parameter_item, "Parameter with tag %u and %u byte%s value", tag, parameter_value_length, plurality(parameter_value_length, "", "s"));
1290 }
1291
1292 static void
1293 dissect_m3ua_v6_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1294 {
1295   guint16 tag, length, padding_length, total_length;
1296   proto_item *parameter_item;
1297   proto_tree *parameter_tree;
1298
1299   /* extract tag and length from the parameter */
1300   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1301   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1302
1303   /* calculate padding and total length */
1304   padding_length = tvb_length(parameter_tvb) - length;
1305   total_length   = length + padding_length;
1306
1307   /* create proto_tree stuff */
1308   parameter_item   = proto_tree_add_text(m3ua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, total_length, "Incomplete parameter");
1309   parameter_tree   = proto_item_add_subtree(parameter_item, ett_m3ua_parameter);
1310
1311   /* add tag and length to the m3ua tree */
1312   proto_tree_add_uint_format(parameter_tree, hf_m3ua_parameter_tag, parameter_tvb, PARAMETER_TAG_OFFSET, PARAMETER_TAG_LENGTH, tag,
1313                              "Parameter tag: %s (0x%x)", val_to_str(tag, m3ua_v6_parameter_tag_values, "unknown"), tag);
1314   proto_tree_add_uint(parameter_tree, hf_m3ua_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, length);
1315
1316   switch(tag) {
1317   case V6_NETWORK_APPEARANCE_PARAMETER_TAG:
1318     dissect_m3ua_network_appearance_parameter(parameter_tvb, parameter_tree, parameter_item);
1319     break;
1320   case V6_PROTOCOL_DATA_1_PARAMETER_TAG:
1321     dissect_m3ua_protocol_data_1_parameter(parameter_tvb, pinfo, tree, parameter_item);
1322     break;
1323   case V6_PROTOCOL_DATA_2_PARAMETER_TAG:
1324     dissect_m3ua_protocol_data_2_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1325     break;
1326   case V6_INFO_PARAMETER_TAG:
1327     dissect_m3ua_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
1328     break;
1329   case V6_AFFECTED_DESTINATIONS_PARAMETER_TAG:
1330     dissect_m3ua_affected_point_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1331     break;
1332   case V6_ROUTING_CONTEXT_PARAMETER_TAG:
1333     dissect_m3ua_routing_context_parameter(parameter_tvb, parameter_tree, parameter_item);
1334     break;
1335   case V6_DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
1336     dissect_m3ua_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
1337     break;
1338   case V6_HEARTBEAT_DATA_PARAMETER_TAG:
1339     dissect_m3ua_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
1340     break;
1341   case V6_USER_CAUSE_PARAMETER_TAG:
1342     dissect_m3ua_user_cause_parameter(parameter_tvb, parameter_tree, parameter_item);
1343     break;
1344   case V6_REASON_PARAMETER_TAG:
1345     dissect_m3ua_reason_parameter(parameter_tvb, parameter_tree, parameter_item);
1346     break;
1347   case V6_TRAFFIC_MODE_TYPE_PARAMETER_TAG:
1348     dissect_m3ua_v6_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
1349     break;
1350   case V6_ERROR_CODE_PARAMETER_TAG:
1351     dissect_m3ua_v6_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1352     break;
1353   case V6_STATUS_PARAMETER_TAG:
1354     dissect_m3ua_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1355     break;
1356   case V6_CONGESTION_INDICATION_PARAMETER_TAG:
1357     dissect_m3ua_congestion_indication_parameter(parameter_tvb, parameter_tree, parameter_item);
1358     break;
1359   case V6_CONCERNED_DESTINATION_PARAMETER_TAG:
1360     dissect_m3ua_concerned_destination_parameter(parameter_tvb, parameter_tree, parameter_item);
1361     break;
1362   case V6_ROUTING_KEY_PARAMETER_TAG:
1363     dissect_m3ua_routing_key_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1364     break;
1365   case V6_REGISTRATION_RESULT_PARAMETER_TAG:
1366     dissect_m3ua_v6_registration_result_parameter(parameter_tvb, parameter_tree, parameter_item);
1367     break;
1368   case V6_DEREGISTRATION_RESULT_PARAMETER_TAG:
1369     dissect_m3ua_v6_deregistration_result_parameter(parameter_tvb, parameter_tree, parameter_item);
1370     break;
1371   case V6_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG:
1372     dissect_m3ua_local_routing_key_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1373     break;
1374   case V6_DESTINATION_POINT_CODE_PARAMETER_TAG:
1375     dissect_m3ua_destination_point_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1376     break;
1377   case V6_SERVICE_INDICATORS_PARAMETER_TAG:
1378     dissect_m3ua_service_indicators_parameter(parameter_tvb, parameter_tree, parameter_item);
1379     break;
1380   case V6_SUBSYSTEM_NUMBERS_PARAMETER_TAG:
1381     dissect_m3ua_subsystem_numbers_parameter(parameter_tvb, parameter_tree, parameter_item);
1382     break;
1383   case V6_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG:
1384     dissect_m3ua_originating_point_code_list_parameter(parameter_tvb, parameter_tree, parameter_item);
1385     break;
1386   case V6_CIRCUIT_RANGE_PARAMETER_TAG:
1387     dissect_m3ua_circuit_range_parameter(parameter_tvb, parameter_tree, parameter_item);
1388     break;
1389   case V6_REGISTRATION_RESULTS_PARAMETER_TAG:
1390     dissect_m3ua_registration_results_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1391     break;
1392   case V6_DEREGISTRATION_RESULTS_PARAMETER_TAG:
1393     dissect_m3ua_deregistration_results_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1394     break;
1395   default:
1396     dissect_m3ua_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
1397     break;
1398   };
1399
1400   if (padding_length > 0)
1401     proto_tree_add_bytes(parameter_tree, hf_m3ua_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length,
1402                          tvb_get_ptr(parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length));
1403 }
1404
1405 static void
1406 dissect_m3ua_v12_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1407 {
1408   guint16 tag, length, padding_length, total_length;
1409   proto_item *parameter_item;
1410   proto_tree *parameter_tree;
1411
1412   /* extract tag and length from the parameter */
1413   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1414   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1415
1416   /* calculate padding and total length */
1417   padding_length = tvb_length(parameter_tvb) - length;
1418   total_length   = length + padding_length;
1419
1420   /* create proto_tree stuff */
1421   parameter_item   = proto_tree_add_text(m3ua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, total_length, "Incomplete parameter");
1422   parameter_tree   = proto_item_add_subtree(parameter_item, ett_m3ua_parameter);
1423
1424   /* add tag and length to the m3ua tree */
1425   proto_tree_add_uint_format(parameter_tree, hf_m3ua_parameter_tag, parameter_tvb, PARAMETER_TAG_OFFSET, PARAMETER_TAG_LENGTH, tag,
1426                              "Parameter tag: %s (0x%x)", val_to_str(tag, m3ua_v12_parameter_tag_values, "unknown"), tag);
1427   proto_tree_add_uint(parameter_tree, hf_m3ua_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, length);
1428
1429   switch(tag) {
1430   case V12_INFO_STRING_PARAMETER_TAG:
1431     dissect_m3ua_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
1432     break;
1433   case V12_ROUTING_CONTEXT_PARAMETER_TAG:
1434     dissect_m3ua_routing_context_parameter(parameter_tvb, parameter_tree, parameter_item);
1435     break;
1436   case V12_DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
1437     dissect_m3ua_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
1438     break;
1439   case V12_HEARTBEAT_DATA_PARAMETER_TAG:
1440     dissect_m3ua_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
1441     break;
1442   case V12_TRAFFIC_MODE_TYPE_PARAMETER_TAG:
1443     dissect_m3ua_v12_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
1444     break;
1445   case V12_ERROR_CODE_PARAMETER_TAG:
1446     dissect_m3ua_v12_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1447     break;
1448   case V12_STATUS_PARAMETER_TAG:
1449     dissect_m3ua_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1450     break;
1451   case V12_ASP_IDENTIFIER_PARAMETER_TAG:
1452     dissect_m3ua_asp_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1453     break;
1454   case V12_AFFECTED_POINT_CODE_PARAMETER_TAG:
1455     dissect_m3ua_affected_point_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1456     break;
1457   case V12_NETWORK_APPEARANCE_PARAMETER_TAG:
1458     dissect_m3ua_network_appearance_parameter(parameter_tvb, parameter_tree, parameter_item);
1459     break;
1460   case V12_USER_CAUSE_PARAMETER_TAG:
1461     dissect_m3ua_user_cause_parameter(parameter_tvb, parameter_tree, parameter_item);
1462     break;
1463   case V12_CONGESTION_INDICATIONS_PARAMETER_TAG:
1464     dissect_m3ua_congestion_indication_parameter(parameter_tvb, parameter_tree, parameter_item);
1465     break;
1466   case V12_CONCERNED_DESTINATION_PARAMETER_TAG:
1467     dissect_m3ua_concerned_destination_parameter(parameter_tvb, parameter_tree, parameter_item);
1468     break;
1469   case V12_ROUTING_KEY_PARAMETER_TAG:
1470     dissect_m3ua_routing_key_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1471     break;
1472   case V12_REGISTRATION_RESULT_PARAMETER_TAG:
1473     dissect_m3ua_v12_registration_result_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1474     break;
1475   case V12_DEREGISTRATION_RESULT_PARAMETER_TAG:
1476     dissect_m3ua_v12_deregistration_result_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1477     break;
1478   case V12_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG:
1479     dissect_m3ua_local_routing_key_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1480     break;
1481   case V12_DESTINATION_POINT_CODE_PARAMETER_TAG:
1482     dissect_m3ua_destination_point_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1483     break;
1484   case V12_SERVICE_INDICATORS_PARAMETER_TAG:
1485     dissect_m3ua_service_indicators_parameter(parameter_tvb, parameter_tree, parameter_item);
1486     break;
1487   case V12_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG:
1488     dissect_m3ua_originating_point_code_list_parameter(parameter_tvb, parameter_tree, parameter_item);
1489     break;
1490   case V12_CIRCUIT_RANGE_PARAMETER_TAG:
1491     dissect_m3ua_circuit_range_parameter(parameter_tvb, parameter_tree, parameter_item);
1492     break;
1493   case V12_PROTOCOL_DATA_PARAMETER_TAG:
1494     dissect_m3ua_protocol_data_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1495     break;
1496   case V12_CORRELATION_IDENTIFIER_PARAMETER_TAG:
1497     dissect_m3ua_correlation_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1498     break;
1499   case V12_REGISTRATION_STATUS_PARAMETER_TAG:
1500     dissect_m3ua_registration_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1501     break;
1502   case V12_DEREGISTRATION_STATUS_PARAMETER_TAG:
1503     dissect_m3ua_deregistration_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1504     break;
1505   default:
1506     dissect_m3ua_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
1507     break;
1508   };
1509
1510   if (padding_length > 0)
1511     proto_tree_add_bytes(parameter_tree, hf_m3ua_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length,
1512                          tvb_get_ptr(parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length));
1513 }
1514
1515 static void
1516 dissect_m3ua_parameters(tvbuff_t *parameters_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1517 {
1518   gint offset, length, padding_length, total_length, remaining_length;
1519   tvbuff_t *parameter_tvb;
1520
1521   offset = 0;
1522   while((remaining_length = tvb_reported_length_remaining(parameters_tvb, offset))) {
1523     length         = tvb_get_ntohs(parameters_tvb, offset + PARAMETER_LENGTH_OFFSET);
1524     padding_length = nr_of_padding_bytes(length);
1525     if (remaining_length >= length)
1526       total_length = MIN(length + padding_length, remaining_length);
1527     else
1528       total_length = length + padding_length;
1529     /* create a tvb for the parameter including the padding bytes */
1530     parameter_tvb    = tvb_new_subset(parameters_tvb, offset, total_length, total_length);
1531     switch(m3ua_version) {
1532       case M3UA_V6:
1533         dissect_m3ua_v6_parameter(parameter_tvb, pinfo, tree, m3ua_tree);
1534         break;
1535       case M3UA_V12:
1536         dissect_m3ua_v12_parameter(parameter_tvb, pinfo, tree, m3ua_tree);
1537         break;
1538     }
1539     /* get rid of the handled parameter */
1540     offset += total_length;
1541   }
1542 }
1543
1544
1545 static void
1546 dissect_m3ua_message(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1547 {
1548   tvbuff_t *common_header_tvb, *parameters_tvb;
1549
1550   common_header_tvb = tvb_new_subset(message_tvb, 0, COMMON_HEADER_LENGTH, COMMON_HEADER_LENGTH);
1551   parameters_tvb    = tvb_new_subset(message_tvb, COMMON_HEADER_LENGTH, -1, -1);
1552   dissect_m3ua_common_header(common_header_tvb, pinfo, m3ua_tree);
1553   if (m3ua_tree)
1554     dissect_m3ua_parameters(parameters_tvb, pinfo, tree, m3ua_tree);
1555 }
1556
1557 static void
1558 dissect_m3ua(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree)
1559 {
1560   proto_item *m3ua_item;
1561   proto_tree *m3ua_tree;
1562
1563   /* make entry in the Protocol column on summary display */
1564   if (check_col(pinfo->cinfo, COL_PROTOCOL))
1565     col_set_str(pinfo->cinfo, COL_PROTOCOL, "M3UA");
1566
1567   /* In the interest of speed, if "tree" is NULL, don't do any work not
1568      necessary to generate protocol tree items. */
1569   if (tree) {
1570     /* create the m3ua protocol tree */
1571     m3ua_item = proto_tree_add_item(tree, proto_m3ua, message_tvb, 0, -1, FALSE);
1572     m3ua_tree = proto_item_add_subtree(m3ua_item, ett_m3ua);
1573   } else {
1574     m3ua_tree = NULL;
1575   };
1576   /* dissect the message */
1577   dissect_m3ua_message(message_tvb, pinfo, tree, m3ua_tree);
1578 }
1579
1580 /* Register the protocol with Ethereal */
1581 void
1582 proto_register_m3ua(void)
1583 {
1584
1585   /* Setup list of header fields */
1586   static hf_register_info hf[] = {
1587     { &hf_m3ua_version,
1588       { "Version", "m3ua.version",
1589               FT_UINT8, BASE_DEC, VALS(m3ua_protocol_version_values), 0x0,
1590         "", HFILL }
1591     },
1592     { &hf_m3ua_reserved,
1593       { "Reserved", "m3ua.reserved",
1594               FT_UINT8, BASE_HEX, NULL, 0x0,
1595               "", HFILL }
1596     },
1597     { &hf_m3ua_message_class,
1598       { "Message class", "m3ua.message_class",
1599         FT_UINT8, BASE_DEC, VALS(m3ua_message_class_values), 0x0,
1600               "", HFILL }
1601     },
1602     { &hf_m3ua_message_type,
1603       { "Message Type", "m3ua.message_type",
1604               FT_UINT8, BASE_DEC, NULL, 0x0,
1605               "", HFILL }
1606     },
1607     { &hf_m3ua_message_length,
1608       { "Message length", "m3ua.message_length",
1609         FT_UINT32, BASE_DEC, NULL, 0x0,
1610               "", HFILL }
1611     },
1612     { &hf_m3ua_parameter_tag,
1613       { "Parameter Tag", "m3ua.parameter_tag",
1614         FT_UINT16, BASE_DEC, NULL, 0x0,
1615         "", HFILL }
1616     },
1617     { &hf_m3ua_parameter_length,
1618       { "Parameter length", "m3ua.parameter_length",
1619         FT_UINT16, BASE_DEC, NULL, 0x0,
1620               "", HFILL }
1621     },
1622     { &hf_m3ua_parameter_value,
1623       { "Parameter value", "m3ua.parameter_value",
1624               FT_BYTES, BASE_NONE, NULL, 0x0,
1625               "", HFILL }
1626     },
1627     { &hf_m3ua_parameter_padding,
1628       { "Padding", "m3ua.parameter_padding",
1629               FT_BYTES, BASE_NONE, NULL, 0x0,
1630               "", HFILL }
1631     },
1632     { &hf_m3ua_info_string,
1633       { "Info string", "m3ua.info_string",
1634               FT_STRING, BASE_DEC, NULL, 0x0,
1635               "", HFILL }
1636     },
1637     { &hf_m3ua_routing_context,
1638       { "Routing context", "m3ua.routing_context",
1639               FT_UINT32, BASE_DEC, NULL, 0x0,
1640         "", HFILL }
1641     },
1642     { &hf_m3ua_diagnostic_information,
1643       { "Diagnostic information", "m3ua.diagnostic_information",
1644               FT_BYTES, BASE_NONE, NULL, 0x0,
1645               "", HFILL }
1646     },
1647     { &hf_m3ua_heartbeat_data,
1648       { "Heartbeat data", "m3ua.heartbeat_data",
1649               FT_BYTES, BASE_NONE, NULL, 0x0,
1650               "", HFILL }
1651     },
1652     { &hf_m3ua_error_code,
1653       { "Error code", "m3ua.error_code",
1654         FT_UINT32, BASE_DEC, NULL, 0x0,
1655               "", HFILL }
1656     },
1657     { &hf_m3ua_status_type,
1658       { "Status type", "m3ua.status_type",
1659               FT_UINT16, BASE_DEC, VALS(m3ua_status_type_values), 0x0,
1660               "", HFILL }
1661     },
1662     { &hf_m3ua_status_info,
1663       { "Status info", "m3ua.status_info",
1664               FT_UINT16, BASE_DEC, NULL, 0x0,
1665               "", HFILL }
1666     },
1667     { &hf_m3ua_asp_identifier,
1668       { "ASP identifier", "m3ua.asp_identifier",
1669               FT_UINT32, BASE_DEC, NULL, 0x0,
1670               "", HFILL }
1671     },
1672     { &hf_m3ua_affected_point_code_mask,
1673       { "Mask", "m3ua.affected_point_code_mask",
1674         FT_UINT8, BASE_DEC, NULL, 0x0,
1675               "", HFILL }
1676     },
1677     { &hf_m3ua_affected_point_code_pc,
1678       { "Affected point code", "m3ua.affected_point_code_pc",
1679               FT_UINT24, BASE_DEC, NULL, 0x0,
1680               "", HFILL }
1681     },
1682     { &hf_m3ua_network_appearance,
1683       { "Network appearance", "m3ua.network_appearance",
1684               FT_UINT32, BASE_DEC, NULL, 0x0,
1685               "", HFILL }
1686     },
1687     { &hf_m3ua_unavailability_cause,
1688       { "Unavailability cause", "m3ua.unavailability_cause",
1689               FT_UINT16, BASE_DEC, VALS(m3ua_unavailability_cause_values), 0x0,
1690         "", HFILL }
1691     },
1692     { &hf_m3ua_user_identity,
1693       { "User Identity", "m3ua.user_identity",
1694                FT_UINT16, BASE_DEC, VALS(m3ua_user_identity_values), 0x0,
1695                "", HFILL }
1696     },
1697     { &hf_m3ua_congestion_reserved,
1698       { "Reserved", "m3ua.congestion_reserved",
1699               FT_BYTES, BASE_NONE, NULL, 0x0,
1700               "", HFILL }
1701     },
1702     { &hf_m3ua_congestion_level,
1703       { "Congestion level", "m3ua.congestion_level",
1704                FT_UINT8, BASE_DEC, VALS(m3ua_congestion_level_values), 0x0,
1705                "", HFILL }
1706     },
1707     { &hf_m3ua_concerned_dest_reserved,
1708       { "Reserved", "m3ua.concerned_reserved",
1709               FT_BYTES, BASE_NONE, NULL, 0x0,
1710               "", HFILL }
1711     },
1712     { &hf_m3ua_concerned_dest_pc,
1713       { "Concerned DPC", "m3ua.concerned_dpc",
1714                FT_UINT24, BASE_DEC, NULL, 0x0,
1715                "", HFILL }
1716     },
1717     { &hf_m3ua_dpc_mask,
1718       { "Mask", "m3ua.dpc_mask",
1719               FT_UINT8, BASE_DEC, NULL, 0x0,
1720               "", HFILL }
1721     },
1722     { &hf_m3ua_dpc_pc,
1723       { "Destination point code", "m3ua.dpc_pc",
1724                FT_UINT24, BASE_DEC, NULL, 0x0,
1725                "", HFILL }
1726     },
1727     { &hf_m3ua_si,
1728       { "Service indicator", "m3ua_si",
1729         FT_UINT8, BASE_DEC, VALS(m3ua_user_identity_values), 0x0,
1730               "", HFILL }
1731     },
1732     { &hf_m3ua_ssn,
1733       { "Subsystem number", "m3ua_ssn",
1734         FT_UINT8, BASE_DEC, NULL, 0x0,
1735               "", HFILL }
1736     },
1737     { &hf_m3ua_opc_list_mask,
1738       { "Mask", "m3ua.opc_list_mask",
1739               FT_UINT8, BASE_DEC, NULL, 0x0,
1740               "", HFILL }
1741     },
1742     { &hf_m3ua_opc_list_pc,
1743       { "Originating point code", "m3ua.opc_list_pc",
1744                FT_UINT24, BASE_DEC, NULL, 0x0,
1745                "", HFILL }
1746     },
1747     { &hf_m3ua_cic_range_mask,
1748       { "Mask", "m3ua.cic_range_mask",
1749               FT_UINT8, BASE_DEC, NULL, 0x0,
1750               "", HFILL }
1751     },
1752     { &hf_m3ua_cic_range_pc,
1753       { "Originating point code", "m3ua.cic_range_pc",
1754                FT_UINT24, BASE_DEC, NULL, 0x0,
1755                "", HFILL }
1756     },
1757     { &hf_m3ua_cic_range_lower,
1758       { "Lower CIC value", "m3ua.cic_range_lower",
1759               FT_UINT16, BASE_DEC, NULL, 0x0,
1760               "", HFILL }
1761     },
1762     { &hf_m3ua_cic_range_upper,
1763       { "Upper CIC value", "m3ua.cic_range_upper",
1764                FT_UINT16, BASE_DEC, NULL, 0x0,
1765                "", HFILL }
1766     },
1767     { &hf_m3ua_local_rk_identifier,
1768       { "Local routing key identifier", "m3ua.local_rk_identifier",
1769               FT_UINT32, BASE_DEC, NULL, 0x0,
1770               "", HFILL }
1771     },
1772     { &hf_m3ua_li,
1773       { "Length indicator", "m3ua.protocol_data_2_li",
1774               FT_UINT8, BASE_DEC, NULL, 0x0,
1775               "", HFILL }
1776     },
1777     { &hf_m3ua_protocol_data_opc,
1778       { "OPC", "m3ua.protocol_data_opc",
1779               FT_UINT32, BASE_DEC, NULL, 0x0,
1780               "", HFILL }
1781     },
1782     { &hf_m3ua_protocol_data_dpc,
1783       { "DPC", "m3ua.protocol_data_dpc",
1784               FT_UINT32, BASE_DEC, NULL, 0x0,
1785               "", HFILL }
1786     },
1787     { &hf_m3ua_protocol_data_si,
1788       { "SI", "m3ua.protocol_data_si",
1789               FT_UINT8, BASE_DEC, NULL, 0x0,
1790               "", HFILL }
1791     },
1792     { &hf_m3ua_protocol_data_ni,
1793       { "NI", "m3ua.protocol_data_ni",
1794               FT_UINT8, BASE_DEC, NULL, 0x0,
1795               "", HFILL }
1796     },
1797     { &hf_m3ua_protocol_data_mp,
1798       { "MP", "m3ua.protocol_data_mp",
1799               FT_UINT8, BASE_DEC, NULL, 0x0,
1800               "", HFILL }
1801     },
1802     { &hf_m3ua_protocol_data_sls,
1803       { "SLS", "m3ua.protocol_data_sls",
1804               FT_UINT8, BASE_DEC, NULL, 0x0,
1805               "", HFILL }
1806     },
1807     { &hf_m3ua_correlation_identifier,
1808       { "Correlation Identifier", "m3ua.correlation_identifier",
1809               FT_UINT32, BASE_DEC, NULL, 0x0,
1810               "", HFILL }
1811     },
1812     { &hf_m3ua_registration_status,
1813       { "Registration status", "m3ua.registration_status",
1814               FT_UINT32, BASE_DEC, VALS(m3ua_registration_status_values), 0x0,
1815               "", HFILL }
1816     },
1817     { &hf_m3ua_deregistration_status,
1818       { "Deregistration status", "m3ua.deregistration_status",
1819               FT_UINT32, BASE_DEC, VALS(m3ua_deregistration_status_values), 0x0,
1820               "", HFILL }
1821     },
1822     { &hf_m3ua_reason,
1823       { "Reason", "m3ua_reason",
1824         FT_UINT32, BASE_DEC, VALS(m3ua_reason_values), 0x0,
1825         "", HFILL }
1826     },
1827     { &hf_m3ua_traffic_mode_type,
1828       { "Traffic mode Type", "m3ua.traffic_mode_type",
1829               FT_UINT32, BASE_DEC, NULL, 0x0,
1830               "", HFILL }
1831     },
1832     { &hf_m3ua_registration_result_identifier,
1833       { "Local RK-identifier value", "m3ua.registration_result_identifier",
1834               FT_UINT32, BASE_DEC, NULL, 0x0,
1835               "", HFILL }
1836     },
1837     { &hf_m3ua_registration_result_status,
1838       { "Registration status", "m3ua.registration_results_status",
1839               FT_UINT32, BASE_DEC, VALS(m3ua_registration_result_status_values), 0x0,
1840               "", HFILL }
1841     },
1842     { &hf_m3ua_registration_result_context,
1843       { "Routing context", "m3ua.registration_result_routing_context",
1844               FT_UINT32, BASE_DEC, NULL, 0x0,
1845               "", HFILL }
1846     },
1847     { &hf_m3ua_deregistration_result_status,
1848       { "De-Registration status", "m3ua.deregistration_results_status",
1849               FT_UINT32, BASE_DEC, VALS(m3ua_deregistration_result_status_values), 0x0,
1850               "", HFILL }
1851     },
1852     { &hf_m3ua_deregistration_result_context,
1853       { "Routing context", "m3ua.deregistration_result_routing_context",
1854               FT_UINT32, BASE_DEC, NULL, 0x0,
1855               "", HFILL }
1856     },
1857   };
1858
1859   /* Setup protocol subtree array */
1860   static gint *ett[] = {
1861     &ett_m3ua,
1862     &ett_m3ua_parameter,
1863   };
1864
1865   static enum_val_t m3ua_options[] = {
1866     { "Internet Draft version 6",        M3UA_V6 },
1867     { "Internet Draft version 12",       M3UA_V12 },
1868     { NULL, 0 }
1869   };
1870
1871   /* Register the protocol name and description */
1872   proto_m3ua = proto_register_protocol("MTP 3 User Adaptation Layer", "M3UA",  "m3ua");
1873   m3ua_module = prefs_register_protocol(proto_m3ua, NULL);
1874   prefs_register_enum_preference(m3ua_module,
1875                                                          "version", "M3UA Version", "Internet Draft version used by Ethereal",
1876                                                          &m3ua_version, m3ua_options, FALSE);
1877
1878   /* Required function calls to register the header fields and subtrees used */
1879   proto_register_field_array(proto_m3ua, hf, array_length(hf));
1880   proto_register_subtree_array(ett, array_length(ett));
1881   m3ua_si_dissector_table = register_dissector_table("m3ua.protocol_data_si", "MTP3 Service indicator", FT_UINT8, BASE_HEX);
1882
1883 };
1884
1885 void
1886 proto_reg_handoff_m3ua(void)
1887 {
1888   dissector_handle_t m3ua_handle;
1889
1890   /*
1891    * Get a handle for the MTP3 dissector.
1892    */
1893   mtp3_handle = find_dissector("mtp3");
1894   data_handle = find_dissector("data");
1895   m3ua_handle = create_dissector_handle(dissect_m3ua, proto_m3ua);
1896   dissector_add("sctp.ppi",  M3UA_PAYLOAD_PROTO_ID, m3ua_handle);
1897   dissector_add("sctp.port", SCTP_PORT_M3UA, m3ua_handle);
1898 }