packet-m2ua.c

   1 /* packet-m2ua.c
   2  * Routines for MTP2 User Adaptation Layer dissection
   3  * It is hopefully (needs testing) compilant to
   4  * http://www.ietf.org/internet-drafts/draft-ietf-sigtran-m2ua-15.txt
   5  * To do: - clean up the code
   6  *        - provide better handling of length parameters
   7  *        - provide good information in summary window
   8  *
   9  * Copyright 2002, Michael Tuexen <Michael.Tuexen@icn.siemens.de>
  10  *
  11  * $Id: packet-m2ua.c,v 1.1 2002/04/14 22:52:49 guy Exp $
  12  *
  13  * Ethereal - Network traffic analyzer
  14  * By Gerald Combs <gerald@ethereal.com>
  15  * Copyright 1998 Gerald Combs
  16  *
  17  * Copied from README.developer
  18  *
  19  * This program is free software; you can redistribute it and/or
  20  * modify it under the terms of the GNU General Public License
  21  * as published by the Free Software Foundation; either version 2
  22  * of the License, or (at your option) any later version.
  23  *
  24  * This program is distributed in the hope that it will be useful,
  25  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  26  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  27  * GNU General Public License for more details.
  28  *
  29  * You should have received a copy of the GNU General Public License
  30  * along with this program; if not, write to the Free Software
  31  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  32  */
  33
  34 #ifdef HAVE_CONFIG_H
  35 # include "config.h"
  36 #endif
  37
  38 // #include <stdio.h>
  39 // #include <stdlib.h>
  40
  41 // #include <string.h>
  42 // #include <glib.h>
  43
  44 #include <epan/packet.h>
  45
  46 #define SCTP_PORT_M2UA         2904
  47 #define M2UA_PAYLOAD_PROTO_ID  2
  48
  49
  50
  51
  52 /* Initialize the protocol and registered fields */
  53 static int proto_m2ua = -1;
  54 static int hf_m2ua_version = -1;
  55 static int hf_m2ua_reserved = -1;
  56 static int hf_m2ua_message_class = -1;
  57 static int hf_m2ua_message_type = -1;
  58 static int hf_m2ua_message_length = -1;
  59 static int hf_m2ua_parameter_tag = -1;
  60 static int hf_m2ua_parameter_length = -1;
  61 static int hf_m2ua_parameter_value = -1;
  62 static int hf_m2ua_parameter_padding = -1;
  63 static int hf_m2ua_interface_id_int = -1;
  64 static int hf_m2ua_interface_id_text = -1;
  65 static int hf_m2ua_info_string = -1;
  66 static int hf_m2ua_diagnostic_information = -1;
  67 static int hf_m2ua_interface_id_start = -1;
  68 static int hf_m2ua_interface_id_stop = -1;
  69 static int hf_m2ua_heartbeat_data = -1;
  70 static int hf_m2ua_traffic_mode_type = -1;
  71 static int hf_m2ua_error_code = -1;
  72 static int hf_m2ua_status_type = -1;
  73 static int hf_m2ua_status_info = -1;
  74 static int hf_m2ua_asp_id = -1;
  75 static int hf_m2ua_correlation_id = -1;
  76 static int hf_m2ua_data_2_li = -1;
  77 static int hf_m2ua_state = -1;
  78 static int hf_m2ua_event = -1;
  79 static int hf_m2ua_congestion_status = -1;
  80 static int hf_m2ua_discard_status = -1;
  81 static int hf_m2ua_action = -1;
  82 static int hf_m2ua_sequence_number = -1;
  83 static int hf_m2ua_retrieval_result = -1;
  84 static int hf_m2ua_local_lk_id = -1;
  85 static int hf_m2ua_sdt_reserved = -1;
  86 static int hf_m2ua_sdt_id = -1;
  87 static int hf_m2ua_sdl_reserved = -1;
  88 static int hf_m2ua_sdl_id = -1;
  89 static int hf_m2ua_registration_status = -1;
  90 static int hf_m2ua_deregistration_status = -1;
  91
  92 /* Initialize the subtree pointers */
  93 static gint ett_m2ua = -1;
  94 static gint ett_m2ua_parameter = -1;
  95
  96 static dissector_handle_t mtp3_handle;
  97
  98 static void
  99 dissect_m2ua_parameters(tvbuff_t *, packet_info *, proto_tree *, proto_tree *);
 100
 101 static guint
 102 nr_of_padding_bytes (guint length)
 103 {
 104   guint remainder;
 105
 106   remainder = length % 4;
 107
 108   if (remainder == 0)
 109     return 0;
 110   else
 111     return 4 - remainder;
 112 }
 113
 114 #define VERSION_LENGTH         1
 115 #define RESERVED_LENGTH        1
 116 #define MESSAGE_CLASS_LENGTH   1
 117 #define MESSAGE_TYPE_LENGTH    1
 118 #define MESSAGE_LENGTH_LENGTH  4
 119 #define COMMON_HEADER_LENGTH   (VERSION_LENGTH + RESERVED_LENGTH + MESSAGE_CLASS_LENGTH + \
 120                                 MESSAGE_TYPE_LENGTH + MESSAGE_LENGTH_LENGTH)
 121
 122 #define VERSION_OFFSET         0
 123 #define RESERVED_OFFSET        (VERSION_OFFSET + VERSION_LENGTH)
 124 #define MESSAGE_CLASS_OFFSET   (RESERVED_OFFSET + RESERVED_LENGTH)
 125 #define MESSAGE_TYPE_OFFSET    (MESSAGE_CLASS_OFFSET + MESSAGE_CLASS_LENGTH)
 126 #define MESSAGE_LENGTH_OFFSET  (MESSAGE_TYPE_OFFSET + MESSAGE_TYPE_LENGTH)
 127
 128 #define PROTOCOL_VERSION_RELEASE_1             1
 129
 130 static const value_string m2ua_protocol_version_values[] = {
 131   { PROTOCOL_VERSION_RELEASE_1,  "Release 1" },
 132   { 0,                           NULL } };
 133
 134 #define MESSAGE_CLASS_MGMT_MESSAGE         0
 135 #define MESSAGE_CLASS_ASPSM_MESSAGE        3
 136 #define MESSAGE_CLASS_ASPTM_MESSAGE        4
 137 #define MESSAGE_CLASS_MAUP_MESSAGE         6
 138 #define MESSAGE_CLASS_IIM_MESSAGE         10
 139
 140 static const value_string m2ua_message_class_values[] = {
 141   { MESSAGE_CLASS_MGMT_MESSAGE,   "Management messages" },
 142   { MESSAGE_CLASS_ASPSM_MESSAGE,  "ASP state maintenance messages" },
 143   { MESSAGE_CLASS_ASPTM_MESSAGE,  "ASP traffic maintenance messages" },
 144   { MESSAGE_CLASS_MAUP_MESSAGE,   "MTP2 user adaptation messages" },
 145   { MESSAGE_CLASS_IIM_MESSAGE,    "Interface identifier management messages" },
 146   { 0,                            NULL } };
 147
 148 /* MGMT */
 149 #define MESSAGE_TYPE_ERR                  0
 150 #define MESSAGE_TYPE_NTFY                 1
 151
 152 /* ASPSM */
 153 #define MESSAGE_TYPE_UP                   1
 154 #define MESSAGE_TYPE_DOWN                 2
 155 #define MESSAGE_TYPE_BEAT                 3
 156 #define MESSAGE_TYPE_UP_ACK               4
 157 #define MESSAGE_TYPE_DOWN_ACK             5
 158 #define MESSAGE_TYPE_BEAT_ACK             6
 159
 160 /* ASPTM */
 161 #define MESSAGE_TYPE_ACTIVE               1
 162 #define MESSAGE_TYPE_INACTIVE             2
 163 #define MESSAGE_TYPE_ACTIVE_ACK           3
 164 #define MESSAGE_TYPE_INACTIVE_ACK         4
 165
 166 /* MAUP */
 167 #define MESSAGE_TYPE_DATA                 1
 168 #define MESSAGE_TYPE_ESTAB_REQ            2
 169 #define MESSAGE_TYPE_ESTAB_CONF           3
 170 #define MESSAGE_TYPE_REL_REQ              4
 171 #define MESSAGE_TYPE_REL_CONF             5
 172 #define MESSAGE_TYPE_REL_IND              6
 173 #define MESSAGE_TYPE_STATE_REQ            7
 174 #define MESSAGE_TYPE_STATE_CONF           8
 175 #define MESSAGE_TYPE_STATE_IND            9
 176 #define MESSAGE_TYPE_DATA_RETR_REQ       10
 177 #define MESSAGE_TYPE_DATA_RETR_CONF      11
 178 #define MESSAGE_TYPE_DATA_RETR_IND       12
 179 #define MESSAGE_TYPE_DATA_RETR_COMP_IND  13
 180 #define MESSAGE_TYPE_CONG_IND            14
 181 #define MESSAGE_TYPE_DATA_ACK            15
 182
 183 /* IIM */
 184 #define MESSAGE_TYPE_REG_REQ              1
 185 #define MESSAGE_TYPE_REG_RSP              2
 186 #define MESSAGE_TYPE_DEREG_REQ            3
 187 #define MESSAGE_TYPE_DEREG_RSP            4
 188
 189 static const value_string m2ua_message_class_type_values[] = {
 190   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,                "Error (ERR)" },
 191   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,               "Notify (NTFY)" },
 192   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,                 "ASP up (UP)" },
 193   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,               "ASP down (DOWN)" },
 194   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,               "Heartbeat (BEAT)" },
 195   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,             "ASP up ack (UP ACK)" },
 196   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,           "ASP down ack (DOWN ACK)" },
 197   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,           "Heartbeat ack (BEAT ACK)" },
 198   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,            "ASP active (ACTIVE)" },
 199   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,          "ASP inactive (INACTIVE)" },
 200   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,        "ASP active ack (ACTIVE ACK)" },
 201   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK ,      "ASP inactive ack (INACTIVE ACK)" },
 202   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA,               "DATA (DATA)" },
 203   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_ESTAB_REQ,          "Establish request (ESTAB_REQ)" },
 204   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_ESTAB_CONF,         "Establish confirm (ESTAB_CONF)" },
 205   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_REQ,            "Release request (REL_REQ)" },
 206   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_CONF,           "Release confirm (REL_CONF)" },
 207   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_IND,            "Release indication (REL_IND)" },
 208   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_REQ,          "State request (STATE_REQ)" },
 209   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_CONF,         "State confirm (STATE_CONF)" },
 210   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_IND,          "State indication (STATE_IND)" },
 211   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_REQ,      "Data retrieval request (DATA_RETR_REQ)" },
 212   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_CONF,     "Data retrieval confirm (DATA_RETR_CONF)" },
 213   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_IND,      "Data retrieval indication (DATA_RETR_IND)" },
 214   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_COMP_IND, "Data retrieval complete indication (DATA_RETR_COMP_IND)" },
 215   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_CONG_IND,           "Congestion indication (CONG_IND)" },
 216   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_ACK,           "Data acknowledge (DATA_ACK)" },
 217   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_REG_REQ ,           "Registration request (REG_REQ)" },
 218   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_REG_RSP ,           "Registration response (REG_RSP)" },
 219   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_REQ ,         "Deregistration request (DEREG_REQ)" },
 220   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_RSP ,         "Deregistration response (DEREG_RSP)" },
 221   { 0,                           NULL } };
 222
 223 static const value_string m2ua_message_class_type_acro_values[] = {
 224   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,                "ERR" },
 225   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,               "NTFY" },
 226   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,                 "ASP_UP" },
 227   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,               "ASP_DOWN" },
 228   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,               "BEAT" },
 229   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,             "ASP_UP_ACK" },
 230   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,           "ASP_DOWN_ACK" },
 231   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,           "BEAT_ACK" },
 232   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,            "ASP_ACTIVE" },
 233   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,          "ASP_INACTIVE" },
 234   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,        "ASP_ACTIVE_ACK" },
 235   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK ,      "ASP_INACTIVE_ACK" },
 236   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA,               "DATA" },
 237   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_ESTAB_REQ,          "ESTAB_REQ" },
 238   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_ESTAB_CONF,         "ESTAB_CONF" },
 239   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_REQ,            "REL_REQ" },
 240   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_CONF,           "REL_CONF" },
 241   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_IND,            "REL_IND" },
 242   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_REQ,          "STATE_REQ" },
 243   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_CONF,         "STATE_CONF" },
 244   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_IND,          "STATE_IND" },
 245   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_REQ,      "DATA_RETR_REQ" },
 246   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_CONF,     "DATA_RETR_CONF" },
 247   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_IND,      "DATA_RETR_IND" },
 248   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_COMP_IND, "DATA_RETR_COMP_IND" },
 249   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_CONG_IND,           "CONG_IND" },
 250   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_ACK,           "DATA_ACK" },
 251   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_REG_REQ ,           "REG_REQ" },
 252   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_REG_RSP ,           "REG_RSP" },
 253   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_REQ ,         "DEREG_REQ" },
 254   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_RSP ,         "DEREG_RSP" },
 255   { 0,                           NULL } };
 256
 257 static void
 258 dissect_m2ua_common_header(tvbuff_t *common_header_tvb, packet_info *pinfo, proto_tree *m2ua_tree)
 259 {
 260   guint8  version, reserved, message_class, message_type;
 261   guint32 message_length;
 262
 263   /* Extract the common header */
 264   version        = tvb_get_guint8(common_header_tvb, VERSION_OFFSET);
 265   reserved       = tvb_get_guint8(common_header_tvb, RESERVED_OFFSET);
 266   message_class  = tvb_get_guint8(common_header_tvb, MESSAGE_CLASS_OFFSET);
 267   message_type   = tvb_get_guint8(common_header_tvb, MESSAGE_TYPE_OFFSET);
 268   message_length = tvb_get_ntohl (common_header_tvb, MESSAGE_LENGTH_OFFSET);
 269
 270   if (check_col(pinfo->cinfo, COL_INFO)) {
 271     col_append_str(pinfo->cinfo, COL_INFO, val_to_str(message_class * 256 + message_type, m2ua_message_class_type_acro_values, "reserved"));
 272     col_append_str(pinfo->cinfo, COL_INFO, " ");
 273   }
 274
 275   if (m2ua_tree) {
 276     /* add the components of the common header to the protocol tree */
 277     proto_tree_add_uint(m2ua_tree, hf_m2ua_version, common_header_tvb, VERSION_OFFSET, VERSION_LENGTH, version);
 278     proto_tree_add_uint(m2ua_tree, hf_m2ua_reserved, common_header_tvb, RESERVED_OFFSET, RESERVED_LENGTH, reserved);
 279     proto_tree_add_uint(m2ua_tree, hf_m2ua_message_class, common_header_tvb, MESSAGE_CLASS_OFFSET, MESSAGE_CLASS_LENGTH, message_class);
 280     proto_tree_add_uint_format(m2ua_tree, hf_m2ua_message_type, common_header_tvb, MESSAGE_TYPE_OFFSET, MESSAGE_TYPE_LENGTH, message_type,
 281                                "Message type: %s (%u)",
 282                                val_to_str(message_class * 256 + message_type, m2ua_message_class_type_values, "reserved"), message_type);
 283     proto_tree_add_uint(m2ua_tree, hf_m2ua_message_length, common_header_tvb, MESSAGE_LENGTH_OFFSET, MESSAGE_LENGTH_LENGTH, message_length);
 284   }
 285 }
 286
 287 #define PARAMETER_TAG_LENGTH    2
 288 #define PARAMETER_LENGTH_LENGTH 2
 289 #define PARAMETER_HEADER_LENGTH (PARAMETER_TAG_LENGTH + PARAMETER_LENGTH_LENGTH)
 290
 291 #define PARAMETER_TAG_OFFSET    0
 292 #define PARAMETER_LENGTH_OFFSET (PARAMETER_TAG_OFFSET + PARAMETER_TAG_LENGTH)
 293 #define PARAMETER_VALUE_OFFSET  (PARAMETER_LENGTH_OFFSET + PARAMETER_LENGTH_LENGTH)
 294 #define PARAMETER_HEADER_OFFSET PARAMETER_TAG_OFFSET
 295
 296
 297 #define INTERFACE_IDENTIFIER_INT_LENGTH 4
 298 #define INTERFACE_IDENTIFIER_INT_OFFSET PARAMETER_VALUE_OFFSET
 299
 300 static void
 301 dissect_m2ua_interface_identifier_int_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 302 {
 303   guint32 id;
 304
 305   id = tvb_get_ntohl(parameter_tvb, INTERFACE_IDENTIFIER_INT_OFFSET);
 306   proto_tree_add_uint(parameter_tree, hf_m2ua_interface_id_int, parameter_tvb, INTERFACE_IDENTIFIER_INT_OFFSET, INTERFACE_IDENTIFIER_INT_LENGTH, id);
 307   proto_item_set_text(parameter_item, "Interface identifier parameter (integer: %u)", id);
 308 }
 309
 310 #define INTERFACE_IDENTIFIER_TEXT_OFFSET PARAMETER_VALUE_OFFSET
 311
 312 static void
 313 dissect_m2ua_interface_identifier_text_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 314 {
 315   guint16 length, id_length;
 316   char *id;
 317
 318   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 319
 320   id_length = length - PARAMETER_HEADER_LENGTH;
 321   id        = (char *)tvb_get_ptr(parameter_tvb, INTERFACE_IDENTIFIER_TEXT_OFFSET, id_length);
 322   proto_tree_add_string(parameter_tree, hf_m2ua_interface_id_text, parameter_tvb, INTERFACE_IDENTIFIER_TEXT_OFFSET, id_length, id);
 323   proto_item_set_text(parameter_item, "Interface identifier (Text: %.*s)", id_length, id);
 324 }
 325
 326 #define INFO_STRING_OFFSET PARAMETER_VALUE_OFFSET
 327
 328 static void
 329 dissect_m2ua_info_string_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 330 {
 331   guint16 length, info_string_length;
 332   char *info_string;
 333
 334   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 335
 336   info_string_length = length - PARAMETER_HEADER_LENGTH;
 337   info_string        = (char *)tvb_get_ptr(parameter_tvb, INFO_STRING_OFFSET, info_string_length);
 338   proto_tree_add_string(parameter_tree, hf_m2ua_info_string, parameter_tvb, INFO_STRING_OFFSET, info_string_length, info_string);
 339   proto_item_set_text(parameter_item, "Info String (%.*s)", info_string_length, info_string);
 340 }
 341
 342 #define DIAGNOSTIC_INFO_OFFSET PARAMETER_VALUE_OFFSET
 343
 344 static void
 345 dissect_m2ua_diagnostic_information_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 346 {
 347   guint16 length, diagnostic_info_length;
 348
 349   length                 = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 350   diagnostic_info_length = length - PARAMETER_HEADER_LENGTH;
 351
 352   if (diagnostic_info_length > 0)
 353     proto_tree_add_bytes(parameter_tree, hf_m2ua_diagnostic_information, parameter_tvb, DIAGNOSTIC_INFO_OFFSET, diagnostic_info_length,
 354                          tvb_get_ptr(parameter_tvb, DIAGNOSTIC_INFO_OFFSET, diagnostic_info_length));
 355
 356   proto_item_set_text(parameter_item, "Diagnostic information (%u byte%s)", diagnostic_info_length, plurality(diagnostic_info_length, "", "s"));
 357 }
 358
 359 #define START_OFFSET 0
 360 #define STOP_OFFSET  (START_OFFSET + INTERFACE_IDENTIFIER_INT_LENGTH)
 361
 362 static void
 363 dissect_m2ua_interface_identifier_range_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 364 {
 365   guint16 length, number_of_ranges, range_number;
 366   guint32 start, stop;
 367   gint range_offset;
 368
 369   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 370   number_of_ranges = (length - PARAMETER_HEADER_LENGTH) / (2 * INTERFACE_IDENTIFIER_INT_LENGTH);
 371   range_offset = PARAMETER_VALUE_OFFSET;
 372   for(range_number=1; range_number <= number_of_ranges; range_number++) {
 373     start = tvb_get_ntohl(parameter_tvb, range_offset + START_OFFSET);
 374     stop  = tvb_get_ntohl(parameter_tvb, range_offset + STOP_OFFSET);
 375     proto_tree_add_uint(parameter_tree, hf_m2ua_interface_id_start, parameter_tvb, range_offset + START_OFFSET, INTERFACE_IDENTIFIER_INT_LENGTH, start);
 376     proto_tree_add_uint(parameter_tree, hf_m2ua_interface_id_stop,  parameter_tvb, range_offset + STOP_OFFSET,  INTERFACE_IDENTIFIER_INT_LENGTH, stop);
 377     range_offset += 2 * INTERFACE_IDENTIFIER_INT_LENGTH;
 378   }
 379   proto_item_set_text(parameter_item, "Interface identifier (%u range%s)", number_of_ranges, plurality(number_of_ranges, "", "s"));
 380 }
 381
 382 #define HEARTBEAT_DATA_OFFSET PARAMETER_VALUE_OFFSET
 383
 384 static void
 385 dissect_m2ua_heartbeat_data_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 386 {
 387   guint16 length, heartbeat_data_length;
 388
 389   length                = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 390   heartbeat_data_length = length - PARAMETER_HEADER_LENGTH;
 391
 392   if (heartbeat_data_length > 0)
 393     proto_tree_add_bytes(parameter_tree, hf_m2ua_heartbeat_data, parameter_tvb, HEARTBEAT_DATA_OFFSET, heartbeat_data_length,
 394                          tvb_get_ptr(parameter_tvb, HEARTBEAT_DATA_OFFSET, heartbeat_data_length));
 395
 396   proto_item_set_text(parameter_item, "Heartbeat data (%u byte%s)", heartbeat_data_length, plurality(heartbeat_data_length, "", "s"));
 397 }
 398
 399 #define OVER_RIDE_TYPE   1
 400 #define LOAD_SHARE_TYPE  2
 401 #define BROADCAST_TYPE   3
 402
 403 static const value_string m2ua_traffic_mode_type_values[] = {
 404   { OVER_RIDE_TYPE ,                             "Over-ride" },
 405   { LOAD_SHARE_TYPE,                             "Load-share" },
 406   { BROADCAST_TYPE,                              "Broadcast" },
 407   {0,                           NULL } };
 408
 409 #define TRAFFIC_MODE_TYPE_LENGTH 4
 410 #define TRAFFIC_MODE_TYPE_OFFSET PARAMETER_VALUE_OFFSET
 411
 412 static void
 413 dissect_m2ua_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 414 {
 415   guint32 traffic_mode_type;
 416
 417   traffic_mode_type = tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET);
 418   proto_tree_add_uint(parameter_tree, hf_m2ua_traffic_mode_type, parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH, traffic_mode_type);
 419
 420   proto_item_set_text(parameter_item, "Traffic mode type parameter (%s)", val_to_str(traffic_mode_type, m2ua_traffic_mode_type_values, "unknown"));
 421
 422 }
 423
 424 #define INVALID_VERSION_ERROR_CODE                       0x01
 425 #define INVALID_INTERFACE_IDENTIFIER_ERROR_CODE          0x02
 426 #define UNSUPPORTED_MESSAGE_CLASS_ERROR_CODE             0x03
 427 #define UNSUPPORTED_MESSAGE_TYPE_ERROR_CODE              0x04
 428 #define UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR_CODE     0x05
 429 #define UNEXPECTED_MESSAGE_ERROR_CODE                    0x06
 430 #define PROTOCOL_ERROR_ERROR_CODE                        0x07
 431 #define UNSUPPORTED_INTERFACE_IDENTIFIER_TYPE_ERROR_CODE 0x08
 432 #define INVALID_STREAM_IDENTIFIER_ERROR_CODE             0x09
 433 #define REFUSED_ERROR_CODE                               0x0d
 434 #define ASP_IDENTIFIER_REQUIRED_ERROR_CODE               0x0e
 435 #define INVALID_ASP_IDENTIFIER_ERROR_CODE                0x0f
 436 #define ASP_ACTIVE_FOR_INTERFACE_IDENTIFIER_ERROR_CODE   0x10
 437 #define INVALID_PARAMETER_VALUE_ERROR_CODE               0x11
 438 #define PARAMETER_FIELD_ERROR_CODE                       0x12
 439 #define UNEXPECTED_PARAMETER_ERROR_CODE                  0x13
 440 #define MISSING_PARAMETER_ERROR_CODE                     0x16
 441
 442 static const value_string m2ua_error_code_values[] = {
 443   { INVALID_VERSION_ERROR_CODE,                       "Invalid version" },
 444   { INVALID_INTERFACE_IDENTIFIER_ERROR_CODE,          "Invalid interface identifier" },
 445   { UNSUPPORTED_MESSAGE_CLASS_ERROR_CODE,             "Unsupported message class" },
 446   { UNSUPPORTED_MESSAGE_TYPE_ERROR_CODE,              "Unsupported message type" },
 447   { UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR_CODE,     "Unsupported traffic handling mode" },
 448   { UNEXPECTED_MESSAGE_ERROR_CODE,                    "Unexpected message" },
 449   { PROTOCOL_ERROR_ERROR_CODE,                        "Protocol error" },
 450   { UNSUPPORTED_INTERFACE_IDENTIFIER_TYPE_ERROR_CODE, "Unsupported interface identifertype" },
 451   { INVALID_STREAM_IDENTIFIER_ERROR_CODE,             "Invalid stream identifier" },
 452   { REFUSED_ERROR_CODE,                               "Refused - management blocking" },
 453   { ASP_IDENTIFIER_REQUIRED_ERROR_CODE,               "ASP identifier required" },
 454   { INVALID_ASP_IDENTIFIER_ERROR_CODE,                "Invalid ASP identifier" },
 455   { ASP_ACTIVE_FOR_INTERFACE_IDENTIFIER_ERROR_CODE,   "ASP active for interface identifer" },
 456   { INVALID_PARAMETER_VALUE_ERROR_CODE,               "Invalid parameter value" },
 457   { PARAMETER_FIELD_ERROR_CODE,                       "Parameter field error" },
 458   { UNEXPECTED_PARAMETER_ERROR_CODE,                  "Unexpected parameter" },
 459   { MISSING_PARAMETER_ERROR_CODE,                     "Missing parameter" },
 460   { 0,                                                NULL } };
 461
 462 #define ERROR_CODE_LENGTH 4
 463 #define ERROR_CODE_OFFSET PARAMETER_VALUE_OFFSET
 464
 465 static void
 466 dissect_m2ua_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 467 {
 468   guint32 error_code;
 469
 470   error_code = tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET);
 471   proto_tree_add_uint(parameter_tree, hf_m2ua_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, error_code);
 472   proto_item_set_text(parameter_item, "Error code parameter (%s)", val_to_str(error_code, m2ua_error_code_values, "unknown"));
 473 }
 474
 475 #define AS_STATE_CHANGE_TYPE       1
 476 #define OTHER_TYPE                 2
 477
 478 static const value_string m2ua_status_type_values[] = {
 479   { AS_STATE_CHANGE_TYPE,            "Application server state change" },
 480   { OTHER_TYPE,                      "Other" },
 481   { 0,                           NULL } };
 482
 483 #define RESERVED_INFO              1
 484 #define AS_INACTIVE_INFO           2
 485 #define AS_ACTIVE_INFO             3
 486 #define AS_PENDING_INFO            4
 487
 488 #define INSUFFICIENT_ASP_RES_INFO  1
 489 #define ALTERNATE_ASP_ACTIVE_INFO  2
 490 #define ASP_FAILURE_INFO           3
 491
 492 static const value_string m2ua_status_type_info_values[] = {
 493   { AS_STATE_CHANGE_TYPE * 256 * 256 + RESERVED_INFO,             "Reserved" },
 494   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_INACTIVE_INFO,          "Application server inactive" },
 495   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_ACTIVE_INFO,            "Application server active" },
 496   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_PENDING_INFO,           "Application server pending" },
 497   { OTHER_TYPE           * 256 * 256 + INSUFFICIENT_ASP_RES_INFO, "Insufficient ASP resources active in AS" },
 498   { OTHER_TYPE           * 256 * 256 + ALTERNATE_ASP_ACTIVE_INFO, "Alternate ASP active" },
 499   { OTHER_TYPE           * 256 * 256 + ASP_FAILURE_INFO,          "ASP Failure" },
 500   {0,                           NULL } };
 501
 502 #define STATUS_TYPE_LENGTH 2
 503 #define STATUS_INFO_LENGTH 2
 504
 505 #define STATUS_TYPE_OFFSET PARAMETER_VALUE_OFFSET
 506 #define STATUS_INFO_OFFSET (STATUS_TYPE_OFFSET + STATUS_TYPE_LENGTH)
 507
 508 static void
 509 dissect_m2ua_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 510 {
 511   guint16 status_type, status_info;
 512
 513   status_type = tvb_get_ntohs(parameter_tvb, STATUS_TYPE_OFFSET);
 514   status_info = tvb_get_ntohs(parameter_tvb, STATUS_INFO_OFFSET);
 515
 516   proto_tree_add_uint(parameter_tree, hf_m2ua_status_type, parameter_tvb, STATUS_TYPE_OFFSET, STATUS_TYPE_LENGTH, status_type);
 517   proto_tree_add_uint_format(parameter_tree, hf_m2ua_status_info, parameter_tvb, STATUS_INFO_OFFSET, STATUS_INFO_LENGTH, status_info,
 518                              "Status info: %s (%u)", val_to_str(status_type * 256 * 256 + status_info, m2ua_status_type_info_values, "unknown"), status_info);
 519
 520   proto_item_set_text(parameter_item,
 521                       "Status type / ID (%s)", val_to_str(status_type * 256 * 256 + status_info, m2ua_status_type_info_values, "unknown status information"));
 522 }
 523
 524 #define ASP_IDENTIFIER_OFFSET PARAMETER_VALUE_OFFSET
 525 #define ASP_IDENTIFIER_LENGTH  4
 526
 527 static void
 528 dissect_m2ua_asp_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 529 {
 530   guint32 id;
 531
 532   id = tvb_get_ntohl(parameter_tvb, ASP_IDENTIFIER_OFFSET);
 533   proto_tree_add_uint(parameter_tree, hf_m2ua_asp_id, parameter_tvb, ASP_IDENTIFIER_OFFSET, ASP_IDENTIFIER_LENGTH, id);
 534   proto_item_set_text(parameter_item, "ASP identifier (%u)", id);
 535 }
 536
 537 #define CORRELATION_ID_LENGTH 4
 538 #define CORRELATION_ID_OFFSET PARAMETER_VALUE_OFFSET
 539
 540 static void
 541 dissect_m2ua_correlation_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 542 {
 543   guint32 id;
 544
 545   id = tvb_get_ntohl(parameter_tvb, CORRELATION_ID_OFFSET);
 546   proto_tree_add_uint(parameter_tree, hf_m2ua_correlation_id, parameter_tvb, CORRELATION_ID_OFFSET, CORRELATION_ID_LENGTH, id);
 547
 548   proto_item_set_text(parameter_item, "Correlation identifier parameter (%u)", id);
 549 }
 550
 551 #define DATA_1_MTP3_OFFSET PARAMETER_VALUE_OFFSET
 552
 553 static void
 554 dissect_m2ua_protocol_data_1_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 555 {
 556   tvbuff_t *payload_tvb;
 557   guint32 payload_length;
 558
 559   payload_length = tvb_length(parameter_tvb) - PARAMETER_HEADER_LENGTH;
 560
 561   payload_tvb = tvb_new_subset(parameter_tvb, DATA_1_MTP3_OFFSET, payload_length, payload_length);
 562   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH);
 563   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
 564
 565   proto_item_set_text(parameter_item, "Data 1 parameter");
 566 }
 567
 568 #define DATA_2_LI_LENGTH   1
 569 #define DATA_2_LI_OFFSET   PARAMETER_VALUE_OFFSET
 570 #define DATA_2_MTP3_OFFSET (DATA_2_LI_OFFSET + DATA_2_LI_LENGTH)
 571
 572 static void
 573 dissect_m2ua_protocol_data_2_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 574 {
 575   tvbuff_t *payload_tvb;
 576   guint32 payload_length;
 577   guint8  li;
 578
 579   payload_length = tvb_length(parameter_tvb) - PARAMETER_HEADER_LENGTH - DATA_2_LI_LENGTH;
 580   li = tvb_get_guint8(parameter_tvb, DATA_2_LI_OFFSET);
 581
 582   proto_tree_add_uint(parameter_tree, hf_m2ua_data_2_li, parameter_tvb, DATA_2_LI_OFFSET, DATA_2_LI_LENGTH, li);
 583   payload_tvb = tvb_new_subset(parameter_tvb, DATA_2_MTP3_OFFSET, payload_length, payload_length);
 584   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH + DATA_2_LI_LENGTH);
 585   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
 586
 587   proto_item_set_text(parameter_item, "Data 2 parameter");
 588 }
 589
 590
 591 #define STATUS_LPO_SET          0x0
 592 #define STATUS_LPO_CLEAR        0x1
 593 #define STATUS_EMER_SET         0x2
 594 #define STATUS_EMER_CLEAR       0x3
 595 #define STATUS_FLUSH_BUFFERS    0x4
 596 #define STATUS_CONTINUE         0x5
 597 #define STATUS_CLEAR_RTB        0x6
 598 #define STATUS_AUDIT            0x7
 599 #define STATUS_CONG_CLEAR       0x8
 600 #define STATUS_CONG_ACCEPT      0x9
 601 #define STATUS_CONG_DISCARD     0xa
 602
 603 static const value_string m2ua_state_values[] = {
 604   { STATUS_LPO_SET,        "Request local processor outage" },
 605   { STATUS_LPO_CLEAR,      "Request local processor outage recovered" },
 606   { STATUS_EMER_SET,       "Request emergency alignment" },
 607   { STATUS_EMER_CLEAR,     "Request normal alignment (cancel emergency)" },
 608   { STATUS_FLUSH_BUFFERS,  "Flush or clear receive, transmit and retransmit queues" },
 609   { STATUS_CONTINUE,       "Continue or Resume" },
 610   { STATUS_CLEAR_RTB,      "Clear the retransmit queue" },
 611   { STATUS_AUDIT,          "Audit state of link" },
 612   { STATUS_CONG_CLEAR,     "Congestion cleared" },
 613   { STATUS_CONG_ACCEPT,    "Congestion accept" },
 614   { STATUS_CONG_DISCARD,   "Congestion discard" },
 615   {0,                       NULL } };
 616
 617 #define STATE_LENGTH 4
 618 #define STATE_OFFSET PARAMETER_VALUE_OFFSET
 619
 620 static void
 621 dissect_m2ua_state_request_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 622 {
 623   guint32 state;
 624
 625   state = tvb_get_ntohl(parameter_tvb, STATE_OFFSET);
 626   proto_tree_add_uint(parameter_tree, hf_m2ua_state, parameter_tvb, STATE_OFFSET, STATE_LENGTH, state);
 627
 628   proto_item_set_text(parameter_item, "State request parameter (%s)", val_to_str(state, m2ua_state_values, "unknown"));
 629 }
 630
 631 #define EVENT_RPO_ENTER        0x1
 632 #define EVENT_RPO_EXIT         0x2
 633 #define EVENT_LPO_ENTER        0x3
 634 #define EVENT_LPO_EXIT         0x4
 635
 636 static const value_string m2ua_event_values[] = {
 637   { EVENT_RPO_ENTER, "Remote entered processor outage" },
 638   { EVENT_RPO_EXIT,  "Remote exited processor outage" },
 639   { EVENT_LPO_ENTER, "Link entered processor outage" },
 640   { EVENT_LPO_EXIT,  "Link exited processor outage" },
 641   {0,                NULL } };
 642
 643 #define EVENT_LENGTH 4
 644 #define EVENT_OFFSET PARAMETER_VALUE_OFFSET
 645
 646 static void
 647 dissect_m2ua_event_request_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 648 {
 649   guint32 event;
 650
 651   event = tvb_get_ntohl(parameter_tvb, STATE_OFFSET);
 652   proto_tree_add_uint(parameter_tree, hf_m2ua_event, parameter_tvb, EVENT_OFFSET, EVENT_LENGTH, event);
 653
 654   proto_item_set_text(parameter_item, "State event parameter (%s)", val_to_str(event, m2ua_event_values, "unknown"));
 655 }
 656
 657 #define LEVEL_NONE       0x0
 658 #define LEVEL_1          0x1
 659 #define LEVEL_2          0x2
 660 #define LEVEL_3          0x3
 661
 662 static const value_string m2ua_level_values[] = {
 663   { LEVEL_NONE, "No congestion" },
 664   { LEVEL_1,    "Congestion Level 1" },
 665   { LEVEL_2,    "Congestion Level 2" },
 666   { LEVEL_3,    "Congestion Level 3" },
 667   {0,           NULL } };
 668
 669 #define CONGESTION_STATUS_LENGTH 4
 670 #define CONGESTION_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 671
 672 static void
 673 dissect_m2ua_congestion_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 674 {
 675   guint32 status;
 676
 677   status = tvb_get_ntohl(parameter_tvb, CONGESTION_STATUS_OFFSET);
 678   proto_tree_add_uint(parameter_tree, hf_m2ua_congestion_status, parameter_tvb, CONGESTION_STATUS_OFFSET, CONGESTION_STATUS_LENGTH, status);
 679
 680   proto_item_set_text(parameter_item, "Congestion status parameter (%s)", val_to_str(status, m2ua_level_values, "unknown"));
 681 }
 682
 683 #define DISCARD_STATUS_LENGTH 4
 684 #define DISCARD_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 685
 686 static void
 687 dissect_m2ua_discard_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 688 {
 689   guint32 status;
 690
 691   status = tvb_get_ntohl(parameter_tvb, DISCARD_STATUS_OFFSET);
 692   proto_tree_add_uint(parameter_tree, hf_m2ua_discard_status, parameter_tvb, DISCARD_STATUS_OFFSET, DISCARD_STATUS_LENGTH, status);
 693
 694   proto_item_set_text(parameter_item, "Discard status parameter (%s)", val_to_str(status, m2ua_level_values, "unknown"));
 695 }
 696
 697 #define ACTION_RTRV_BSN      0x1
 698 #define ACTION_RTRV_MSGS     0x2
 699
 700 static const value_string m2ua_action_values[] = {
 701   { ACTION_RTRV_BSN,  "Retrieve the backward sequence number" },
 702   { ACTION_RTRV_MSGS, "Retrieve the PDUs from the transmit and retransmit queues" },
 703   {0,                  NULL } };
 704
 705
 706 #define ACTION_LENGTH 4
 707 #define ACTION_OFFSET PARAMETER_VALUE_OFFSET
 708
 709 static void
 710 dissect_m2ua_action_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 711 {
 712   guint32 action;
 713
 714   action = tvb_get_ntohl(parameter_tvb, ACTION_OFFSET);
 715   proto_tree_add_uint(parameter_tree, hf_m2ua_action, parameter_tvb, ACTION_OFFSET, ACTION_LENGTH, action);
 716
 717   proto_item_set_text(parameter_item, "Action parameter (%s)", val_to_str(action, m2ua_action_values, "unknown"));
 718 }
 719
 720 #define SEQUENCE_NUMBER_LENGTH 4
 721 #define SEQUENCE_NUMBER_OFFSET PARAMETER_VALUE_OFFSET
 722
 723 static void
 724 dissect_m2ua_sequence_number_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 725 {
 726   guint32 number;
 727
 728   number = tvb_get_ntohl(parameter_tvb, SEQUENCE_NUMBER_OFFSET);
 729   proto_tree_add_uint(parameter_tree, hf_m2ua_sequence_number, parameter_tvb, SEQUENCE_NUMBER_OFFSET, SEQUENCE_NUMBER_LENGTH, number);
 730
 731   proto_item_set_text(parameter_item, "Sequence number parameter (%u)", number);
 732 }
 733
 734 #define RESULT_SUCCESS       0x0
 735 #define RESULT_FAILURE       0x1
 736
 737 static const value_string m2ua_retrieval_result_values[] = {
 738   { RESULT_SUCCESS,    "Action successful" },
 739   { RESULT_FAILURE ,   "Action failed" },
 740   { 0,                  NULL } };
 741
 742
 743 #define RETRIEVAL_RESULT_LENGTH 4
 744 #define RETRIEVAL_RESULT_OFFSET PARAMETER_VALUE_OFFSET
 745
 746 static void
 747 dissect_m2ua_retrieval_result_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 748 {
 749   guint32 result;
 750
 751   result = tvb_get_ntohl(parameter_tvb, RETRIEVAL_RESULT_OFFSET);
 752   proto_tree_add_uint(parameter_tree, hf_m2ua_retrieval_result, parameter_tvb, RETRIEVAL_RESULT_OFFSET, RETRIEVAL_RESULT_LENGTH, result);
 753
 754   proto_item_set_text(parameter_item, "Retrieval result parameter (%s)",  val_to_str(result, m2ua_retrieval_result_values, "unknown"));
 755 }
 756
 757 static void
 758 dissect_m2ua_link_key_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 759 {
 760   tvbuff_t *parameters_tvb;
 761   guint16 length, parameters_length;
 762
 763   length            = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 764   parameters_length = length - PARAMETER_HEADER_LENGTH;
 765   parameters_tvb    = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 766   dissect_m2ua_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 767   proto_item_set_text(parameter_item, "Link key parameter");
 768 }
 769
 770 #define LOCAL_LK_ID_LENGTH 4
 771 #define LOCAL_LK_ID_OFFSET PARAMETER_VALUE_OFFSET
 772
 773 static void
 774 dissect_m2ua_local_lk_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 775 {
 776   guint32 id;
 777
 778   id = tvb_get_ntohl(parameter_tvb, LOCAL_LK_ID_OFFSET);
 779   proto_tree_add_uint(parameter_tree, hf_m2ua_local_lk_id, parameter_tvb, LOCAL_LK_ID_OFFSET, LOCAL_LK_ID_LENGTH, id);
 780
 781   proto_item_set_text(parameter_item, "Local KL identifier parameter (%u)",  id);
 782 }
 783
 784 #define SDT_RESERVED_LENGTH 2
 785 #define SDT_ID_LENGTH       2
 786 #define SDT_RESERVED_OFFSET PARAMETER_VALUE_OFFSET
 787 #define SDT_ID_OFFSET       (SDT_RESERVED_OFFSET + SDT_RESERVED_LENGTH)
 788
 789 static void
 790 dissect_m2ua_sdt_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 791 {
 792   guint16 reserved, id;
 793
 794   reserved = tvb_get_ntohs(parameter_tvb, SDT_RESERVED_OFFSET);
 795   id       = tvb_get_ntohs(parameter_tvb, SDT_ID_OFFSET);
 796
 797   proto_tree_add_uint(parameter_tree, hf_m2ua_sdt_reserved, parameter_tvb, SDT_RESERVED_OFFSET, SDT_RESERVED_LENGTH, reserved);
 798   proto_tree_add_uint(parameter_tree, hf_m2ua_sdt_id, parameter_tvb, SDT_ID_OFFSET, SDT_ID_LENGTH, id);
 799
 800   proto_item_set_text(parameter_item, "SDT identifier parameter (%u)",  id);
 801 }
 802
 803 #define SDL_RESERVED_LENGTH 2
 804 #define SDL_ID_LENGTH       2
 805 #define SDL_RESERVED_OFFSET PARAMETER_VALUE_OFFSET
 806 #define SDL_ID_OFFSET       (SDL_RESERVED_OFFSET + SDL_RESERVED_LENGTH)
 807
 808 static void
 809 dissect_m2ua_sdl_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 810 {
 811   guint16 reserved, id;
 812
 813   reserved = tvb_get_ntohs(parameter_tvb, SDT_RESERVED_OFFSET);
 814   id       = tvb_get_ntohs(parameter_tvb, SDT_ID_OFFSET);
 815
 816   proto_tree_add_uint(parameter_tree, hf_m2ua_sdl_reserved, parameter_tvb, SDL_RESERVED_OFFSET, SDL_RESERVED_LENGTH, reserved);
 817   proto_tree_add_uint(parameter_tree, hf_m2ua_sdl_id, parameter_tvb, SDL_ID_OFFSET, SDL_ID_LENGTH, id);
 818
 819   proto_item_set_text(parameter_item, "SDL identifier parameter (%u)",  id);
 820 }
 821
 822 static void
 823 dissect_m2ua_registration_result_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 824 {
 825   tvbuff_t *parameters_tvb;
 826   guint16 length, parameters_length;
 827
 828   length            = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 829   parameters_length = length - PARAMETER_HEADER_LENGTH;
 830   parameters_tvb    = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 831   dissect_m2ua_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 832   proto_item_set_text(parameter_item, "Registration result parameter");
 833 }
 834
 835 #define SUCCESSFULL_REGISTRATION_STATUS               0
 836 #define UNKNOWN_REGISTRATION_STATUS                   1
 837 #define INVALID_SDLI_REGISTRATION_STATUS              2
 838 #define INVALID_SDTI_REGISTRATION_STATUS              3
 839 #define INVALID_LINK_KEY_REGISTRATION_STATUS          4
 840 #define PERMISSION_DENIED_REGISTRATION_STATUS         5
 841 #define OVERLAPPING_LINK_KEY_REGISTRATION_STATUS      6
 842 #define LINK_KEY_NOT_PROVISIONED_REGISTRATION_STATUS  7
 843 #define INSUFFICIENT_RESOURCES_REGISTRATION_STATUS    8
 844
 845 static const value_string m2ua_registration_status_values[] = {
 846   { SUCCESSFULL_REGISTRATION_STATUS,              "Successfully Registered" },
 847   { UNKNOWN_REGISTRATION_STATUS,                  "Error - Unknown" },
 848   { INVALID_SDLI_REGISTRATION_STATUS,             "Error - Invalid SDLI" },
 849   { INVALID_SDTI_REGISTRATION_STATUS,             "Error - Invalid SDTI" },
 850   { INVALID_LINK_KEY_REGISTRATION_STATUS,         "Error - Invalid Link Key" },
 851   { PERMISSION_DENIED_REGISTRATION_STATUS,        "Error - Permission Denied" },
 852   { OVERLAPPING_LINK_KEY_REGISTRATION_STATUS,     "Error - Overlapping (Non-unique) Link Key" },
 853   { LINK_KEY_NOT_PROVISIONED_REGISTRATION_STATUS, "Error - Link Key not Provisioned" },
 854   { INSUFFICIENT_RESOURCES_REGISTRATION_STATUS,   "Error - Insufficient Resources" },
 855   { 0,                  NULL } };
 856
 857 #define REGISTRATION_STATUS_LENGTH 4
 858 #define REGISTRATION_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 859
 860 static void
 861 dissect_m2ua_registration_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 862 {
 863   guint32 status;
 864
 865   status = tvb_get_ntohl(parameter_tvb, REGISTRATION_STATUS_OFFSET);
 866   proto_tree_add_uint(parameter_tree, hf_m2ua_registration_status, parameter_tvb, REGISTRATION_STATUS_OFFSET, REGISTRATION_STATUS_LENGTH, status);
 867
 868   proto_item_set_text(parameter_item, "Registration status parameter (%s)",  val_to_str(status, m2ua_registration_status_values, "unknown"));
 869 }
 870
 871 static void
 872 dissect_m2ua_deregistration_result_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 873 {
 874   tvbuff_t *parameters_tvb;
 875   guint16 length, parameters_length;
 876
 877   length            = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 878   parameters_length = length - PARAMETER_HEADER_LENGTH;
 879   parameters_tvb    = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 880   dissect_m2ua_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 881   proto_item_set_text(parameter_item, "Deregistration result parameter");
 882 }
 883
 884 #define SUCCESSFULL_DEREGISTRATION_STATUS                  0
 885 #define UNKNOWN_DEREGISTRATION_STATUS                      1
 886 #define INVALID_INTERFACE_IDENTIFIER_DEREGISTRATION_STATUS 2
 887 #define PERMISSION_DENIED_DEREGISTRATION_STATUS            3
 888 #define NOT_REGISTRED_DEREGISTRATION_STATUS                4
 889
 890 static const value_string m2ua_deregistration_status_values[] = {
 891   { SUCCESSFULL_DEREGISTRATION_STATUS,                  "Successfully Registered" },
 892   { UNKNOWN_DEREGISTRATION_STATUS,                      "Error - Unknown" },
 893   { INVALID_INTERFACE_IDENTIFIER_DEREGISTRATION_STATUS, "Error - Invalid interface identifier" },
 894   { PERMISSION_DENIED_DEREGISTRATION_STATUS,            "Error - Permission Denied" },
 895   { NOT_REGISTRED_DEREGISTRATION_STATUS,                "Error - Not registered" },
 896   { 0,                                                  NULL } };
 897
 898 #define DEREGISTRATION_STATUS_LENGTH 4
 899 #define DEREGISTRATION_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 900
 901 static void
 902 dissect_m2ua_deregistration_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 903 {
 904   guint32 status;
 905
 906   status = tvb_get_ntohl(parameter_tvb, DEREGISTRATION_STATUS_OFFSET);
 907   proto_tree_add_uint(parameter_tree, hf_m2ua_deregistration_status, parameter_tvb, DEREGISTRATION_STATUS_OFFSET, DEREGISTRATION_STATUS_LENGTH, status);
 908
 909   proto_item_set_text(parameter_item, "Deregistration status parameter (%s)",  val_to_str(status, m2ua_deregistration_status_values, "unknown"));
 910 }
 911
 912 static void
 913 dissect_m2ua_unknown_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 914 {
 915   guint16 tag, length, parameter_value_length;
 916
 917   tag    = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
 918   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 919
 920   parameter_value_length = length - PARAMETER_HEADER_LENGTH;
 921
 922   if (parameter_value_length > 0)
 923     proto_tree_add_bytes(parameter_tree, hf_m2ua_parameter_value, parameter_tvb, PARAMETER_VALUE_OFFSET, parameter_value_length,
 924                          tvb_get_ptr(parameter_tvb, PARAMETER_VALUE_OFFSET, parameter_value_length));
 925
 926   proto_item_set_text(parameter_item, "Parameter with tag %u and %u byte%s value", tag, parameter_value_length, plurality(parameter_value_length, "", "s"));
 927 }
 928
 929 /* Common parameter tags */
 930 #define INTERFACE_IDENTIFIER_INT_PARAMETER_TAG     0x0001
 931 #define INTERFACE_IDENTIFIER_TEXT_PARAMETER_TAG    0x0003
 932 #define INFO_STRING_PARAMETER_TAG                  0x0004
 933 #define DIAGNOSTIC_INFORMATION_PARAMETER_TAG       0x0007
 934 #define INTERFACE_IDENTIFIER_RANGE_PARAMETER_TAG   0x0008
 935 #define HEARTBEAT_DATA_PARAMETER_TAG               0x0009
 936 #define TRAFFIC_MODE_TYPE_PARAMETER_TAG            0x000b
 937 #define ERROR_CODE_PARAMETER_TAG                   0x000c
 938 #define STATUS_PARAMETER_TAG                       0x000d
 939 #define ASP_IDENTIFIER_PARAMETER_TAG               0x0011
 940 #define CORRELATION_IDENTIFIER_PARAMETER_TAG       0x0013
 941
 942 /* M2PA specific parameter tags */
 943 #define PROTOCOL_DATA_1_PARAMETER_TAG              0x0300
 944 #define PROTOCOL_DATA_2_PARAMETER_TAG              0x0301
 945 #define STATE_REQUEST_PARAMETER_TAG                0x0302
 946 #define STATE_EVENT_PARAMETER_TAG                  0x0303
 947 #define CONGESTION_STATUS_PARAMETER_TAG            0x0304
 948 #define DISCARD_STATUS_PARAMETER_TAG               0x0305
 949 #define ACTION_PARAMETER_TAG                       0x0306
 950 #define SEQUENCE_NUMBER_PARAMETER_TAG              0x0307
 951 #define RETRIEVAL_RESULT_PARAMETER_TAG             0x0308
 952 #define LINK_KEY_PARAMETER_TAG                     0x0309
 953 #define LOCAL_LK_IDENTIFIER_PARAMETER_TAG          0x030a
 954 #define SDT_IDENTIFIER_PARAMETER_TAG               0x030b
 955 #define SDL_IDENTIFIER_PARAMETER_TAG               0x030c
 956 #define REG_RESULT_PARAMETER_TAG                   0x030d
 957 #define REG_STATUS_PARAMETER_TAG                   0x030e
 958 #define DEREG_RESULT_PARAMETER_TAG                 0x030f
 959 #define DEREG_STATUS_PARAMETER_TAG                 0x0310
 960
 961 static const value_string m2ua_parameter_tag_values[] = {
 962   { INTERFACE_IDENTIFIER_INT_PARAMETER_TAG,        "Interface identifier (interger)" },
 963   { INTERFACE_IDENTIFIER_TEXT_PARAMETER_TAG,       "Interface identifier (text)" },
 964   { INFO_STRING_PARAMETER_TAG,                     "Info string" },
 965   { DIAGNOSTIC_INFORMATION_PARAMETER_TAG,          "Diagnostic information" },
 966   { INTERFACE_IDENTIFIER_RANGE_PARAMETER_TAG,      "Interface identifier (interger range)" },
 967   { HEARTBEAT_DATA_PARAMETER_TAG,                  "Heartbeat data" },
 968   { TRAFFIC_MODE_TYPE_PARAMETER_TAG,               "Traffic mode type" },
 969   { ERROR_CODE_PARAMETER_TAG,                      "Error code" },
 970   { STATUS_PARAMETER_TAG,                          "Status type / information" },
 971   { ASP_IDENTIFIER_PARAMETER_TAG,                  "ASP identifier" },
 972   { CORRELATION_IDENTIFIER_PARAMETER_TAG,          "Correlation identifier" },
 973   { PROTOCOL_DATA_1_PARAMETER_TAG,                 "Protocol data 1" },
 974   { PROTOCOL_DATA_2_PARAMETER_TAG,                 "Protocol data 2" },
 975   { STATE_REQUEST_PARAMETER_TAG,                   "State request" },
 976   { STATE_EVENT_PARAMETER_TAG,                     "State event" },
 977   { CONGESTION_STATUS_PARAMETER_TAG,               "Congestion state" },
 978   { DISCARD_STATUS_PARAMETER_TAG,                  "Discard state" },
 979   { ACTION_PARAMETER_TAG,                          "Action" },
 980   { SEQUENCE_NUMBER_PARAMETER_TAG,                 "Sequence number" },
 981   { RETRIEVAL_RESULT_PARAMETER_TAG,                "Retrieval result" },
 982   { LINK_KEY_PARAMETER_TAG,                        "Link key" },
 983   { LOCAL_LK_IDENTIFIER_PARAMETER_TAG,             "Local LK identifier" },
 984   { SDT_IDENTIFIER_PARAMETER_TAG,                  "SDT identifier" },
 985   { SDL_IDENTIFIER_PARAMETER_TAG,                  "SDL identifer" },
 986   { REG_RESULT_PARAMETER_TAG,                      "Registration result" },
 987   { REG_STATUS_PARAMETER_TAG,                      "Registration status" },
 988   { DEREG_RESULT_PARAMETER_TAG,                    "Deregistration result" },
 989   { DEREG_STATUS_PARAMETER_TAG,                    "Deregistration status" },
 990   { 0,                           NULL } };
 991
 992 static void
 993 dissect_m2ua_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m2ua_tree)
 994 {
 995   guint16 tag, length, padding_length, total_length;
 996   proto_item *parameter_item;
 997   proto_tree *parameter_tree;
 998
 999   /* extract tag and length from the parameter */
1000   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1001   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1002
1003   /* calculate padding and total length */
1004   padding_length = tvb_length(parameter_tvb) - length;
1005   total_length   = length + padding_length;
1006
1007   /* create proto_tree stuff */
1008   parameter_item   = proto_tree_add_text(m2ua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, total_length, "Incomplete parameter");
1009   parameter_tree   = proto_item_add_subtree(parameter_item, ett_m2ua_parameter);
1010
1011   /* add tag and length to the m2ua tree */
1012   proto_tree_add_uint(parameter_tree, hf_m2ua_parameter_tag, parameter_tvb, PARAMETER_TAG_OFFSET, PARAMETER_TAG_LENGTH, tag);
1013   proto_tree_add_uint(parameter_tree, hf_m2ua_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, length);
1014
1015   switch(tag) {
1016   case INTERFACE_IDENTIFIER_INT_PARAMETER_TAG:
1017     dissect_m2ua_interface_identifier_int_parameter(parameter_tvb, parameter_tree, parameter_item);
1018     break;
1019   case INTERFACE_IDENTIFIER_TEXT_PARAMETER_TAG:
1020     dissect_m2ua_interface_identifier_text_parameter(parameter_tvb, parameter_tree, parameter_item);
1021     break;
1022   case INFO_STRING_PARAMETER_TAG:
1023     dissect_m2ua_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
1024     break;
1025   case DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
1026     dissect_m2ua_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
1027     break;
1028   case INTERFACE_IDENTIFIER_RANGE_PARAMETER_TAG:
1029     dissect_m2ua_interface_identifier_range_parameter(parameter_tvb, parameter_tree, parameter_item);
1030     break;
1031   case HEARTBEAT_DATA_PARAMETER_TAG:
1032     dissect_m2ua_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
1033     break;
1034   case TRAFFIC_MODE_TYPE_PARAMETER_TAG:
1035     dissect_m2ua_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
1036     break;
1037   case ERROR_CODE_PARAMETER_TAG:
1038     dissect_m2ua_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1039     break;
1040   case STATUS_PARAMETER_TAG:
1041     dissect_m2ua_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1042     break;
1043   case ASP_IDENTIFIER_PARAMETER_TAG:
1044     dissect_m2ua_asp_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1045     break;
1046   case CORRELATION_IDENTIFIER_PARAMETER_TAG:
1047     dissect_m2ua_correlation_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1048     break;
1049   case PROTOCOL_DATA_1_PARAMETER_TAG:
1050     dissect_m2ua_protocol_data_1_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1051     break;
1052   case PROTOCOL_DATA_2_PARAMETER_TAG:
1053     dissect_m2ua_protocol_data_2_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1054     break;
1055   case STATE_REQUEST_PARAMETER_TAG:
1056     dissect_m2ua_state_request_parameter(parameter_tvb, parameter_tree, parameter_item);
1057     break;
1058   case STATE_EVENT_PARAMETER_TAG:
1059     dissect_m2ua_event_request_parameter(parameter_tvb, parameter_tree, parameter_item);
1060     break;
1061   case CONGESTION_STATUS_PARAMETER_TAG:
1062     dissect_m2ua_congestion_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1063     break;
1064   case DISCARD_STATUS_PARAMETER_TAG:
1065     dissect_m2ua_discard_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1066     break;
1067   case ACTION_PARAMETER_TAG:
1068     dissect_m2ua_action_parameter(parameter_tvb, parameter_tree, parameter_item);
1069     break;
1070   case SEQUENCE_NUMBER_PARAMETER_TAG:
1071     dissect_m2ua_sequence_number_parameter(parameter_tvb, parameter_tree, parameter_item);
1072     break;
1073   case RETRIEVAL_RESULT_PARAMETER_TAG:
1074     dissect_m2ua_retrieval_result_parameter(parameter_tvb, parameter_tree, parameter_item);
1075     break;
1076   case LINK_KEY_PARAMETER_TAG:
1077     dissect_m2ua_link_key_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1078     break;
1079   case LOCAL_LK_IDENTIFIER_PARAMETER_TAG:
1080     dissect_m2ua_local_lk_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1081     break;
1082   case SDT_IDENTIFIER_PARAMETER_TAG:
1083     dissect_m2ua_sdt_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1084     break;
1085   case SDL_IDENTIFIER_PARAMETER_TAG:
1086     dissect_m2ua_sdl_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1087     break;
1088   case REG_RESULT_PARAMETER_TAG:
1089     dissect_m2ua_registration_result_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1090     break;
1091   case REG_STATUS_PARAMETER_TAG:
1092     dissect_m2ua_registration_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1093     break;
1094   case DEREG_RESULT_PARAMETER_TAG:
1095     dissect_m2ua_deregistration_result_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1096     break;
1097   case DEREG_STATUS_PARAMETER_TAG:
1098     dissect_m2ua_deregistration_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1099     break;
1100   default:
1101     dissect_m2ua_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
1102     break;
1103   };
1104
1105   if (padding_length > 0)
1106     proto_tree_add_bytes(parameter_tree, hf_m2ua_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length,
1107                          tvb_get_ptr(parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length));
1108 }
1109
1110
1111 static void
1112 dissect_m2ua_parameters(tvbuff_t *parameters_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m2ua_tree)
1113 {
1114   gint offset, length, padding_length, total_length, remaining_length;
1115   tvbuff_t *parameter_tvb;
1116
1117   offset = 0;
1118   while((remaining_length = tvb_reported_length_remaining(parameters_tvb, offset))) {
1119     length         = tvb_get_ntohs(parameters_tvb, offset + PARAMETER_LENGTH_OFFSET);
1120     padding_length = nr_of_padding_bytes(length);
1121     if (remaining_length >= length)
1122       total_length = MIN(length + padding_length, remaining_length);
1123     else
1124       total_length = length + padding_length;
1125     /* create a tvb for the parameter including the padding bytes */
1126     parameter_tvb    = tvb_new_subset(parameters_tvb, offset, total_length, total_length);
1127     dissect_m2ua_parameter(parameter_tvb, pinfo, tree, m2ua_tree);
1128     /* get rid of the handled parameter */
1129     offset += total_length;
1130   }
1131 }
1132
1133
1134 static void
1135 dissect_m2ua_message(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m2ua_tree)
1136 {
1137   tvbuff_t *common_header_tvb, *parameters_tvb;
1138
1139   common_header_tvb = tvb_new_subset(message_tvb, 0, COMMON_HEADER_LENGTH, COMMON_HEADER_LENGTH);
1140   parameters_tvb    = tvb_new_subset(message_tvb, COMMON_HEADER_LENGTH, -1, -1);
1141   dissect_m2ua_common_header(common_header_tvb, pinfo, m2ua_tree);
1142   if (m2ua_tree)
1143     dissect_m2ua_parameters(parameters_tvb, pinfo, tree, m2ua_tree);
1144 }
1145
1146 static void
1147 dissect_m2ua(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree)
1148 {
1149   proto_item *m2ua_item;
1150   proto_tree *m2ua_tree;
1151
1152   /* make entry in the Protocol column on summary display */
1153   if (check_col(pinfo->cinfo, COL_PROTOCOL))
1154     col_set_str(pinfo->cinfo, COL_PROTOCOL, "M2UA");
1155
1156   /* In the interest of speed, if "tree" is NULL, don't do any work not
1157      necessary to generate protocol tree items. */
1158   if (tree) {
1159     /* create the m2ua protocol tree */
1160     m2ua_item = proto_tree_add_item(tree, proto_m2ua, message_tvb, 0, -1, FALSE);
1161     m2ua_tree = proto_item_add_subtree(m2ua_item, ett_m2ua);
1162   } else {
1163     m2ua_tree = NULL;
1164   };
1165   /* dissect the message */
1166   dissect_m2ua_message(message_tvb, pinfo, tree, m2ua_tree);
1167 }
1168
1169 /* Register the protocol with Ethereal */
1170 void
1171 proto_register_m2ua(void)
1172 {
1173
1174   /* Setup list of header fields */
1175   static hf_register_info hf[] = {
1176     { &hf_m2ua_version,
1177       { "Version", "m2ua.version",
1178               FT_UINT8, BASE_DEC, VALS(m2ua_protocol_version_values), 0x0,
1179         "", HFILL }
1180     },
1181     { &hf_m2ua_reserved,
1182       { "Reserved", "m2ua.reserved",
1183               FT_UINT8, BASE_HEX, NULL, 0x0,
1184               "", HFILL }
1185     },
1186     { &hf_m2ua_message_class,
1187       { "Message class", "m2ua.message_class",
1188         FT_UINT8, BASE_DEC, VALS(m2ua_message_class_values), 0x0,
1189               "", HFILL }
1190     },
1191     { &hf_m2ua_message_type,
1192       { "Message Type", "m2ua.message_type",
1193               FT_UINT8, BASE_DEC, NULL, 0x0,
1194               "", HFILL }
1195     },
1196     { &hf_m2ua_message_length,
1197       { "Message length", "m2ua.message_length",
1198         FT_UINT32, BASE_DEC, NULL, 0x0,
1199               "", HFILL }
1200     },
1201     { &hf_m2ua_parameter_tag,
1202       { "Parameter Tag", "m2ua.parameter_tag",
1203         FT_UINT16, BASE_HEX, VALS(m2ua_parameter_tag_values), 0x0,
1204         "", HFILL }
1205     },
1206     { &hf_m2ua_parameter_length,
1207       { "Parameter length", "m2ua.parameter_length",
1208         FT_UINT16, BASE_DEC, NULL, 0x0,
1209               "", HFILL }
1210     },
1211     { &hf_m2ua_parameter_value,
1212       { "Parameter value", "m2ua.parameter_value",
1213               FT_BYTES, BASE_NONE, NULL, 0x0,
1214               "", HFILL }
1215     },
1216     { &hf_m2ua_parameter_padding,
1217       { "Padding", "m2ua.parameter_padding",
1218               FT_BYTES, BASE_NONE, NULL, 0x0,
1219               "", HFILL }
1220     },
1221     { &hf_m2ua_interface_id_int,
1222       { "Interface Identifier (integer)", "m2ua.interface_identifier_int",
1223         FT_UINT32, BASE_DEC, NULL, 0x0,
1224               "", HFILL }
1225     },
1226     { &hf_m2ua_interface_id_text,
1227       { "Interface identifier (text)", "m2ua.interface_identifier_text",
1228               FT_STRING, BASE_DEC, NULL, 0x0,
1229               "", HFILL }
1230     },
1231     { &hf_m2ua_info_string,
1232       { "Info string", "m2ua.info_string",
1233               FT_STRING, BASE_DEC, NULL, 0x0,
1234               "", HFILL }
1235     },
1236     { &hf_m2ua_diagnostic_information,
1237       { "Diagnostic information", "m2ua.diagnostic_information",
1238               FT_BYTES, BASE_NONE, NULL, 0x0,
1239               "", HFILL }
1240     },
1241     { &hf_m2ua_interface_id_start,
1242       { "Interface Identifier (start)", "m2ua.interface_identifier_start",
1243         FT_UINT32, BASE_DEC, NULL, 0x0,
1244               "", HFILL }
1245     },
1246     { &hf_m2ua_interface_id_stop,
1247       { "Interface Identifier (stop)", "m2ua.interface_identifier_stop",
1248         FT_UINT32, BASE_DEC, NULL, 0x0,
1249               "", HFILL }
1250     },
1251     { &hf_m2ua_heartbeat_data,
1252       { "Heartbeat data", "m2ua.heartbeat_data",
1253               FT_BYTES, BASE_NONE, NULL, 0x0,
1254               "", HFILL }
1255     },
1256     { &hf_m2ua_traffic_mode_type,
1257       { "Traffic mode Type", "m2ua.traffic_mode_type",
1258               FT_UINT32, BASE_DEC, VALS(m2ua_traffic_mode_type_values), 0x0,
1259               "", HFILL }
1260     },
1261     { &hf_m2ua_error_code,
1262       { "Error code", "m2ua.error_code",
1263         FT_UINT32, BASE_DEC, VALS(m2ua_error_code_values), 0x0,
1264               "", HFILL }
1265     },
1266     { &hf_m2ua_status_type,
1267       { "Status type", "m2ua.status_type",
1268               FT_UINT16, BASE_DEC, VALS(m2ua_status_type_values), 0x0,
1269               "", HFILL }
1270     },
1271     { &hf_m2ua_status_info,
1272       { "Status info", "m2ua.status_info",
1273               FT_UINT16, BASE_DEC, NULL, 0x0,
1274               "", HFILL }
1275     },
1276     { &hf_m2ua_asp_id,
1277       { "ASP identifier", "m2ua.asp_identifier",
1278               FT_UINT32, BASE_DEC, NULL, 0x0,
1279               "", HFILL }
1280     },
1281     { &hf_m2ua_correlation_id,
1282       { "Correlation identifier", "m2ua.correlation identifier",
1283               FT_UINT32, BASE_DEC, NULL, 0x0,
1284               "", HFILL }
1285     },
1286     { &hf_m2ua_data_2_li,
1287       { "Length indicator", "m2ua.data_2_li",
1288         FT_UINT8, BASE_DEC, NULL, 0x0,
1289         "", HFILL }
1290     },
1291     { &hf_m2ua_state,
1292       { "State", "m2ua.state",
1293         FT_UINT32, BASE_DEC, VALS(m2ua_state_values), 0x0,
1294         "", HFILL }
1295     },
1296     { &hf_m2ua_event,
1297       { "Event", "m2ua.event",
1298         FT_UINT32, BASE_DEC, VALS(m2ua_event_values), 0x0,
1299         "", HFILL }
1300     },
1301     { &hf_m2ua_congestion_status,
1302       { "Congestion status", "m2ua.congestion_status",
1303         FT_UINT32, BASE_DEC, VALS(m2ua_level_values), 0x0,
1304         "", HFILL }
1305     },
1306     { &hf_m2ua_discard_status,
1307       { "Discard status", "m2ua.discard_status",
1308         FT_UINT32, BASE_DEC, VALS(m2ua_level_values), 0x0,
1309         "", HFILL }
1310     },
1311     { &hf_m2ua_action,
1312       { "Actions", "m2ua.action",
1313         FT_UINT32, BASE_DEC, VALS(m2ua_action_values), 0x0,
1314         "", HFILL }
1315     },
1316     { &hf_m2ua_sequence_number,
1317       { "Sequence number", "m2ua.sequence_number",
1318         FT_UINT32, BASE_DEC, NULL, 0x0,
1319         "", HFILL }
1320     },
1321     { &hf_m2ua_retrieval_result,
1322       { "Retrieval result", "m2ua.retrieval_result",
1323         FT_UINT32, BASE_DEC, VALS(m2ua_retrieval_result_values), 0x0,
1324         "", HFILL }
1325     },
1326     { &hf_m2ua_local_lk_id,
1327       { "Local LK identifier", "m2ua.local_lk_identifier",
1328         FT_UINT32, BASE_DEC, NULL, 0x0,
1329         "", HFILL }
1330     },
1331     { &hf_m2ua_sdt_reserved,
1332       { "Reserved", "m2ua.sdt_reserved",
1333         FT_UINT16, BASE_HEX, NULL, 0x0,
1334         "", HFILL }
1335     },
1336     { &hf_m2ua_sdt_id,
1337       { "SDT identifier", "m2ua.sdt_identifier",
1338         FT_UINT16, BASE_DEC, NULL, 0x0,
1339         "", HFILL }
1340     },
1341     { &hf_m2ua_sdl_reserved,
1342       { "Reserved", "m2ua.sdl_reserved",
1343         FT_UINT16, BASE_HEX, NULL, 0x0,
1344         "", HFILL }
1345     },
1346     { &hf_m2ua_sdl_id,
1347       { "SDL identifier", "m2ua.sdl_identifier",
1348         FT_UINT16, BASE_DEC, NULL, 0x0,
1349         "", HFILL }
1350     },
1351     { &hf_m2ua_registration_status,
1352       { "Registration status", "m2ua.registration_status",
1353         FT_UINT32, BASE_DEC, VALS(m2ua_registration_status_values), 0x0,
1354         "", HFILL }
1355     },
1356     { &hf_m2ua_deregistration_status,
1357       { "Deregistration status", "m2ua.deregistration_status",
1358         FT_UINT32, BASE_DEC, VALS(m2ua_deregistration_status_values), 0x0,
1359         "", HFILL }
1360     },
1361   };
1362
1363   /* Setup protocol subtree array */
1364   static gint *ett[] = {
1365     &ett_m2ua,
1366     &ett_m2ua_parameter,
1367   };
1368
1369   /* Register the protocol name and description */
1370   proto_m2ua = proto_register_protocol("MTP 2 User Adaptation Layer", "M2UA",  "m2ua");
1371
1372   /* Required function calls to register the header fields and subtrees used */
1373   proto_register_field_array(proto_m2ua, hf, array_length(hf));
1374   proto_register_subtree_array(ett, array_length(ett));
1375
1376 };
1377
1378 void
1379 proto_reg_handoff_m2ua(void)
1380 {
1381   dissector_handle_t m2ua_handle;
1382
1383   mtp3_handle = find_dissector("mtp3");
1384   m2ua_handle = create_dissector_handle(dissect_m2ua, proto_m2ua);
1385   dissector_add("sctp.ppi",  M2UA_PAYLOAD_PROTO_ID, m2ua_handle);
1386   dissector_add("sctp.port", SCTP_PORT_M2UA, m2ua_handle);
1387 }