epan/dissectors/packet-m2ua.c

   1 /* packet-m2ua.c
   2  * Routines for MTP2 User Adaptation Layer dissection
   3  * It is hopefully (needs testing) compliant to
   4  * http://www.ietf.org/rfc/rfc3331.txt
   5  * To do: - provide better handling of length parameters
   6  *
   7  * Copyright 2002, Michael Tuexen <tuexen [AT] fh-muenster.de>
   8  *
   9  * $Id$
  10  *
  11  * Wireshark - Network traffic analyzer
  12  * By Gerald Combs <gerald@wireshark.org>
  13  * Copyright 1998 Gerald Combs
  14  *
  15  * Copied from README.developer
  16  *
  17  * This program is free software; you can redistribute it and/or
  18  * modify it under the terms of the GNU General Public License
  19  * as published by the Free Software Foundation; either version 2
  20  * of the License, or (at your option) any later version.
  21  *
  22  * This program is distributed in the hope that it will be useful,
  23  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  24  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  25  * GNU General Public License for more details.
  26  *
  27  * You should have received a copy of the GNU General Public License
  28  * along with this program; if not, write to the Free Software
  29  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  30  */
  31
  32 #ifdef HAVE_CONFIG_H
  33 # include "config.h"
  34 #endif
  35
  36 #include <epan/packet.h>
  37 #include <epan/prefs.h>
  38 #include <epan/sctpppids.h>
  39
  40 #define SCTP_PORT_M2UA                  2904
  41
  42 /* Initialize the protocol and registered fields */
  43 static int proto_m2ua =                 -1;
  44 static int hf_version =                 -1;
  45 static int hf_reserved =                -1;
  46 static int hf_message_class =           -1;
  47 static int hf_message_type =            -1;
  48 static int hf_message_length =          -1;
  49 static int hf_parameter_tag =           -1;
  50 static int hf_parameter_length =        -1;
  51 static int hf_parameter_value =         -1;
  52 static int hf_parameter_padding =       -1;
  53 static int hf_interface_id_int =        -1;
  54 static int hf_interface_id_text =       -1;
  55 static int hf_info_string =             -1;
  56 static int hf_diagnostic_information =  -1;
  57 static int hf_interface_id_start =      -1;
  58 static int hf_interface_id_stop =       -1;
  59 static int hf_heartbeat_data =          -1;
  60 static int hf_traffic_mode_type =       -1;
  61 static int hf_error_code =              -1;
  62 static int hf_status_type =             -1;
  63 static int hf_status_ident =            -1;
  64 static int hf_asp_id =                  -1;
  65 static int hf_correlation_id =          -1;
  66 static int hf_data_2_li =               -1;
  67 static int hf_state =                   -1;
  68 static int hf_event =                   -1;
  69 static int hf_congestion_status =       -1;
  70 static int hf_discard_status =          -1;
  71 static int hf_action =                  -1;
  72 static int hf_sequence_number =         -1;
  73 static int hf_retrieval_result =        -1;
  74 static int hf_local_lk_id =             -1;
  75 static int hf_sdt_reserved =            -1;
  76 static int hf_sdt_id =                  -1;
  77 static int hf_sdl_reserved =            -1;
  78 static int hf_sdl_id =                  -1;
  79 static int hf_registration_status =     -1;
  80 static int hf_deregistration_status =   -1;
  81
  82 /* Initialize the subtree pointers */
  83 static gint ett_m2ua =                  -1;
  84 static gint ett_m2ua_parameter =        -1;
  85
  86 static dissector_handle_t mtp3_handle;
  87
  88 static void
  89 dissect_parameters(tvbuff_t *, packet_info *, proto_tree *, proto_tree *);
  90
  91 #define ADD_PADDING(x) ((((x) + 3) >> 2) << 2)
  92
  93 #define VERSION_LENGTH         1
  94 #define RESERVED_LENGTH        1
  95 #define MESSAGE_CLASS_LENGTH   1
  96 #define MESSAGE_TYPE_LENGTH    1
  97 #define MESSAGE_LENGTH_LENGTH  4
  98 #define COMMON_HEADER_LENGTH   (VERSION_LENGTH + RESERVED_LENGTH + MESSAGE_CLASS_LENGTH + \
  99                                 MESSAGE_TYPE_LENGTH + MESSAGE_LENGTH_LENGTH)
 100
 101 #define VERSION_OFFSET         0
 102 #define RESERVED_OFFSET        (VERSION_OFFSET + VERSION_LENGTH)
 103 #define MESSAGE_CLASS_OFFSET   (RESERVED_OFFSET + RESERVED_LENGTH)
 104 #define MESSAGE_TYPE_OFFSET    (MESSAGE_CLASS_OFFSET + MESSAGE_CLASS_LENGTH)
 105 #define MESSAGE_LENGTH_OFFSET  (MESSAGE_TYPE_OFFSET + MESSAGE_TYPE_LENGTH)
 106
 107 #define PROTOCOL_VERSION_RELEASE_1             1
 108
 109 static const value_string protocol_version_values[] = {
 110   { PROTOCOL_VERSION_RELEASE_1,  "Release 1" },
 111   { 0,                           NULL } };
 112
 113 #define MESSAGE_CLASS_MGMT_MESSAGE         0
 114 #define MESSAGE_CLASS_ASPSM_MESSAGE        3
 115 #define MESSAGE_CLASS_ASPTM_MESSAGE        4
 116 #define MESSAGE_CLASS_MAUP_MESSAGE         6
 117 #define MESSAGE_CLASS_IIM_MESSAGE         10
 118
 119 static const value_string message_class_values[] = {
 120   { MESSAGE_CLASS_MGMT_MESSAGE,   "Management messages" },
 121   { MESSAGE_CLASS_ASPSM_MESSAGE,  "ASP state maintenance messages" },
 122   { MESSAGE_CLASS_ASPTM_MESSAGE,  "ASP traffic maintenance messages" },
 123   { MESSAGE_CLASS_MAUP_MESSAGE,   "MTP2 user adaptation messages" },
 124   { MESSAGE_CLASS_IIM_MESSAGE,    "Interface identifier management messages" },
 125   { 0,                            NULL } };
 126
 127 /* MGMT */
 128 #define MESSAGE_TYPE_ERR                  0
 129 #define MESSAGE_TYPE_NTFY                 1
 130
 131 /* ASPSM */
 132 #define MESSAGE_TYPE_UP                   1
 133 #define MESSAGE_TYPE_DOWN                 2
 134 #define MESSAGE_TYPE_BEAT                 3
 135 #define MESSAGE_TYPE_UP_ACK               4
 136 #define MESSAGE_TYPE_DOWN_ACK             5
 137 #define MESSAGE_TYPE_BEAT_ACK             6
 138
 139 /* ASPTM */
 140 #define MESSAGE_TYPE_ACTIVE               1
 141 #define MESSAGE_TYPE_INACTIVE             2
 142 #define MESSAGE_TYPE_ACTIVE_ACK           3
 143 #define MESSAGE_TYPE_INACTIVE_ACK         4
 144
 145 /* MAUP */
 146 #define MESSAGE_TYPE_DATA                 1
 147 #define MESSAGE_TYPE_ESTAB_REQ            2
 148 #define MESSAGE_TYPE_ESTAB_CONF           3
 149 #define MESSAGE_TYPE_REL_REQ              4
 150 #define MESSAGE_TYPE_REL_CONF             5
 151 #define MESSAGE_TYPE_REL_IND              6
 152 #define MESSAGE_TYPE_STATE_REQ            7
 153 #define MESSAGE_TYPE_STATE_CONF           8
 154 #define MESSAGE_TYPE_STATE_IND            9
 155 #define MESSAGE_TYPE_DATA_RETR_REQ       10
 156 #define MESSAGE_TYPE_DATA_RETR_CONF      11
 157 #define MESSAGE_TYPE_DATA_RETR_IND       12
 158 #define MESSAGE_TYPE_DATA_RETR_COMP_IND  13
 159 #define MESSAGE_TYPE_CONG_IND            14
 160 #define MESSAGE_TYPE_DATA_ACK            15
 161
 162 /* IIM */
 163 #define MESSAGE_TYPE_REG_REQ              1
 164 #define MESSAGE_TYPE_REG_RSP              2
 165 #define MESSAGE_TYPE_DEREG_REQ            3
 166 #define MESSAGE_TYPE_DEREG_RSP            4
 167
 168 static const value_string message_class_type_values[] = {
 169   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,                "Error (ERR)" },
 170   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,               "Notify (NTFY)" },
 171   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,                 "ASP up (UP)" },
 172   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,               "ASP down (DOWN)" },
 173   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,               "Heartbeat (BEAT)" },
 174   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,             "ASP up ack (UP ACK)" },
 175   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,           "ASP down ack (DOWN ACK)" },
 176   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,           "Heartbeat ack (BEAT ACK)" },
 177   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,            "ASP active (ACTIVE)" },
 178   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,          "ASP inactive (INACTIVE)" },
 179   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,        "ASP active ack (ACTIVE ACK)" },
 180   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK ,      "ASP inactive ack (INACTIVE ACK)" },
 181   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA,               "DATA (DATA)" },
 182   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_ESTAB_REQ,          "Establish request (ESTAB_REQ)" },
 183   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_ESTAB_CONF,         "Establish confirm (ESTAB_CONF)" },
 184   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_REQ,            "Release request (REL_REQ)" },
 185   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_CONF,           "Release confirm (REL_CONF)" },
 186   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_IND,            "Release indication (REL_IND)" },
 187   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_REQ,          "State request (STATE_REQ)" },
 188   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_CONF,         "State confirm (STATE_CONF)" },
 189   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_IND,          "State indication (STATE_IND)" },
 190   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_REQ,      "Data retrieval request (DATA_RETR_REQ)" },
 191   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_CONF,     "Data retrieval confirm (DATA_RETR_CONF)" },
 192   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_IND,      "Data retrieval indication (DATA_RETR_IND)" },
 193   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_COMP_IND, "Data retrieval complete indication (DATA_RETR_COMP_IND)" },
 194   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_CONG_IND,           "Congestion indication (CONG_IND)" },
 195   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_ACK,           "Data acknowledge (DATA_ACK)" },
 196   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_REG_REQ ,           "Registration request (REG_REQ)" },
 197   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_REG_RSP ,           "Registration response (REG_RSP)" },
 198   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_REQ ,         "Deregistration request (DEREG_REQ)" },
 199   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_RSP ,         "Deregistration response (DEREG_RSP)" },
 200   { 0,                           NULL } };
 201
 202 static const value_string message_class_type_acro_values[] = {
 203   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,                "ERR" },
 204   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,               "NTFY" },
 205   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,                 "ASP_UP" },
 206   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,               "ASP_DOWN" },
 207   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,               "BEAT" },
 208   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,             "ASP_UP_ACK" },
 209   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,           "ASP_DOWN_ACK" },
 210   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,           "BEAT_ACK" },
 211   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,            "ASP_ACTIVE" },
 212   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,          "ASP_INACTIVE" },
 213   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,        "ASP_ACTIVE_ACK" },
 214   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK ,      "ASP_INACTIVE_ACK" },
 215   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA,               "DATA" },
 216   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_ESTAB_REQ,          "ESTAB_REQ" },
 217   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_ESTAB_CONF,         "ESTAB_CONF" },
 218   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_REQ,            "REL_REQ" },
 219   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_CONF,           "REL_CONF" },
 220   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_REL_IND,            "REL_IND" },
 221   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_REQ,          "STATE_REQ" },
 222   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_CONF,         "STATE_CONF" },
 223   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_STATE_IND,          "STATE_IND" },
 224   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_REQ,      "DATA_RETR_REQ" },
 225   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_CONF,     "DATA_RETR_CONF" },
 226   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_IND,      "DATA_RETR_IND" },
 227   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_RETR_COMP_IND, "DATA_RETR_COMP_IND" },
 228   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_CONG_IND,           "CONG_IND" },
 229   { MESSAGE_CLASS_MAUP_MESSAGE  * 256 + MESSAGE_TYPE_DATA_ACK,           "DATA_ACK" },
 230   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_REG_REQ ,           "REG_REQ" },
 231   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_REG_RSP ,           "REG_RSP" },
 232   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_REQ ,         "DEREG_REQ" },
 233   { MESSAGE_CLASS_IIM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_RSP ,         "DEREG_RSP" },
 234   { 0,                           NULL } };
 235
 236 static void
 237 dissect_common_header(tvbuff_t *common_header_tvb, packet_info *pinfo, proto_tree *m2ua_tree)
 238 {
 239   guint8  message_class, message_type;
 240
 241   /* Extract the common header */
 242   message_class  = tvb_get_guint8(common_header_tvb, MESSAGE_CLASS_OFFSET);
 243   message_type   = tvb_get_guint8(common_header_tvb, MESSAGE_TYPE_OFFSET);
 244
 245   if (check_col(pinfo->cinfo, COL_INFO))
 246     col_add_fstr(pinfo->cinfo, COL_INFO, "%s ", val_to_str(message_class * 256 + message_type, message_class_type_acro_values, "reserved"));
 247
 248   if (m2ua_tree) {
 249     /* add the components of the common header to the protocol tree */
 250     proto_tree_add_item(m2ua_tree, hf_version,        common_header_tvb, VERSION_OFFSET,        VERSION_LENGTH,        REP_BIG_ENDIAN);
 251     proto_tree_add_item(m2ua_tree, hf_reserved,       common_header_tvb, RESERVED_OFFSET,       RESERVED_LENGTH,       REP_BIG_ENDIAN);
 252     proto_tree_add_item(m2ua_tree, hf_message_class,  common_header_tvb, MESSAGE_CLASS_OFFSET,  MESSAGE_CLASS_LENGTH,  REP_BIG_ENDIAN);
 253     proto_tree_add_uint_format(m2ua_tree, hf_message_type, common_header_tvb, MESSAGE_TYPE_OFFSET, MESSAGE_TYPE_LENGTH, message_type,
 254                                "Message type: %s (%u)",
 255                                val_to_str(message_class * 256 + message_type, message_class_type_values, "reserved"), message_type);
 256     proto_tree_add_item(m2ua_tree, hf_message_length, common_header_tvb, MESSAGE_LENGTH_OFFSET, MESSAGE_LENGTH_LENGTH, REP_BIG_ENDIAN);
 257   }
 258 }
 259
 260 #define PARAMETER_TAG_LENGTH    2
 261 #define PARAMETER_LENGTH_LENGTH 2
 262 #define PARAMETER_HEADER_LENGTH (PARAMETER_TAG_LENGTH + PARAMETER_LENGTH_LENGTH)
 263
 264 #define PARAMETER_TAG_OFFSET    0
 265 #define PARAMETER_LENGTH_OFFSET (PARAMETER_TAG_OFFSET + PARAMETER_TAG_LENGTH)
 266 #define PARAMETER_VALUE_OFFSET  (PARAMETER_LENGTH_OFFSET + PARAMETER_LENGTH_LENGTH)
 267 #define PARAMETER_HEADER_OFFSET PARAMETER_TAG_OFFSET
 268
 269
 270 #define INT_INTERFACE_ID_OFFSET PARAMETER_VALUE_OFFSET
 271 #define INT_INTERFACE_ID_LENGTH 4
 272
 273 static void
 274 dissect_interface_identifier_int_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 275 {
 276   proto_tree_add_item(parameter_tree, hf_interface_id_int, parameter_tvb, INT_INTERFACE_ID_OFFSET, INT_INTERFACE_ID_LENGTH, REP_BIG_ENDIAN);
 277   proto_item_append_text(parameter_item, " (%d)", tvb_get_ntohl(parameter_tvb, INT_INTERFACE_ID_OFFSET));
 278 }
 279
 280 #define TEXT_INTERFACE_ID_OFFSET PARAMETER_VALUE_OFFSET
 281
 282 static void
 283 dissect_interface_identifier_text_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 284 {
 285   guint16 interface_id_length;
 286
 287   interface_id_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 288
 289   proto_tree_add_item(parameter_tree, hf_interface_id_text, parameter_tvb, TEXT_INTERFACE_ID_OFFSET, interface_id_length, REP_BIG_ENDIAN);
 290   proto_item_append_text(parameter_item, " (%.*s)", interface_id_length,
 291                          (const char *)tvb_get_ptr(parameter_tvb, TEXT_INTERFACE_ID_OFFSET, interface_id_length));
 292 }
 293
 294 #define INFO_STRING_OFFSET PARAMETER_VALUE_OFFSET
 295
 296 static void
 297 dissect_info_string_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 298 {
 299   guint16 info_string_length;
 300
 301   info_string_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 302   proto_tree_add_item(parameter_tree, hf_info_string, parameter_tvb, INFO_STRING_OFFSET, info_string_length, REP_BIG_ENDIAN);
 303   proto_item_append_text(parameter_item, " (%.*s)", info_string_length,
 304                          (const char *)tvb_get_ptr(parameter_tvb, INFO_STRING_OFFSET, info_string_length));
 305 }
 306
 307 #define DIAGNOSTIC_INFO_OFFSET PARAMETER_VALUE_OFFSET
 308
 309 static void
 310 dissect_diagnostic_information_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 311 {
 312   guint16 diag_info_length;
 313
 314   diag_info_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 315   proto_tree_add_item(parameter_tree, hf_diagnostic_information, parameter_tvb, DIAGNOSTIC_INFO_OFFSET, diag_info_length, REP_BIG_ENDIAN);
 316   proto_item_append_text(parameter_item, " (%u byte%s)", diag_info_length, plurality(diag_info_length, "", "s"));
 317 }
 318
 319 #define START_LENGTH 4
 320 #define END_LENGTH   4
 321 #define INTERVAL_LENGTH (START_LENGTH + END_LENGTH)
 322
 323 #define START_OFFSET 0
 324 #define END_OFFSET   (START_OFFSET + START_LENGTH)
 325
 326 static void
 327 dissect_interface_identifier_range_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 328 {
 329   guint16 number_of_ranges, range_number;
 330   gint offset;
 331
 332   number_of_ranges = (tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH) / INTERVAL_LENGTH;
 333   offset = PARAMETER_VALUE_OFFSET;
 334   for(range_number = 1; range_number <= number_of_ranges; range_number++) {
 335     proto_tree_add_item(parameter_tree, hf_interface_id_start, parameter_tvb, offset + START_OFFSET, START_LENGTH, REP_BIG_ENDIAN);
 336     proto_tree_add_item(parameter_tree, hf_interface_id_stop,  parameter_tvb, offset + END_OFFSET,   END_LENGTH,   REP_BIG_ENDIAN);
 337     offset += INTERVAL_LENGTH;
 338   };
 339
 340   proto_item_append_text(parameter_item, " (%u range%s)", number_of_ranges, plurality(number_of_ranges, "", "s"));
 341 }
 342
 343 #define HEARTBEAT_DATA_OFFSET PARAMETER_VALUE_OFFSET
 344
 345 static void
 346 dissect_heartbeat_data_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 347 {
 348   guint16 heartbeat_data_length;
 349
 350   heartbeat_data_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 351   proto_tree_add_item(parameter_tree, hf_heartbeat_data, parameter_tvb, HEARTBEAT_DATA_OFFSET, heartbeat_data_length, REP_BIG_ENDIAN);
 352   proto_item_append_text(parameter_item, " (%u byte%s)", heartbeat_data_length, plurality(heartbeat_data_length, "", "s"));
 353 }
 354
 355 #define OVER_RIDE_TYPE   1
 356 #define LOAD_SHARE_TYPE  2
 357 #define BROADCAST_TYPE   3
 358
 359 static const value_string traffic_mode_type_values[] = {
 360   { OVER_RIDE_TYPE ,            "Override" },
 361   { LOAD_SHARE_TYPE,            "Load-share" },
 362   { BROADCAST_TYPE,             "Broadcast" },
 363   { 0,                          NULL } };
 364
 365 #define TRAFFIC_MODE_TYPE_LENGTH 4
 366 #define TRAFFIC_MODE_TYPE_OFFSET PARAMETER_VALUE_OFFSET
 367
 368 static void
 369 dissect_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 370 {
 371   proto_tree_add_item(parameter_tree, hf_traffic_mode_type, parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH, REP_BIG_ENDIAN);
 372   proto_item_append_text(parameter_item, " (%s)",
 373                          val_to_str(tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET), traffic_mode_type_values, "unknown"));
 374 }
 375
 376 #define INVALID_VERSION_ERROR_CODE                       0x01
 377 #define INVALID_INTERFACE_IDENTIFIER_ERROR_CODE          0x02
 378 #define UNSUPPORTED_MESSAGE_CLASS_ERROR_CODE             0x03
 379 #define UNSUPPORTED_MESSAGE_TYPE_ERROR_CODE              0x04
 380 #define UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR_CODE     0x05
 381 #define UNEXPECTED_MESSAGE_ERROR_CODE                    0x06
 382 #define PROTOCOL_ERROR_ERROR_CODE                        0x07
 383 #define UNSUPPORTED_INTERFACE_IDENTIFIER_TYPE_ERROR_CODE 0x08
 384 #define INVALID_STREAM_IDENTIFIER_ERROR_CODE             0x09
 385 #define REFUSED_ERROR_CODE                               0x0d
 386 #define ASP_IDENTIFIER_REQUIRED_ERROR_CODE               0x0e
 387 #define INVALID_ASP_IDENTIFIER_ERROR_CODE                0x0f
 388 #define ASP_ACTIVE_FOR_INTERFACE_IDENTIFIER_ERROR_CODE   0x10
 389 #define INVALID_PARAMETER_VALUE_ERROR_CODE               0x11
 390 #define PARAMETER_FIELD_ERROR_CODE                       0x12
 391 #define UNEXPECTED_PARAMETER_ERROR_CODE                  0x13
 392 #define MISSING_PARAMETER_ERROR_CODE                     0x16
 393
 394 static const value_string error_code_values[] = {
 395   { INVALID_VERSION_ERROR_CODE,                       "Invalid version" },
 396   { INVALID_INTERFACE_IDENTIFIER_ERROR_CODE,          "Invalid interface identifier" },
 397   { UNSUPPORTED_MESSAGE_CLASS_ERROR_CODE,             "Unsupported message class" },
 398   { UNSUPPORTED_MESSAGE_TYPE_ERROR_CODE,              "Unsupported message type" },
 399   { UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR_CODE,     "Unsupported traffic handling mode" },
 400   { UNEXPECTED_MESSAGE_ERROR_CODE,                    "Unexpected message" },
 401   { PROTOCOL_ERROR_ERROR_CODE,                        "Protocol error" },
 402   { UNSUPPORTED_INTERFACE_IDENTIFIER_TYPE_ERROR_CODE, "Unsupported interface identifier type" },
 403   { INVALID_STREAM_IDENTIFIER_ERROR_CODE,             "Invalid stream identifier" },
 404   { REFUSED_ERROR_CODE,                               "Refused - management blocking" },
 405   { ASP_IDENTIFIER_REQUIRED_ERROR_CODE,               "ASP identifier required" },
 406   { INVALID_ASP_IDENTIFIER_ERROR_CODE,                "Invalid ASP identifier" },
 407   { ASP_ACTIVE_FOR_INTERFACE_IDENTIFIER_ERROR_CODE,   "ASP active for interface identifier" },
 408   { INVALID_PARAMETER_VALUE_ERROR_CODE,               "Invalid parameter value" },
 409   { PARAMETER_FIELD_ERROR_CODE,                       "Parameter field error" },
 410   { UNEXPECTED_PARAMETER_ERROR_CODE,                  "Unexpected parameter" },
 411   { MISSING_PARAMETER_ERROR_CODE,                     "Missing parameter" },
 412   { 0,                                                NULL } };
 413
 414 #define ERROR_CODE_LENGTH 4
 415 #define ERROR_CODE_OFFSET PARAMETER_VALUE_OFFSET
 416
 417 static void
 418 dissect_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 419 {
 420   proto_tree_add_item(parameter_tree, hf_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, REP_BIG_ENDIAN);
 421   proto_item_append_text(parameter_item, " (%s)",
 422                          val_to_str(tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET), error_code_values, "unknown"));
 423 }
 424
 425 #define AS_STATE_CHANGE_TYPE       1
 426 #define OTHER_TYPE                 2
 427
 428 static const value_string status_type_values[] = {
 429   { AS_STATE_CHANGE_TYPE,            "Application server state change" },
 430   { OTHER_TYPE,                      "Other" },
 431   { 0,                           NULL } };
 432
 433 #define RESERVED_INFO              1
 434 #define AS_INACTIVE_INFO           2
 435 #define AS_ACTIVE_INFO             3
 436 #define AS_PENDING_INFO            4
 437
 438 #define INSUFFICIENT_ASP_RES_INFO  1
 439 #define ALTERNATE_ASP_ACTIVE_INFO  2
 440 #define ASP_FAILURE_INFO           3
 441
 442 static const value_string status_type_id_values[] = {
 443   { AS_STATE_CHANGE_TYPE * 256 * 256 + RESERVED_INFO,             "Reserved" },
 444   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_INACTIVE_INFO,          "Application server inactive" },
 445   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_ACTIVE_INFO,            "Application server active" },
 446   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_PENDING_INFO,           "Application server pending" },
 447   { OTHER_TYPE           * 256 * 256 + INSUFFICIENT_ASP_RES_INFO, "Insufficient ASP resources active in AS" },
 448   { OTHER_TYPE           * 256 * 256 + ALTERNATE_ASP_ACTIVE_INFO, "Alternate ASP active" },
 449   { OTHER_TYPE           * 256 * 256 + ASP_FAILURE_INFO,          "ASP Failure" },
 450   {0,                           NULL } };
 451
 452 #define STATUS_TYPE_LENGTH  2
 453 #define STATUS_IDENT_LENGTH 2
 454
 455 #define STATUS_TYPE_OFFSET  PARAMETER_VALUE_OFFSET
 456 #define STATUS_IDENT_OFFSET (STATUS_TYPE_OFFSET + STATUS_TYPE_LENGTH)
 457
 458 static void
 459 dissect_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 460 {
 461   guint16 status_type, status_id;
 462
 463   status_type = tvb_get_ntohs(parameter_tvb, STATUS_TYPE_OFFSET);
 464   status_id   = tvb_get_ntohs(parameter_tvb, STATUS_IDENT_OFFSET);
 465
 466   proto_tree_add_item(parameter_tree, hf_status_type, parameter_tvb, STATUS_TYPE_OFFSET, STATUS_TYPE_LENGTH, REP_BIG_ENDIAN);
 467   proto_tree_add_uint_format(parameter_tree, hf_status_ident,  parameter_tvb, STATUS_IDENT_OFFSET, STATUS_IDENT_LENGTH,
 468                              status_id, "Status identification: %u (%s)", status_id,
 469                              val_to_str(status_type * 256 * 256 + status_id, status_type_id_values, "unknown"));
 470
 471   proto_item_append_text(parameter_item, " (%s)",
 472                          val_to_str(status_type * 256 * 256 + status_id, status_type_id_values, "unknown status information"));
 473 }
 474
 475 #define ASP_IDENTIFIER_OFFSET PARAMETER_VALUE_OFFSET
 476 #define ASP_IDENTIFIER_LENGTH  4
 477
 478 static void
 479 dissect_asp_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 480 {
 481   proto_tree_add_item(parameter_tree, hf_asp_id, parameter_tvb, ASP_IDENTIFIER_OFFSET, ASP_IDENTIFIER_LENGTH, REP_BIG_ENDIAN);
 482   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohl(parameter_tvb, ASP_IDENTIFIER_OFFSET));
 483 }
 484
 485 #define CORRELATION_ID_LENGTH 4
 486 #define CORRELATION_ID_OFFSET PARAMETER_VALUE_OFFSET
 487
 488 static void
 489 dissect_correlation_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 490 {
 491   proto_tree_add_item(parameter_tree, hf_correlation_id, parameter_tvb, CORRELATION_ID_OFFSET, CORRELATION_ID_LENGTH, REP_BIG_ENDIAN);
 492   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohl(parameter_tvb, CORRELATION_ID_OFFSET));
 493 }
 494
 495 #define DATA_1_MTP3_OFFSET PARAMETER_VALUE_OFFSET
 496
 497 static void
 498 dissect_protocol_data_1_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_item *parameter_item)
 499 {
 500   tvbuff_t *payload_tvb;
 501   guint32 payload_length;
 502
 503   payload_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 504
 505   payload_tvb = tvb_new_subset(parameter_tvb, DATA_1_MTP3_OFFSET, payload_length, payload_length);
 506   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH);
 507   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
 508
 509   proto_item_set_text(parameter_item, "Data 1 parameter");
 510 }
 511
 512 #define DATA_2_LI_LENGTH   1
 513 #define DATA_2_LI_OFFSET   PARAMETER_VALUE_OFFSET
 514 #define DATA_2_MTP3_OFFSET (DATA_2_LI_OFFSET + DATA_2_LI_LENGTH)
 515
 516 static void
 517 dissect_protocol_data_2_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
 518 {
 519   tvbuff_t *payload_tvb;
 520   guint32 payload_length;
 521
 522   payload_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH - DATA_2_LI_LENGTH;
 523
 524   proto_tree_add_item(parameter_tree, hf_data_2_li, parameter_tvb, DATA_2_LI_OFFSET, DATA_2_LI_LENGTH, REP_BIG_ENDIAN);
 525   payload_tvb = tvb_new_subset(parameter_tvb, DATA_2_MTP3_OFFSET, payload_length, payload_length);
 526   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH + DATA_2_LI_LENGTH);
 527   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
 528 }
 529
 530
 531 #define STATUS_LPO_SET          0x0
 532 #define STATUS_LPO_CLEAR        0x1
 533 #define STATUS_EMER_SET         0x2
 534 #define STATUS_EMER_CLEAR       0x3
 535 #define STATUS_FLUSH_BUFFERS    0x4
 536 #define STATUS_CONTINUE         0x5
 537 #define STATUS_CLEAR_RTB        0x6
 538 #define STATUS_AUDIT            0x7
 539 #define STATUS_CONG_CLEAR       0x8
 540 #define STATUS_CONG_ACCEPT      0x9
 541 #define STATUS_CONG_DISCARD     0xa
 542
 543 static const value_string state_values[] = {
 544   { STATUS_LPO_SET,        "Request local processor outage" },
 545   { STATUS_LPO_CLEAR,      "Request local processor outage recovered" },
 546   { STATUS_EMER_SET,       "Request emergency alignment" },
 547   { STATUS_EMER_CLEAR,     "Request normal alignment (cancel emergency)" },
 548   { STATUS_FLUSH_BUFFERS,  "Flush or clear receive, transmit and retransmit queues" },
 549   { STATUS_CONTINUE,       "Continue or Resume" },
 550   { STATUS_CLEAR_RTB,      "Clear the retransmit queue" },
 551   { STATUS_AUDIT,          "Audit state of link" },
 552   { STATUS_CONG_CLEAR,     "Congestion cleared" },
 553   { STATUS_CONG_ACCEPT,    "Congestion accept" },
 554   { STATUS_CONG_DISCARD,   "Congestion discard" },
 555   {0,                       NULL } };
 556
 557 #define STATE_LENGTH 4
 558 #define STATE_OFFSET PARAMETER_VALUE_OFFSET
 559
 560 static void
 561 dissect_state_request_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 562 {
 563   proto_tree_add_item(parameter_tree, hf_state, parameter_tvb, STATE_OFFSET, STATE_LENGTH, REP_BIG_ENDIAN);
 564   proto_item_append_text(parameter_item, " (%s)", val_to_str(tvb_get_ntohl(parameter_tvb, STATE_OFFSET), state_values, "unknown"));
 565 }
 566
 567 #define EVENT_RPO_ENTER        0x1
 568 #define EVENT_RPO_EXIT         0x2
 569 #define EVENT_LPO_ENTER        0x3
 570 #define EVENT_LPO_EXIT         0x4
 571
 572 static const value_string event_values[] = {
 573   { EVENT_RPO_ENTER, "Remote entered processor outage" },
 574   { EVENT_RPO_EXIT,  "Remote exited processor outage" },
 575   { EVENT_LPO_ENTER, "Link entered processor outage" },
 576   { EVENT_LPO_EXIT,  "Link exited processor outage" },
 577   {0,                NULL } };
 578
 579 #define EVENT_LENGTH 4
 580 #define EVENT_OFFSET PARAMETER_VALUE_OFFSET
 581
 582 static void
 583 dissect_state_event_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 584 {
 585   proto_tree_add_item(parameter_tree, hf_event, parameter_tvb, EVENT_OFFSET, EVENT_LENGTH, REP_BIG_ENDIAN);
 586   proto_item_append_text(parameter_item, " (%s)", val_to_str(tvb_get_ntohl(parameter_tvb, STATE_OFFSET), event_values, "unknown"));
 587 }
 588
 589 #define LEVEL_NONE       0x0
 590 #define LEVEL_1          0x1
 591 #define LEVEL_2          0x2
 592 #define LEVEL_3          0x3
 593
 594 static const value_string level_values[] = {
 595   { LEVEL_NONE, "No congestion" },
 596   { LEVEL_1,    "Congestion Level 1" },
 597   { LEVEL_2,    "Congestion Level 2" },
 598   { LEVEL_3,    "Congestion Level 3" },
 599   {0,           NULL } };
 600
 601 #define CONGESTION_STATUS_LENGTH 4
 602 #define CONGESTION_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 603
 604 static void
 605 dissect_congestion_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 606 {
 607   proto_tree_add_item(parameter_tree, hf_congestion_status, parameter_tvb, CONGESTION_STATUS_OFFSET, CONGESTION_STATUS_LENGTH, REP_BIG_ENDIAN);
 608   proto_item_append_text(parameter_item, " (%s)", val_to_str(tvb_get_ntohl(parameter_tvb, CONGESTION_STATUS_OFFSET), level_values, "unknown"));
 609 }
 610
 611 #define DISCARD_STATUS_LENGTH 4
 612 #define DISCARD_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 613
 614 static void
 615 dissect_discard_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 616 {
 617   proto_tree_add_item(parameter_tree, hf_discard_status, parameter_tvb, DISCARD_STATUS_OFFSET, DISCARD_STATUS_LENGTH, REP_BIG_ENDIAN);
 618   proto_item_append_text(parameter_item, " (%s)", val_to_str(tvb_get_ntohl(parameter_tvb, DISCARD_STATUS_OFFSET), level_values, "unknown"));
 619 }
 620
 621 #define ACTION_RTRV_BSN      0x1
 622 #define ACTION_RTRV_MSGS     0x2
 623
 624 static const value_string action_values[] = {
 625   { ACTION_RTRV_BSN,  "Retrieve the backward sequence number" },
 626   { ACTION_RTRV_MSGS, "Retrieve the PDUs from the transmit and retransmit queues" },
 627   {0,                  NULL } };
 628
 629
 630 #define ACTION_LENGTH 4
 631 #define ACTION_OFFSET PARAMETER_VALUE_OFFSET
 632
 633 static void
 634 dissect_action_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 635 {
 636   proto_tree_add_uint(parameter_tree, hf_action, parameter_tvb, ACTION_OFFSET, ACTION_LENGTH, REP_BIG_ENDIAN);
 637   proto_item_append_text(parameter_item, " (%s)", val_to_str(tvb_get_ntohl(parameter_tvb, ACTION_OFFSET), action_values, "unknown"));
 638 }
 639
 640 #define SEQUENCE_NUMBER_LENGTH 4
 641 #define SEQUENCE_NUMBER_OFFSET PARAMETER_VALUE_OFFSET
 642
 643 static void
 644 dissect_sequence_number_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 645 {
 646   proto_tree_add_item(parameter_tree, hf_sequence_number, parameter_tvb, SEQUENCE_NUMBER_OFFSET, SEQUENCE_NUMBER_LENGTH, REP_BIG_ENDIAN);
 647   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohl(parameter_tvb, SEQUENCE_NUMBER_OFFSET));
 648 }
 649
 650 #define RESULT_SUCCESS       0x0
 651 #define RESULT_FAILURE       0x1
 652
 653 static const value_string retrieval_result_values[] = {
 654   { RESULT_SUCCESS,    "Action successful" },
 655   { RESULT_FAILURE ,   "Action failed" },
 656   { 0,                  NULL } };
 657
 658
 659 #define RETRIEVAL_RESULT_LENGTH 4
 660 #define RETRIEVAL_RESULT_OFFSET PARAMETER_VALUE_OFFSET
 661
 662 static void
 663 dissect_retrieval_result_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 664 {
 665   proto_tree_add_item(parameter_tree, hf_retrieval_result, parameter_tvb, RETRIEVAL_RESULT_OFFSET, RETRIEVAL_RESULT_LENGTH, REP_BIG_ENDIAN);
 666   proto_item_append_text(parameter_item, " (%s)",  val_to_str(tvb_get_ntohl(parameter_tvb, RETRIEVAL_RESULT_OFFSET), retrieval_result_values, "unknown"));
 667 }
 668
 669 static void
 670 dissect_link_key_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree)
 671 {
 672   tvbuff_t *parameters_tvb;
 673   guint16 parameters_length;
 674
 675   parameters_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 676   parameters_tvb    = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 677   dissect_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 678 }
 679
 680 #define LOCAL_LK_ID_LENGTH 4
 681 #define LOCAL_LK_ID_OFFSET PARAMETER_VALUE_OFFSET
 682
 683 static void
 684 dissect_local_lk_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 685 {
 686   proto_tree_add_item(parameter_tree, hf_local_lk_id, parameter_tvb, LOCAL_LK_ID_OFFSET, LOCAL_LK_ID_LENGTH, REP_BIG_ENDIAN);
 687   proto_item_append_text(parameter_item, " (%u)",  tvb_get_ntohl(parameter_tvb, LOCAL_LK_ID_OFFSET));
 688 }
 689
 690 #define SDT_RESERVED_LENGTH 2
 691 #define SDT_ID_LENGTH       2
 692 #define SDT_RESERVED_OFFSET PARAMETER_VALUE_OFFSET
 693 #define SDT_ID_OFFSET       (SDT_RESERVED_OFFSET + SDT_RESERVED_LENGTH)
 694
 695 static void
 696 dissect_sdt_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 697 {
 698   proto_tree_add_item(parameter_tree, hf_sdt_reserved, parameter_tvb, SDT_RESERVED_OFFSET, SDT_RESERVED_LENGTH, REP_BIG_ENDIAN);
 699   proto_tree_add_item(parameter_tree, hf_sdt_id, parameter_tvb,       SDT_ID_OFFSET,       SDT_ID_LENGTH,       REP_BIG_ENDIAN);
 700   proto_item_append_text(parameter_item, " (%u)",  tvb_get_ntohs(parameter_tvb, SDT_ID_OFFSET));
 701 }
 702
 703 #define SDL_RESERVED_LENGTH 2
 704 #define SDL_ID_LENGTH       2
 705 #define SDL_RESERVED_OFFSET PARAMETER_VALUE_OFFSET
 706 #define SDL_ID_OFFSET       (SDL_RESERVED_OFFSET + SDL_RESERVED_LENGTH)
 707
 708 static void
 709 dissect_sdl_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 710 {
 711   proto_tree_add_item(parameter_tree, hf_sdl_reserved, parameter_tvb, SDL_RESERVED_OFFSET, SDL_RESERVED_LENGTH, REP_BIG_ENDIAN);
 712   proto_tree_add_item(parameter_tree, hf_sdl_id,       parameter_tvb, SDL_ID_OFFSET,       SDL_ID_LENGTH,       REP_BIG_ENDIAN);
 713   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohs(parameter_tvb, SDL_ID_OFFSET));
 714 }
 715
 716 static void
 717 dissect_registration_result_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree)
 718 {
 719   tvbuff_t *parameters_tvb;
 720   guint16  parameters_length;
 721
 722   parameters_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 723   parameters_tvb    = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 724   dissect_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 725 }
 726
 727 #define SUCCESSFULL_REGISTRATION_STATUS               0
 728 #define UNKNOWN_REGISTRATION_STATUS                   1
 729 #define INVALID_SDLI_REGISTRATION_STATUS              2
 730 #define INVALID_SDTI_REGISTRATION_STATUS              3
 731 #define INVALID_LINK_KEY_REGISTRATION_STATUS          4
 732 #define PERMISSION_DENIED_REGISTRATION_STATUS         5
 733 #define OVERLAPPING_LINK_KEY_REGISTRATION_STATUS      6
 734 #define LINK_KEY_NOT_PROVISIONED_REGISTRATION_STATUS  7
 735 #define INSUFFICIENT_RESOURCES_REGISTRATION_STATUS    8
 736
 737 static const value_string registration_status_values[] = {
 738   { SUCCESSFULL_REGISTRATION_STATUS,              "Successfully registered" },
 739   { UNKNOWN_REGISTRATION_STATUS,                  "Error - Unknown" },
 740   { INVALID_SDLI_REGISTRATION_STATUS,             "Error - Invalid SDLI" },
 741   { INVALID_SDTI_REGISTRATION_STATUS,             "Error - Invalid SDTI" },
 742   { INVALID_LINK_KEY_REGISTRATION_STATUS,         "Error - Invalid link key" },
 743   { PERMISSION_DENIED_REGISTRATION_STATUS,        "Error - Permission denied" },
 744   { OVERLAPPING_LINK_KEY_REGISTRATION_STATUS,     "Error - Overlapping (Non-unique) link key" },
 745   { LINK_KEY_NOT_PROVISIONED_REGISTRATION_STATUS, "Error - Link key not provisioned" },
 746   { INSUFFICIENT_RESOURCES_REGISTRATION_STATUS,   "Error - Insufficient resources" },
 747   { 0,                  NULL } };
 748
 749 #define REGISTRATION_STATUS_LENGTH 4
 750 #define REGISTRATION_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 751
 752 static void
 753 dissect_registration_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 754 {
 755   proto_tree_add_item(parameter_tree, hf_registration_status, parameter_tvb, REGISTRATION_STATUS_OFFSET, REGISTRATION_STATUS_LENGTH, REP_BIG_ENDIAN);
 756   proto_item_append_text(parameter_item, " (%s)",  val_to_str(tvb_get_ntohl(parameter_tvb, REGISTRATION_STATUS_OFFSET), registration_status_values, "unknown"));
 757 }
 758
 759 static void
 760 dissect_deregistration_result_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree)
 761 {
 762   tvbuff_t *parameters_tvb;
 763   guint16  parameters_length;
 764
 765   parameters_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 766   parameters_tvb    = tvb_new_subset(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length, parameters_length);
 767   dissect_parameters(parameters_tvb, pinfo, tree, parameter_tree);
 768 }
 769
 770 #define SUCCESSFULL_DEREGISTRATION_STATUS                  0
 771 #define UNKNOWN_DEREGISTRATION_STATUS                      1
 772 #define INVALID_INTERFACE_IDENTIFIER_DEREGISTRATION_STATUS 2
 773 #define PERMISSION_DENIED_DEREGISTRATION_STATUS            3
 774 #define NOT_REGISTRED_DEREGISTRATION_STATUS                4
 775
 776 static const value_string deregistration_status_values[] = {
 777   { SUCCESSFULL_DEREGISTRATION_STATUS,                  "Successfully deregistered" },
 778   { UNKNOWN_DEREGISTRATION_STATUS,                      "Error - Unknown" },
 779   { INVALID_INTERFACE_IDENTIFIER_DEREGISTRATION_STATUS, "Error - Invalid interface identifier" },
 780   { PERMISSION_DENIED_DEREGISTRATION_STATUS,            "Error - Permission denied" },
 781   { NOT_REGISTRED_DEREGISTRATION_STATUS,                "Error - Not registered" },
 782   { 0,                                                  NULL } };
 783
 784 #define DEREGISTRATION_STATUS_LENGTH 4
 785 #define DEREGISTRATION_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 786
 787 static void
 788 dissect_deregistration_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 789 {
 790   proto_tree_add_item(parameter_tree, hf_deregistration_status, parameter_tvb, DEREGISTRATION_STATUS_OFFSET, DEREGISTRATION_STATUS_LENGTH, REP_BIG_ENDIAN);
 791   proto_item_append_text(parameter_item, " (%s)",  val_to_str(tvb_get_ntohl(parameter_tvb, DEREGISTRATION_STATUS_OFFSET), deregistration_status_values, "unknown"));
 792 }
 793
 794 static void
 795 dissect_unknown_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 796 {
 797   guint16 parameter_value_length;
 798
 799   parameter_value_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 800   if (parameter_value_length > 0)
 801     proto_tree_add_item(parameter_tree, hf_parameter_value, parameter_tvb, PARAMETER_VALUE_OFFSET, parameter_value_length, REP_BIG_ENDIAN);
 802   proto_item_append_text(parameter_item, " with tag %u and %u byte%s value",
 803                          tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET), parameter_value_length, plurality(parameter_value_length, "", "s"));
 804 }
 805
 806 /* Common parameter tags */
 807 #define INTERFACE_IDENTIFIER_INT_PARAMETER_TAG     0x0001
 808 #define INTERFACE_IDENTIFIER_TEXT_PARAMETER_TAG    0x0003
 809 #define INFO_STRING_PARAMETER_TAG                  0x0004
 810 #define DIAGNOSTIC_INFORMATION_PARAMETER_TAG       0x0007
 811 #define INTERFACE_IDENTIFIER_RANGE_PARAMETER_TAG   0x0008
 812 #define HEARTBEAT_DATA_PARAMETER_TAG               0x0009
 813 #define TRAFFIC_MODE_TYPE_PARAMETER_TAG            0x000b
 814 #define ERROR_CODE_PARAMETER_TAG                   0x000c
 815 #define STATUS_PARAMETER_TAG                       0x000d
 816 #define ASP_IDENTIFIER_PARAMETER_TAG               0x0011
 817 #define CORRELATION_IDENTIFIER_PARAMETER_TAG       0x0013
 818
 819 /* M2PA specific parameter tags */
 820 #define PROTOCOL_DATA_1_PARAMETER_TAG              0x0300
 821 #define PROTOCOL_DATA_2_PARAMETER_TAG              0x0301
 822 #define STATE_REQUEST_PARAMETER_TAG                0x0302
 823 #define STATE_EVENT_PARAMETER_TAG                  0x0303
 824 #define CONGESTION_STATUS_PARAMETER_TAG            0x0304
 825 #define DISCARD_STATUS_PARAMETER_TAG               0x0305
 826 #define ACTION_PARAMETER_TAG                       0x0306
 827 #define SEQUENCE_NUMBER_PARAMETER_TAG              0x0307
 828 #define RETRIEVAL_RESULT_PARAMETER_TAG             0x0308
 829 #define LINK_KEY_PARAMETER_TAG                     0x0309
 830 #define LOCAL_LK_IDENTIFIER_PARAMETER_TAG          0x030a
 831 #define SDT_IDENTIFIER_PARAMETER_TAG               0x030b
 832 #define SDL_IDENTIFIER_PARAMETER_TAG               0x030c
 833 #define REG_RESULT_PARAMETER_TAG                   0x030d
 834 #define REG_STATUS_PARAMETER_TAG                   0x030e
 835 #define DEREG_RESULT_PARAMETER_TAG                 0x030f
 836 #define DEREG_STATUS_PARAMETER_TAG                 0x0310
 837
 838 static const value_string parameter_tag_values[] = {
 839   { INTERFACE_IDENTIFIER_INT_PARAMETER_TAG,        "Interface identifier (integer)" },
 840   { INTERFACE_IDENTIFIER_TEXT_PARAMETER_TAG,       "Interface identifier (text)" },
 841   { INFO_STRING_PARAMETER_TAG,                     "Info string" },
 842   { DIAGNOSTIC_INFORMATION_PARAMETER_TAG,          "Diagnostic information" },
 843   { INTERFACE_IDENTIFIER_RANGE_PARAMETER_TAG,      "Interface identifier (integer range)" },
 844   { HEARTBEAT_DATA_PARAMETER_TAG,                  "Heartbeat data" },
 845   { TRAFFIC_MODE_TYPE_PARAMETER_TAG,               "Traffic mode type" },
 846   { ERROR_CODE_PARAMETER_TAG,                      "Error code" },
 847   { STATUS_PARAMETER_TAG,                          "Status type / information" },
 848   { ASP_IDENTIFIER_PARAMETER_TAG,                  "ASP identifier" },
 849   { CORRELATION_IDENTIFIER_PARAMETER_TAG,          "Correlation identifier" },
 850   { PROTOCOL_DATA_1_PARAMETER_TAG,                 "Protocol data 1" },
 851   { PROTOCOL_DATA_2_PARAMETER_TAG,                 "Protocol data 2" },
 852   { STATE_REQUEST_PARAMETER_TAG,                   "State request" },
 853   { STATE_EVENT_PARAMETER_TAG,                     "State event" },
 854   { CONGESTION_STATUS_PARAMETER_TAG,               "Congestion state" },
 855   { DISCARD_STATUS_PARAMETER_TAG,                  "Discard state" },
 856   { ACTION_PARAMETER_TAG,                          "Action" },
 857   { SEQUENCE_NUMBER_PARAMETER_TAG,                 "Sequence number" },
 858   { RETRIEVAL_RESULT_PARAMETER_TAG,                "Retrieval result" },
 859   { LINK_KEY_PARAMETER_TAG,                        "Link key" },
 860   { LOCAL_LK_IDENTIFIER_PARAMETER_TAG,             "Local LK identifier" },
 861   { SDT_IDENTIFIER_PARAMETER_TAG,                  "SDT identifier" },
 862   { SDL_IDENTIFIER_PARAMETER_TAG,                  "SDL identifer" },
 863   { REG_RESULT_PARAMETER_TAG,                      "Registration result" },
 864   { REG_STATUS_PARAMETER_TAG,                      "Registration status" },
 865   { DEREG_RESULT_PARAMETER_TAG,                    "Deregistration result" },
 866   { DEREG_STATUS_PARAMETER_TAG,                    "Deregistration status" },
 867   { 0,                           NULL } };
 868
 869 /*
 870  * Default preference for 'Protocol Data 1 Parameter Tag' is RFC3331 value
 871  * defined above (PROTOCOL_DATA_1_PARAMETER_TAG)
 872  *
 873  * The other option is the old Draft 7 value defined below.
 874  */
 875 #define PROTOCOL_DATA_1_DRAFT_7                         0x000e
 876 static gint protocol_data_1_global = PROTOCOL_DATA_1_PARAMETER_TAG;
 877
 878 static void
 879 dissect_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m2ua_tree)
 880 {
 881   guint16 tag, length, padding_length;
 882   proto_item *parameter_item;
 883   proto_tree *parameter_tree;
 884
 885   /* extract tag and length from the parameter */
 886   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
 887   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 888
 889   /* calculate padding and total length */
 890   padding_length = tvb_length(parameter_tvb) - length;
 891
 892   /* create proto_tree stuff */
 893   parameter_item   = proto_tree_add_text(m2ua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, tvb_length(parameter_tvb), "%s",
 894                                          val_to_str(tag, parameter_tag_values, "Unknown parameter"));
 895   parameter_tree   = proto_item_add_subtree(parameter_item, ett_m2ua_parameter);
 896
 897   if ((protocol_data_1_global == PROTOCOL_DATA_1_DRAFT_7) &&
 898       (tag == PROTOCOL_DATA_1_DRAFT_7))
 899   {
 900      proto_item *hidden_item;
 901      hidden_item = proto_tree_add_uint(parameter_tree, hf_parameter_tag, parameter_tvb, PARAMETER_TAG_OFFSET, PARAMETER_TAG_LENGTH, tag);
 902      PROTO_ITEM_SET_HIDDEN(hidden_item);
 903
 904      /* add tag and length to the m2ua tree */
 905      proto_tree_add_text(parameter_tree, parameter_tvb, PARAMETER_TAG_OFFSET, PARAMETER_TAG_LENGTH,
 906                       "Parameter Tag: Protocol data 1 (0x000e)");
 907
 908      proto_tree_add_item(parameter_tree, hf_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, REP_BIG_ENDIAN);
 909      tag = PROTOCOL_DATA_1_PARAMETER_TAG;
 910   }
 911   else
 912   {
 913       /* add tag and length to the m2ua tree */
 914       proto_tree_add_item(parameter_tree, hf_parameter_tag,    parameter_tvb, PARAMETER_TAG_OFFSET,    PARAMETER_TAG_LENGTH,    REP_BIG_ENDIAN);
 915       proto_tree_add_item(parameter_tree, hf_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, REP_BIG_ENDIAN);
 916   }
 917
 918   switch(tag) {
 919   case INTERFACE_IDENTIFIER_INT_PARAMETER_TAG:
 920     dissect_interface_identifier_int_parameter(parameter_tvb, parameter_tree, parameter_item);
 921     break;
 922   case INTERFACE_IDENTIFIER_TEXT_PARAMETER_TAG:
 923     dissect_interface_identifier_text_parameter(parameter_tvb, parameter_tree, parameter_item);
 924     break;
 925   case INFO_STRING_PARAMETER_TAG:
 926     dissect_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
 927     break;
 928   case DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
 929     dissect_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
 930     break;
 931   case INTERFACE_IDENTIFIER_RANGE_PARAMETER_TAG:
 932     dissect_interface_identifier_range_parameter(parameter_tvb, parameter_tree, parameter_item);
 933     break;
 934   case HEARTBEAT_DATA_PARAMETER_TAG:
 935     dissect_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
 936     break;
 937   case TRAFFIC_MODE_TYPE_PARAMETER_TAG:
 938     dissect_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
 939     break;
 940   case ERROR_CODE_PARAMETER_TAG:
 941     dissect_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
 942     break;
 943   case STATUS_PARAMETER_TAG:
 944     dissect_status_parameter(parameter_tvb, parameter_tree, parameter_item);
 945     break;
 946   case ASP_IDENTIFIER_PARAMETER_TAG:
 947     dissect_asp_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 948     break;
 949   case CORRELATION_IDENTIFIER_PARAMETER_TAG:
 950     dissect_correlation_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 951     break;
 952   case PROTOCOL_DATA_1_PARAMETER_TAG:
 953     if (protocol_data_1_global == PROTOCOL_DATA_1_DRAFT_7)
 954     {
 955        tag = PROTOCOL_DATA_1_DRAFT_7;
 956     }
 957     dissect_protocol_data_1_parameter(parameter_tvb, pinfo, tree, parameter_item);
 958     break;
 959   case PROTOCOL_DATA_2_PARAMETER_TAG:
 960     dissect_protocol_data_2_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
 961     break;
 962   case STATE_REQUEST_PARAMETER_TAG:
 963     dissect_state_request_parameter(parameter_tvb, parameter_tree, parameter_item);
 964     break;
 965   case STATE_EVENT_PARAMETER_TAG:
 966     dissect_state_event_parameter(parameter_tvb, parameter_tree, parameter_item);
 967     break;
 968   case CONGESTION_STATUS_PARAMETER_TAG:
 969     dissect_congestion_status_parameter(parameter_tvb, parameter_tree, parameter_item);
 970     break;
 971   case DISCARD_STATUS_PARAMETER_TAG:
 972     dissect_discard_status_parameter(parameter_tvb, parameter_tree, parameter_item);
 973     break;
 974   case ACTION_PARAMETER_TAG:
 975     dissect_action_parameter(parameter_tvb, parameter_tree, parameter_item);
 976     break;
 977   case SEQUENCE_NUMBER_PARAMETER_TAG:
 978     dissect_sequence_number_parameter(parameter_tvb, parameter_tree, parameter_item);
 979     break;
 980   case RETRIEVAL_RESULT_PARAMETER_TAG:
 981     dissect_retrieval_result_parameter(parameter_tvb, parameter_tree, parameter_item);
 982     break;
 983   case LINK_KEY_PARAMETER_TAG:
 984     dissect_link_key_parameter(parameter_tvb, pinfo, tree, parameter_tree);
 985     break;
 986   case LOCAL_LK_IDENTIFIER_PARAMETER_TAG:
 987     dissect_local_lk_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 988     break;
 989   case SDT_IDENTIFIER_PARAMETER_TAG:
 990     dissect_sdt_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 991     break;
 992   case SDL_IDENTIFIER_PARAMETER_TAG:
 993     dissect_sdl_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 994     break;
 995   case REG_RESULT_PARAMETER_TAG:
 996     dissect_registration_result_parameter(parameter_tvb, pinfo, tree, parameter_tree);
 997     break;
 998   case REG_STATUS_PARAMETER_TAG:
 999     dissect_registration_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1000     break;
1001   case DEREG_RESULT_PARAMETER_TAG:
1002     dissect_deregistration_result_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1003     break;
1004   case DEREG_STATUS_PARAMETER_TAG:
1005     dissect_deregistration_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1006     break;
1007   default:
1008     dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
1009     break;
1010   };
1011
1012   if (padding_length > 0)
1013     proto_tree_add_item(parameter_tree, hf_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length, REP_BIG_ENDIAN);
1014 }
1015
1016
1017 static void
1018 dissect_parameters(tvbuff_t *parameters_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m2ua_tree)
1019 {
1020   gint offset, length, total_length, remaining_length;
1021   tvbuff_t *parameter_tvb;
1022
1023   offset = 0;
1024   while((remaining_length = tvb_reported_length_remaining(parameters_tvb, offset))) {
1025     length       = tvb_get_ntohs(parameters_tvb, offset + PARAMETER_LENGTH_OFFSET);
1026     total_length = ADD_PADDING(length);
1027     if (remaining_length >= length)
1028       total_length = MIN(total_length, remaining_length);
1029     /* create a tvb for the parameter including the padding bytes */
1030     parameter_tvb    = tvb_new_subset(parameters_tvb, offset, total_length, total_length);
1031     dissect_parameter(parameter_tvb, pinfo, tree, m2ua_tree);
1032     /* get rid of the handled parameter */
1033     offset += total_length;
1034   }
1035 }
1036
1037
1038 static void
1039 dissect_message(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m2ua_tree)
1040 {
1041   tvbuff_t *common_header_tvb, *parameters_tvb;
1042
1043   common_header_tvb = tvb_new_subset(message_tvb, 0, COMMON_HEADER_LENGTH, COMMON_HEADER_LENGTH);
1044   parameters_tvb    = tvb_new_subset_remaining(message_tvb, COMMON_HEADER_LENGTH);
1045   dissect_common_header(common_header_tvb, pinfo, m2ua_tree);
1046   dissect_parameters(parameters_tvb, pinfo, tree, m2ua_tree);
1047 }
1048
1049 static void
1050 dissect_m2ua(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree)
1051 {
1052   proto_item *m2ua_item;
1053   proto_tree *m2ua_tree;
1054
1055   /* make entry in the Protocol column on summary display */
1056   col_set_str(pinfo->cinfo, COL_PROTOCOL, "M2UA");
1057
1058   /* In the interest of speed, if "tree" is NULL, don't do any work not
1059      necessary to generate protocol tree items. */
1060   if (tree) {
1061     /* create the m2ua protocol tree */
1062     m2ua_item = proto_tree_add_item(tree, proto_m2ua, message_tvb, 0, -1, REP_NA);
1063     m2ua_tree = proto_item_add_subtree(m2ua_item, ett_m2ua);
1064   } else {
1065     m2ua_tree = NULL;
1066   };
1067   /* dissect the message */
1068   dissect_message(message_tvb, pinfo, tree, m2ua_tree);
1069 }
1070
1071 /* Register the protocol with Wireshark */
1072 void
1073 proto_register_m2ua(void)
1074 {
1075
1076   /* Setup list of header fields */
1077   static hf_register_info hf[] = {
1078     { &hf_version,                { "Version",                        "m2ua.version",                    FT_UINT8,  BASE_DEC,  VALS(protocol_version_values),      0x0, NULL, HFILL } },
1079     { &hf_reserved,               { "Reserved",                       "m2ua.reserved",                   FT_UINT8,  BASE_HEX,  NULL,                               0x0, NULL, HFILL } },
1080     { &hf_message_class,          { "Message class",                  "m2ua.message_class",              FT_UINT8,  BASE_DEC,  VALS(message_class_values),         0x0, NULL, HFILL } },
1081     { &hf_message_type,           { "Message Type",                   "m2ua.message_type",               FT_UINT8,  BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1082     { &hf_message_length,         { "Message length",                 "m2ua.message_length",             FT_UINT32, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1083     { &hf_parameter_tag,          { "Parameter Tag",                  "m2ua.parameter_tag",              FT_UINT16, BASE_HEX,  VALS(parameter_tag_values),         0x0, NULL, HFILL } },
1084     { &hf_parameter_length,       { "Parameter length",               "m2ua.parameter_length",           FT_UINT16, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1085     { &hf_parameter_value,        { "Parameter value",                "m2ua.parameter_value",            FT_BYTES,  BASE_NONE, NULL,                               0x0, NULL, HFILL } },
1086     { &hf_parameter_padding,      { "Padding",                        "m2ua.parameter_padding",          FT_BYTES,  BASE_NONE, NULL,                               0x0, NULL, HFILL } },
1087     { &hf_interface_id_int,       { "Interface Identifier (integer)", "m2ua.interface_identifier_int",   FT_UINT32, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1088     { &hf_interface_id_text,      { "Interface identifier (text)",    "m2ua.interface_identifier_text",  FT_STRING, BASE_NONE,  NULL,                               0x0, NULL, HFILL } },
1089     { &hf_info_string,            { "Info string",                    "m2ua.info_string",                FT_STRING, BASE_NONE,  NULL,                               0x0, NULL, HFILL } },
1090     { &hf_diagnostic_information, { "Diagnostic information",         "m2ua.diagnostic_information",     FT_BYTES,  BASE_NONE, NULL,                               0x0, NULL, HFILL } },
1091     { &hf_interface_id_start,     { "Interface Identifier (start)",   "m2ua.interface_identifier_start", FT_UINT32, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1092     { &hf_interface_id_stop,      { "Interface Identifier (stop)",    "m2ua.interface_identifier_stop",  FT_UINT32, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1093     { &hf_heartbeat_data,         { "Heartbeat data",                 "m2ua.heartbeat_data",             FT_BYTES,  BASE_NONE, NULL,                               0x0, NULL, HFILL } },
1094     { &hf_traffic_mode_type,      { "Traffic mode Type",              "m2ua.traffic_mode_type",          FT_UINT32, BASE_DEC,  VALS(traffic_mode_type_values),     0x0, NULL, HFILL } },
1095     { &hf_error_code,             { "Error code",                     "m2ua.error_code",                 FT_UINT32, BASE_DEC,  VALS(error_code_values),            0x0, NULL, HFILL } },
1096     { &hf_status_type,            { "Status type",                    "m2ua.status_type",                FT_UINT16, BASE_DEC,  VALS(status_type_values),           0x0, NULL, HFILL } },
1097     { &hf_status_ident,           { "Status info",                    "m2ua.status_info",                FT_UINT16, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1098     { &hf_asp_id,                 { "ASP identifier",                 "m2ua.asp_identifier",             FT_UINT32, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1099     { &hf_correlation_id,         { "Correlation identifier",         "m2ua.correlation_identifier",     FT_UINT32, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1100     { &hf_data_2_li,              { "Length indicator",               "m2ua.data_2_li",                  FT_UINT8,  BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1101     { &hf_state,                  { "State",                          "m2ua.state",                      FT_UINT32, BASE_DEC,  VALS(state_values),                 0x0, NULL, HFILL } },
1102     { &hf_event,                  { "Event",                          "m2ua.event",                      FT_UINT32, BASE_DEC,  VALS(event_values),                 0x0, NULL, HFILL } },
1103     { &hf_congestion_status,      { "Congestion status",              "m2ua.congestion_status",          FT_UINT32, BASE_DEC,  VALS(level_values),                 0x0, NULL, HFILL } },
1104     { &hf_discard_status,         { "Discard status",                 "m2ua.discard_status",             FT_UINT32, BASE_DEC,  VALS(level_values),                 0x0, NULL, HFILL } },
1105     { &hf_action,                 { "Actions",                        "m2ua.action",                     FT_UINT32, BASE_DEC,  VALS(action_values),                0x0, NULL, HFILL } },
1106     { &hf_sequence_number,        { "Sequence number",                "m2ua.sequence_number",            FT_UINT32, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1107     { &hf_retrieval_result,       { "Retrieval result",               "m2ua.retrieval_result",           FT_UINT32, BASE_DEC,  VALS(retrieval_result_values),      0x0, NULL, HFILL } },
1108     { &hf_local_lk_id,            { "Local LK identifier",            "m2ua.local_lk_identifier",        FT_UINT32, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1109     { &hf_sdt_reserved,           { "Reserved",                       "m2ua.sdt_reserved",               FT_UINT16, BASE_HEX,  NULL,                               0x0, NULL, HFILL } },
1110     { &hf_sdt_id,                 { "SDT identifier",                 "m2ua.sdt_identifier",             FT_UINT16, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1111     { &hf_sdl_reserved,           { "Reserved",                       "m2ua.sdl_reserved",               FT_UINT16, BASE_HEX,  NULL,                               0x0, NULL, HFILL } },
1112     { &hf_sdl_id,                 { "SDL identifier",                 "m2ua.sdl_identifier",             FT_UINT16, BASE_DEC,  NULL,                               0x0, NULL, HFILL } },
1113     { &hf_registration_status,    { "Registration status",            "m2ua.registration_status",        FT_UINT32, BASE_DEC,  VALS(registration_status_values),   0x0, NULL, HFILL } },
1114     { &hf_deregistration_status,  { "Deregistration status",          "m2ua.deregistration_status",      FT_UINT32, BASE_DEC,  VALS(deregistration_status_values), 0x0, NULL, HFILL } },
1115   };
1116
1117   /* Setup protocol subtree array */
1118   static gint *ett[] = {
1119     &ett_m2ua,
1120     &ett_m2ua_parameter,
1121   };
1122
1123   static enum_val_t protocol_data_1_options[] = {
1124     { "draft-7", "0x000e (Draft 7)", PROTOCOL_DATA_1_DRAFT_7 },
1125     { "rfc3331", "0x0300 (RFC3331)", PROTOCOL_DATA_1_PARAMETER_TAG },
1126     { NULL, NULL, 0 }
1127   };
1128
1129   module_t *m2ua_module;
1130
1131   /* Register the protocol name and description */
1132   proto_m2ua = proto_register_protocol("MTP 2 User Adaptation Layer", "M2UA",  "m2ua");
1133
1134   /* Required function calls to register the header fields and subtrees used */
1135   proto_register_field_array(proto_m2ua, hf, array_length(hf));
1136   proto_register_subtree_array(ett, array_length(ett));
1137
1138   m2ua_module = prefs_register_protocol(proto_m2ua, NULL);
1139
1140   prefs_register_enum_preference(m2ua_module,
1141     "protocol_data_1_tag",
1142     "Protocol Data 1 Parameter Tag",
1143     "The value of the parameter tag for protocol data 1",
1144     &protocol_data_1_global,
1145     protocol_data_1_options,
1146     FALSE);
1147 }
1148
1149 void
1150 proto_reg_handoff_m2ua(void)
1151 {
1152   dissector_handle_t m2ua_handle;
1153
1154   mtp3_handle = find_dissector("mtp3");
1155   m2ua_handle = create_dissector_handle(dissect_m2ua, proto_m2ua);
1156   dissector_add("sctp.ppi",  M2UA_PAYLOAD_PROTOCOL_ID, m2ua_handle);
1157   dissector_add("sctp.port", SCTP_PORT_M2UA, m2ua_handle);
1158 }