packet-iua.c

   1 /* packet-iua.c
   2  * Routines for ISDN Q.921-User Adaptation Layer dissection
   3  *
   4  * It is hopefully (needs testing) compilant to
   5  *   http://www.ietf.org/rfc/rfc3057.txt
   6  *   http://www.ietf.org/internet-drafts/draft-ietf-sigtran-iua-imp-guide-00.txt
   7  * To do: - provide better handling of length parameters
   8  *
   9  * Copyright 2002, Michael Tuexen <Michael.Tuexen@icn.siemens.de>
  10  *
  11  * $Id: packet-iua.c,v 1.15 2002/07/12 19:37:33 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 <epan/packet.h>
  39 #include "prefs.h"
  40
  41 #define NETWORK_BYTE_ORDER          FALSE
  42
  43 static module_t *iua_module;
  44
  45 /* Initialize the protocol and registered fields */
  46 static int proto_iua                = -1;
  47 static int hf_int_interface_id      = -1;
  48 static int hf_text_interface_id     = -1;
  49 static int hf_info_string           = -1;
  50 static int hf_dlci_zero_bit         = -1;
  51 static int hf_dlci_spare_bit        = -1;
  52 static int hf_dlci_sapi             = -1;
  53 static int hf_dlci_one_bit          = -1;
  54 static int hf_dlci_tei              = -1;
  55 static int hf_dlci_spare            = -1;
  56 static int hf_diag_info             = -1;
  57 static int hf_interface_range_start = -1;
  58 static int hf_interface_range_end   = -1;
  59 static int hf_heartbeat_data        = -1;
  60 static int hf_asp_reason            = -1;
  61 static int hf_traffic_mode_type     = -1;
  62 static int hf_error_code            = -1;
  63 static int hf_error_code_ig         = -1;
  64 static int hf_status_type           = -1;
  65 static int hf_status_id             = -1;
  66 static int hf_release_reason        = -1;
  67 static int hf_tei_status            = -1;
  68 static int hf_asp_id                = -1;
  69 static int hf_parameter_tag         = -1;
  70 static int hf_parameter_tag_ig      = -1;
  71 static int hf_parameter_length      = -1;
  72 static int hf_parameter_value       = -1;
  73 static int hf_parameter_padding     = -1;
  74 static int hf_version               = -1;
  75 static int hf_reserved              = -1;
  76 static int hf_message_class         = -1;
  77 static int hf_message_type          = -1;
  78 static int hf_message_length        = -1;
  79
  80 /* Initialize the subtree pointers */
  81 static gint ett_iua                 = -1;
  82 static gint ett_iua_parameter       = -1;
  83
  84 /* option setable via preferences, default is plain RFC 3057 */
  85 static gboolean support_IG          = FALSE;
  86
  87 static dissector_handle_t q931_handle;
  88
  89 static guint
  90 nr_of_padding_bytes (guint length)
  91 {
  92   guint remainder;
  93
  94   remainder = length % 4;
  95
  96   if (remainder == 0)
  97     return 0;
  98   else
  99     return 4 - remainder;
 100 }
 101
 102 #define PARAMETER_TAG_LENGTH    2
 103 #define PARAMETER_LENGTH_LENGTH 2
 104 #define PARAMETER_HEADER_LENGTH (PARAMETER_TAG_LENGTH + PARAMETER_LENGTH_LENGTH)
 105
 106 #define PARAMETER_TAG_OFFSET    0
 107 #define PARAMETER_LENGTH_OFFSET (PARAMETER_TAG_OFFSET + PARAMETER_TAG_LENGTH)
 108 #define PARAMETER_VALUE_OFFSET  (PARAMETER_LENGTH_OFFSET + PARAMETER_LENGTH_LENGTH)
 109 #define PARAMETER_HEADER_OFFSET PARAMETER_TAG_OFFSET
 110
 111 #define INT_INTERFACE_ID_OFFSET PARAMETER_VALUE_OFFSET
 112 #define INT_INTERFACE_ID_LENGTH 4
 113
 114 static void
 115 dissect_int_interface_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 116 {
 117   proto_tree_add_item(parameter_tree, hf_int_interface_id, parameter_tvb, INT_INTERFACE_ID_OFFSET, INT_INTERFACE_ID_LENGTH, NETWORK_BYTE_ORDER);
 118   proto_item_append_text(parameter_item, " (%d)", tvb_get_ntohl(parameter_tvb, INT_INTERFACE_ID_OFFSET));
 119 }
 120
 121 #define TEXT_INTERFACE_ID_OFFSET PARAMETER_VALUE_OFFSET
 122
 123 static void
 124 dissect_text_interface_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 125 {
 126   guint16 interface_id_length;
 127
 128   interface_id_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 129
 130   proto_tree_add_item(parameter_tree, hf_text_interface_id, parameter_tvb, TEXT_INTERFACE_ID_OFFSET, interface_id_length, NETWORK_BYTE_ORDER);
 131   proto_item_append_text(parameter_item, " (%.*s)", interface_id_length,
 132                          (char *)tvb_get_ptr(parameter_tvb, TEXT_INTERFACE_ID_OFFSET, interface_id_length));
 133 }
 134
 135 #define INFO_STRING_OFFSET PARAMETER_VALUE_OFFSET
 136
 137 static void
 138 dissect_info_string_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 139 {
 140   guint16 info_string_length;
 141
 142   info_string_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 143   proto_tree_add_item(parameter_tree, hf_info_string, parameter_tvb, INFO_STRING_OFFSET, info_string_length, NETWORK_BYTE_ORDER);
 144   proto_item_append_text(parameter_item, " (%.*s)", info_string_length,
 145                          (char *)tvb_get_ptr(parameter_tvb, INFO_STRING_OFFSET, info_string_length));
 146 }
 147
 148 #define DLCI_SAPI_LENGTH  1
 149 #define DLCI_TEI_LENGTH   1
 150 #define DLCI_SPARE_LENGTH 2
 151
 152 #define DLCI_SAPI_OFFSET  PARAMETER_VALUE_OFFSET
 153 #define DLCI_TEI_OFFSET   (DLCI_SAPI_OFFSET + DLCI_SAPI_LENGTH)
 154 #define DLCI_SPARE_OFFSET (DLCI_TEI_OFFSET + DLCI_TEI_LENGTH)
 155
 156 #define ZERO_BIT_MASK     0x01
 157 #define SPARE_BIT_MASK    0x02
 158 #define SAPI_MASK         0xfc
 159 #define ONE_BIT_MASK      0x01
 160 #define TEI_MASK          0xfe
 161
 162 static void
 163 dissect_dlci_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree)
 164 {
 165   proto_tree_add_item(parameter_tree, hf_dlci_zero_bit,  parameter_tvb, DLCI_SAPI_OFFSET,  DLCI_SAPI_LENGTH,  NETWORK_BYTE_ORDER);
 166   proto_tree_add_item(parameter_tree, hf_dlci_spare_bit, parameter_tvb, DLCI_SAPI_OFFSET,  DLCI_SAPI_LENGTH,  NETWORK_BYTE_ORDER);
 167   proto_tree_add_item(parameter_tree, hf_dlci_sapi,      parameter_tvb, DLCI_SAPI_OFFSET,  DLCI_SAPI_LENGTH,  NETWORK_BYTE_ORDER);
 168   proto_tree_add_item(parameter_tree, hf_dlci_one_bit,   parameter_tvb, DLCI_TEI_OFFSET,   DLCI_TEI_LENGTH,   NETWORK_BYTE_ORDER);
 169   proto_tree_add_item(parameter_tree, hf_dlci_tei,       parameter_tvb, DLCI_TEI_OFFSET,   DLCI_TEI_LENGTH,   NETWORK_BYTE_ORDER);
 170   proto_tree_add_item(parameter_tree, hf_dlci_spare,     parameter_tvb, DLCI_SPARE_OFFSET, DLCI_SPARE_LENGTH, NETWORK_BYTE_ORDER);
 171 }
 172
 173 static void
 174 dissect_diagnostic_information_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 175 {
 176   guint16 diag_info_length;
 177
 178   diag_info_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 179   proto_tree_add_item(parameter_tree, hf_diag_info, parameter_tvb, PARAMETER_VALUE_OFFSET, diag_info_length, NETWORK_BYTE_ORDER);
 180   proto_item_append_text(parameter_item, " (%u byte%s)", diag_info_length, plurality(diag_info_length, "", "s"));
 181 }
 182
 183 #define START_LENGTH 4
 184 #define END_LENGTH   4
 185 #define INTERVAL_LENGTH (START_LENGTH + END_LENGTH)
 186
 187 #define START_OFFSET 0
 188 #define END_OFFSET   (START_OFFSET + START_LENGTH)
 189
 190 static void
 191 dissect_integer_range_interface_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 192 {
 193   guint16 number_of_ranges, range_number;
 194   gint offset;
 195
 196   number_of_ranges = (tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH) / INTERVAL_LENGTH;
 197   offset = PARAMETER_VALUE_OFFSET;
 198   for(range_number = 1; range_number <= number_of_ranges; range_number++) {
 199     proto_tree_add_item(parameter_tree, hf_interface_range_start, parameter_tvb, offset + START_OFFSET, START_LENGTH, NETWORK_BYTE_ORDER);
 200     proto_tree_add_item(parameter_tree, hf_interface_range_end,   parameter_tvb, offset + END_OFFSET,   END_LENGTH,   NETWORK_BYTE_ORDER);
 201     offset += INTERVAL_LENGTH;
 202   };
 203
 204   proto_item_append_text(parameter_item, " (%u range%s)", number_of_ranges, plurality(number_of_ranges, "", "s"));
 205 }
 206
 207 #define HEARTBEAT_DATA_OFFSET PARAMETER_VALUE_OFFSET
 208
 209 static void
 210 dissect_heartbeat_data_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 211 {
 212   guint16 heartbeat_data_length;
 213
 214   heartbeat_data_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 215   proto_tree_add_item(parameter_tree, hf_heartbeat_data, parameter_tvb, HEARTBEAT_DATA_OFFSET, heartbeat_data_length, NETWORK_BYTE_ORDER);
 216   proto_item_append_text(parameter_item, " (%u byte%s)", heartbeat_data_length, plurality(heartbeat_data_length, "", "s"));
 217 }
 218
 219 #define ASP_MGMT_REASON   1
 220
 221 static const value_string asp_reason_values[] = {
 222   { ASP_MGMT_REASON,      "Management inhibit" },
 223   { 0,                    NULL } };
 224
 225 #define ASP_REASON_LENGTH 4
 226 #define ASP_REASON_OFFSET PARAMETER_VALUE_OFFSET
 227
 228 static void
 229 dissect_asp_reason_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 230 {
 231   proto_tree_add_item(parameter_tree, hf_asp_reason, parameter_tvb, ASP_REASON_OFFSET, ASP_REASON_LENGTH, NETWORK_BYTE_ORDER);
 232   proto_item_append_text(parameter_item, " (%s)", val_to_str(tvb_get_ntohl(parameter_tvb, ASP_REASON_OFFSET), asp_reason_values, "unknown"));
 233 }
 234
 235 #define OVER_RIDE_TRAFFIC_MODE_TYPE  1
 236 #define LOAD_SHARE_TRAFFIC_MODE_TYPE 2
 237
 238 static const value_string traffic_mode_type_values[] = {
 239   { OVER_RIDE_TRAFFIC_MODE_TYPE,      "Over-ride" },
 240   { LOAD_SHARE_TRAFFIC_MODE_TYPE,     "Load-share" },
 241   { 0,                    NULL } };
 242
 243 #define TRAFFIC_MODE_TYPE_LENGTH 4
 244 #define TRAFFIC_MODE_TYPE_OFFSET PARAMETER_VALUE_OFFSET
 245
 246 static void
 247 dissect_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 248 {
 249   proto_tree_add_item(parameter_tree, hf_traffic_mode_type, parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH, NETWORK_BYTE_ORDER);
 250   proto_item_append_text(parameter_item, " (%s)",
 251                          val_to_str(tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET), traffic_mode_type_values, "unknown"));
 252 }
 253
 254 #define INVALID_VERSION_ERROR                         0x01
 255 #define INVALID_INTERFACE_IDENTIFIER_ERROR            0x02
 256 #define UNSUPPORTED_MESSAGE_CLASS_ERROR               0x03
 257 #define UNSUPPORTED_MESSAGE_TYPE_ERROR                0x04
 258 #define UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR       0x05
 259 #define UNEXPECTED_MESSAGE_ERROR                      0x06
 260 #define PROTOCOL_ERROR                                0x07
 261 #define UNSUPPORTED_INTERFACE_IDENTIFIER_TYPE_ERROR   0x08
 262 #define INVALID_STREAM_IDENTIFIER_ERROR               0x09
 263 #define UNASSIGNED_TEI_ERROR                          0x0a
 264 #define UNRECOGNIZED_SAPI_ERROR                       0x0b
 265 #define INVALID_TEI_SAPI_COMBINATION_ERROR            0x0c
 266 #define REFUSED_MANAGEMENT_BLOCKING_ERROR             0x0d
 267 #define ASP_IDENTIFIER_REQUIRED_ERROR                 0x0e
 268 #define INVALID_ASP_IDENTIFIER_ERROR                  0x0f
 269
 270 static const value_string error_code_values[] = {
 271   { INVALID_VERSION_ERROR,                       "Invalid version" },
 272   { INVALID_INTERFACE_IDENTIFIER_ERROR,          "Invalid interface identifier" },
 273   { UNSUPPORTED_MESSAGE_CLASS_ERROR,             "Unsuported message class" },
 274   { UNSUPPORTED_MESSAGE_TYPE_ERROR,              "Unsupported message type" },
 275   { UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR,     "Unsupported traffic handling mode" },
 276   { UNEXPECTED_MESSAGE_ERROR,                    "Unexpected message" },
 277   { PROTOCOL_ERROR,                              "Protocol error" },
 278   { UNSUPPORTED_INTERFACE_IDENTIFIER_TYPE_ERROR, "Unsupported interface identifier type" },
 279   { INVALID_STREAM_IDENTIFIER_ERROR,             "Invalid stream identifier" },
 280   { UNASSIGNED_TEI_ERROR,                        "Unassigned TEI" },
 281   { UNRECOGNIZED_SAPI_ERROR,                     "Unrecognized SAPI" },
 282   { INVALID_TEI_SAPI_COMBINATION_ERROR,          "Invalid TEI/SAPI combination" },
 283   { 0,                                           NULL } };
 284
 285 static const value_string error_code_ig_values[] = {
 286   { INVALID_VERSION_ERROR,                       "Invalid version" },
 287   { INVALID_INTERFACE_IDENTIFIER_ERROR,          "Invalid interface identifier" },
 288   { UNSUPPORTED_MESSAGE_CLASS_ERROR,             "Unsuported message class" },
 289   { UNSUPPORTED_MESSAGE_TYPE_ERROR,              "Unsupported message type" },
 290   { UNSUPPORTED_TRAFFIC_HANDLING_MODE_ERROR,     "Unsupported traffic handling mode" },
 291   { UNEXPECTED_MESSAGE_ERROR,                    "Unexpected message" },
 292   { PROTOCOL_ERROR,                              "Protocol error" },
 293   { UNSUPPORTED_INTERFACE_IDENTIFIER_TYPE_ERROR, "Unsupported interface identifier type" },
 294   { INVALID_STREAM_IDENTIFIER_ERROR,             "Invalid stream identifier" },
 295   { UNASSIGNED_TEI_ERROR,                        "Unassigned TEI" },
 296   { UNRECOGNIZED_SAPI_ERROR,                     "Unrecognized SAPI" },
 297   { INVALID_TEI_SAPI_COMBINATION_ERROR,          "Invalid TEI/SAPI combination" },
 298   { REFUSED_MANAGEMENT_BLOCKING_ERROR,           "Refused - Management blocking" },
 299   { ASP_IDENTIFIER_REQUIRED_ERROR,               "ASP identifier required" },
 300   { INVALID_ASP_IDENTIFIER_ERROR,                "Invalid ASP identifier" },
 301   { 0,                                           NULL } };
 302
 303 #define ERROR_CODE_LENGTH 4
 304 #define ERROR_CODE_OFFSET PARAMETER_VALUE_OFFSET
 305
 306 static void
 307 dissect_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 308 {
 309   proto_tree_add_item(parameter_tree, support_IG?hf_error_code_ig:hf_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, NETWORK_BYTE_ORDER);
 310   proto_item_append_text(parameter_item, " (%s)",
 311                          val_to_str(tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET), support_IG?error_code_ig_values:error_code_values, "unknown"));
 312 }
 313
 314 #define ASP_STATE_CHANGE_STATUS_TYPE  0x01
 315 #define OTHER_STATUS_TYPE             0x02
 316
 317 static const value_string status_type_values[] = {
 318   { ASP_STATE_CHANGE_STATUS_TYPE,        "Application server state change" },
 319   { OTHER_STATUS_TYPE,                   "Other" },
 320   { 0,                                   NULL } };
 321
 322 #define AS_DOWN_STATUS_IDENT          0x01
 323 #define AS_INACTIVE_STATUS_IDENT      0x02
 324 #define AS_ACTIVE_STATUS_IDENT        0x03
 325 #define AS_PENDING_STATUS_IDENT       0x04
 326
 327 #define INSUFFICIENT_ASP_RESOURCES_STATUS_IDENT 0x01
 328 #define ALTERNATE_ASP_ACTIVE_STATUS_IDENT       0x02
 329
 330 static const value_string status_type_id_values[] = {
 331   { ASP_STATE_CHANGE_STATUS_TYPE * 256 * 256 + AS_DOWN_STATUS_IDENT,         "Application server down" },
 332   { ASP_STATE_CHANGE_STATUS_TYPE * 256 * 256 + AS_INACTIVE_STATUS_IDENT,     "Application server inactive" },
 333   { ASP_STATE_CHANGE_STATUS_TYPE * 256 * 256 + AS_ACTIVE_STATUS_IDENT,       "Application server active" },
 334   { ASP_STATE_CHANGE_STATUS_TYPE * 256 * 256 + AS_PENDING_STATUS_IDENT,      "Application server pending" },
 335   { OTHER_STATUS_TYPE * 256 * 256 + INSUFFICIENT_ASP_RESOURCES_STATUS_IDENT, "Insufficient ASP resources active in AS" },
 336   { OTHER_STATUS_TYPE * 256 * 256 + ALTERNATE_ASP_ACTIVE_STATUS_IDENT,       "Alternate ASP active" },
 337   { 0,                                           NULL } };
 338
 339 static const value_string status_type_id_ig_values[] = {
 340   { ASP_STATE_CHANGE_STATUS_TYPE * 256 * 256 + AS_INACTIVE_STATUS_IDENT,     "Application server inactive" },
 341   { ASP_STATE_CHANGE_STATUS_TYPE * 256 * 256 + AS_ACTIVE_STATUS_IDENT,       "Application server active" },
 342   { ASP_STATE_CHANGE_STATUS_TYPE * 256 * 256 + AS_PENDING_STATUS_IDENT,      "Application server pending" },
 343   { OTHER_STATUS_TYPE * 256 * 256 + INSUFFICIENT_ASP_RESOURCES_STATUS_IDENT, "Insufficient ASP resources active in AS" },
 344   { OTHER_STATUS_TYPE * 256 * 256 + ALTERNATE_ASP_ACTIVE_STATUS_IDENT,       "Alternate ASP active" },
 345   { 0,                                           NULL } };
 346
 347 #define STATUS_TYPE_LENGTH  2
 348 #define STATUS_IDENT_LENGTH 2
 349 #define STATUS_TYPE_OFFSET  PARAMETER_VALUE_OFFSET
 350 #define STATUS_IDENT_OFFSET (STATUS_TYPE_OFFSET + STATUS_TYPE_LENGTH)
 351
 352 static void
 353 dissect_status_type_identification_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 354 {
 355   guint16 status_type, status_id;
 356
 357   status_type = tvb_get_ntohs(parameter_tvb, STATUS_TYPE_OFFSET);
 358   status_id   = tvb_get_ntohs(parameter_tvb, STATUS_IDENT_OFFSET);
 359
 360   proto_tree_add_item(parameter_tree, hf_status_type, parameter_tvb, STATUS_TYPE_OFFSET, STATUS_TYPE_LENGTH, NETWORK_BYTE_ORDER);
 361   proto_tree_add_uint_format(parameter_tree, hf_status_id,  parameter_tvb, STATUS_IDENT_OFFSET, STATUS_IDENT_LENGTH,
 362                              status_id, "Status identification: %u (%s)", status_id,
 363                              val_to_str(status_type * 256 * 256 + status_id, support_IG?status_type_id_ig_values:status_type_id_values, "unknown"));
 364
 365   proto_item_append_text(parameter_item, " (%s)",
 366                          val_to_str(status_type * 256 * 256 + status_id, support_IG?status_type_id_ig_values:status_type_id_values, "unknown status information"));
 367 }
 368
 369 #define PROTOCOL_DATA_OFFSET PARAMETER_VALUE_OFFSET
 370
 371 static void
 372 dissect_protocol_data_parameter(tvbuff_t *parameter_tvb, proto_item *parameter_item, packet_info *pinfo, proto_tree *tree)
 373 {
 374   guint16 protocol_data_length;
 375   tvbuff_t *protocol_data_tvb;
 376
 377   protocol_data_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 378   protocol_data_tvb    = tvb_new_subset(parameter_tvb, PROTOCOL_DATA_OFFSET, protocol_data_length, protocol_data_length);
 379   call_dissector(q931_handle, protocol_data_tvb, pinfo, tree);
 380
 381   proto_item_append_text(parameter_item, " (%u byte%s)", protocol_data_length, plurality(protocol_data_length, "", "s"));
 382 }
 383
 384 #define RELEASE_MGMT_REASON   0
 385 #define RELEASE_PHYS_REASON   1
 386 #define RELEASE_DM_REASON     2
 387 #define RELEASE_OTHER_REASON  4
 388
 389 static const value_string release_reason_values[] = {
 390   { RELEASE_MGMT_REASON,  "Management layer generated release" },
 391   { RELEASE_PHYS_REASON,  "Physical layer alarm generated release" },
 392   { RELEASE_DM_REASON,    "Layer 2 should release" },
 393   { RELEASE_OTHER_REASON, "Other reason" },
 394   { 0,                    NULL } };
 395
 396 #define RELEASE_REASON_OFFSET PARAMETER_VALUE_OFFSET
 397 #define RELEASE_REASON_LENGTH 4
 398
 399 static void
 400 dissect_release_reason_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 401 {
 402   proto_tree_add_item(parameter_tree, hf_release_reason, parameter_tvb, RELEASE_REASON_OFFSET, RELEASE_REASON_LENGTH, NETWORK_BYTE_ORDER);
 403   proto_item_append_text(parameter_item, " (%s)",
 404                          val_to_str(tvb_get_ntohl(parameter_tvb, RELEASE_REASON_OFFSET), release_reason_values, "unknown"));
 405 }
 406
 407 #define TEI_STATUS_ASSIGNED       0
 408 #define TEI_STATUS_UNASSIGNED     1
 409
 410 static const value_string tei_status_values[] = {
 411   { TEI_STATUS_ASSIGNED,   "TEI is considered assigned by Q.921" },
 412   { TEI_STATUS_UNASSIGNED, "TEI is considered unassigned by Q.921" },
 413   { 0,                    NULL } };
 414
 415 #define TEI_STATUS_LENGTH 4
 416 #define TEI_STATUS_OFFSET PARAMETER_VALUE_OFFSET
 417
 418 static void
 419 dissect_tei_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 420 {
 421   proto_tree_add_item(parameter_tree, hf_tei_status, parameter_tvb, TEI_STATUS_OFFSET, TEI_STATUS_LENGTH, NETWORK_BYTE_ORDER);
 422   proto_item_append_text(parameter_item, " (%s)",
 423                       val_to_str(tvb_get_ntohl(parameter_tvb, TEI_STATUS_OFFSET), tei_status_values, "unknown"));
 424 }
 425
 426 #define ASP_ID_LENGTH 4
 427 #define ASP_ID_OFFSET PARAMETER_VALUE_OFFSET
 428
 429 static void
 430 dissect_asp_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 431 {
 432   proto_tree_add_item(parameter_tree, hf_asp_id, parameter_tvb, ASP_ID_OFFSET, ASP_ID_LENGTH, NETWORK_BYTE_ORDER);
 433   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohl(parameter_tvb, ASP_ID_OFFSET));
 434 }
 435
 436 static void
 437 dissect_unknown_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
 438 {
 439   guint16 parameter_value_length;
 440
 441   parameter_value_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
 442   if (parameter_value_length > 0)
 443     proto_tree_add_item(parameter_tree, hf_parameter_value, parameter_tvb, PARAMETER_VALUE_OFFSET, parameter_value_length, NETWORK_BYTE_ORDER);
 444   proto_item_append_text(parameter_item, " with tag %u and %u byte%s value",
 445                          tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET), parameter_value_length, plurality(parameter_value_length, "", "s"));
 446 }
 447
 448 #define INT_INTERFACE_IDENTIFIER_PARAMETER_TAG           0x01
 449 #define TEXT_INTERFACE_IDENTIFIER_PARAMETER_TAG          0x03
 450 #define INFO_PARAMETER_TAG                               0x04
 451 #define DLCI_PARAMETER_TAG                               0x05
 452 #define DIAGNOSTIC_INFORMATION_PARAMETER_TAG             0x07
 453 #define INTEGER_RANGE_INTERFACE_IDENTIFIER_PARAMETER_TAG 0x08
 454 #define HEARTBEAT_DATA_PARAMETER_TAG                     0x09
 455 #define ASP_REASON_PARAMETER_TAG                         0x0a
 456 #define TRAFFIC_MODE_TYPE_PARAMETER_TAG                  0x0b
 457 #define ERROR_CODE_PARAMETER_TAG                         0x0c
 458 #define STATUS_TYPE_INDENTIFICATION_PARAMETER_TAG        0x0d
 459 #define PROTOCOL_DATA_PARAMETER_TAG                      0x0e
 460 #define RELEASE_REASON_PARAMETER_TAG                     0x0f
 461 #define TEI_STATUS_PARAMETER_TAG                         0x10
 462 #define ASP_IDENTIFIER_PARAMETER_TAG                     0x11
 463
 464 static const value_string parameter_tag_values[] = {
 465   { INT_INTERFACE_IDENTIFIER_PARAMETER_TAG,                "Integer interface identifier" },
 466   { TEXT_INTERFACE_IDENTIFIER_PARAMETER_TAG,               "Text interface identifier" },
 467   { INFO_PARAMETER_TAG,                                    "Info" },
 468   { DLCI_PARAMETER_TAG,                                    "DLCI" },
 469   { DIAGNOSTIC_INFORMATION_PARAMETER_TAG,                  "Diagnostic information" },
 470   { INTEGER_RANGE_INTERFACE_IDENTIFIER_PARAMETER_TAG,      "Integer range interface identifier" },
 471   { HEARTBEAT_DATA_PARAMETER_TAG,                          "Hearbeat data" },
 472   { ASP_REASON_PARAMETER_TAG,                              "Reason" },
 473   { TRAFFIC_MODE_TYPE_PARAMETER_TAG,                       "Traffic mode type" },
 474   { ERROR_CODE_PARAMETER_TAG,                              "Error code" },
 475   { STATUS_TYPE_INDENTIFICATION_PARAMETER_TAG,             "Status type/identification" },
 476   { PROTOCOL_DATA_PARAMETER_TAG,                           "Protocol data" },
 477   { RELEASE_REASON_PARAMETER_TAG,                          "Reason" },
 478   { TEI_STATUS_PARAMETER_TAG,                              "TEI status" },
 479   { 0,                           NULL } };
 480
 481 static const value_string parameter_tag_ig_values[] = {
 482   { INT_INTERFACE_IDENTIFIER_PARAMETER_TAG,                "Integer interface identifier" },
 483   { TEXT_INTERFACE_IDENTIFIER_PARAMETER_TAG,               "Text interface identifier" },
 484   { INFO_PARAMETER_TAG,                                    "Info" },
 485   { DLCI_PARAMETER_TAG,                                    "DLCI" },
 486   { DIAGNOSTIC_INFORMATION_PARAMETER_TAG,                  "Diagnostic information" },
 487   { INTEGER_RANGE_INTERFACE_IDENTIFIER_PARAMETER_TAG,      "Integer range interface identifier" },
 488   { HEARTBEAT_DATA_PARAMETER_TAG,                          "Hearbeat data" },
 489   { TRAFFIC_MODE_TYPE_PARAMETER_TAG,                       "Traffic mode type" },
 490   { ERROR_CODE_PARAMETER_TAG,                              "Error code" },
 491   { STATUS_TYPE_INDENTIFICATION_PARAMETER_TAG,             "Status type/identification" },
 492   { PROTOCOL_DATA_PARAMETER_TAG,                           "Protocol data" },
 493   { RELEASE_REASON_PARAMETER_TAG,                          "Reason" },
 494   { TEI_STATUS_PARAMETER_TAG,                              "TEI status" },
 495   { ASP_IDENTIFIER_PARAMETER_TAG,                          "ASP identifier"},
 496   { 0,                           NULL } };
 497
 498 static void
 499 dissect_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *iua_tree)
 500 {
 501   guint16 tag, length, padding_length;
 502   proto_item *parameter_item;
 503   proto_tree *parameter_tree;
 504
 505   /* extract tag and length from the parameter */
 506   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
 507   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
 508   padding_length = tvb_length(parameter_tvb) - length;
 509
 510   /* create proto_tree stuff */
 511   parameter_item   = proto_tree_add_text(iua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, tvb_length(parameter_tvb),
 512                                          val_to_str(tag, support_IG?parameter_tag_ig_values:parameter_tag_values, "Unknown parameter"));
 513   parameter_tree   = proto_item_add_subtree(parameter_item, ett_iua_parameter);
 514
 515   /* add tag and length to the iua tree */
 516   proto_tree_add_item(parameter_tree, support_IG?hf_parameter_tag_ig:hf_parameter_tag, parameter_tvb, PARAMETER_TAG_OFFSET, PARAMETER_TAG_LENGTH, NETWORK_BYTE_ORDER);
 517   proto_tree_add_item(parameter_tree, hf_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, NETWORK_BYTE_ORDER);
 518
 519   switch(tag) {
 520   case INT_INTERFACE_IDENTIFIER_PARAMETER_TAG:
 521     dissect_int_interface_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 522     break;
 523   case TEXT_INTERFACE_IDENTIFIER_PARAMETER_TAG:
 524     dissect_text_interface_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 525     break;
 526   case INFO_PARAMETER_TAG:
 527     dissect_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
 528     break;
 529   case DLCI_PARAMETER_TAG:
 530     dissect_dlci_parameter(parameter_tvb, parameter_tree);
 531     break;
 532   case DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
 533     dissect_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
 534     break;
 535   case INTEGER_RANGE_INTERFACE_IDENTIFIER_PARAMETER_TAG:
 536     dissect_integer_range_interface_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 537     break;
 538   case HEARTBEAT_DATA_PARAMETER_TAG:
 539     dissect_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
 540     break;
 541   case ASP_REASON_PARAMETER_TAG:
 542     if (support_IG)
 543       dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
 544     else
 545       dissect_asp_reason_parameter(parameter_tvb, parameter_tree, parameter_item);
 546     break;
 547   case TRAFFIC_MODE_TYPE_PARAMETER_TAG:
 548     dissect_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
 549     break;
 550   case ERROR_CODE_PARAMETER_TAG:
 551     dissect_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
 552     break;
 553   case STATUS_TYPE_INDENTIFICATION_PARAMETER_TAG:
 554     dissect_status_type_identification_parameter(parameter_tvb, parameter_tree, parameter_item);
 555     break;
 556   case PROTOCOL_DATA_PARAMETER_TAG:
 557     dissect_protocol_data_parameter(parameter_tvb, parameter_item, pinfo, tree);
 558     break;
 559   case RELEASE_REASON_PARAMETER_TAG:
 560     dissect_release_reason_parameter(parameter_tvb, parameter_tree, parameter_item);
 561     break;
 562   case TEI_STATUS_PARAMETER_TAG:
 563     dissect_tei_status_parameter(parameter_tvb, parameter_tree, parameter_item);
 564     break;
 565   case ASP_IDENTIFIER_PARAMETER_TAG:
 566     if (support_IG)
 567       dissect_asp_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
 568     else
 569       dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
 570     break;
 571   default:
 572     dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
 573     break;
 574   };
 575
 576   if (padding_length > 0)
 577     proto_tree_add_item(parameter_tree, hf_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length, NETWORK_BYTE_ORDER);
 578 }
 579
 580 static void
 581 dissect_parameters(tvbuff_t *parameters_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *iua_tree)
 582 {
 583   gint offset, length, padding_length, total_length, remaining_length;
 584   tvbuff_t *parameter_tvb;
 585
 586   offset = 0;
 587   while((remaining_length = tvb_length_remaining(parameters_tvb, offset))) {
 588     length         = tvb_get_ntohs(parameters_tvb, offset + PARAMETER_LENGTH_OFFSET);
 589     padding_length = nr_of_padding_bytes(length);
 590     if (remaining_length >= length)
 591       total_length = MIN(length + padding_length, remaining_length);
 592     else
 593       total_length = length + padding_length;
 594     /* create a tvb for the parameter including the padding bytes */
 595     parameter_tvb  = tvb_new_subset(parameters_tvb, offset, total_length, total_length);
 596     dissect_parameter(parameter_tvb, pinfo, tree, iua_tree);
 597     /* get rid of the handled parameter */
 598     offset += total_length;
 599   }
 600 }
 601
 602 #define VERSION_LENGTH         1
 603 #define RESERVED_LENGTH        1
 604 #define MESSAGE_CLASS_LENGTH   1
 605 #define MESSAGE_TYPE_LENGTH    1
 606 #define MESSAGE_LENGTH_LENGTH  4
 607 #define COMMON_HEADER_LENGTH   (VERSION_LENGTH + RESERVED_LENGTH + MESSAGE_CLASS_LENGTH + \
 608                                 MESSAGE_TYPE_LENGTH + MESSAGE_LENGTH_LENGTH)
 609
 610 #define COMMON_HEADER_OFFSET   0
 611 #define VERSION_OFFSET         COMMON_HEADER_OFFSET
 612 #define RESERVED_OFFSET        (VERSION_OFFSET + VERSION_LENGTH)
 613 #define MESSAGE_CLASS_OFFSET   (RESERVED_OFFSET + RESERVED_LENGTH)
 614 #define MESSAGE_TYPE_OFFSET    (MESSAGE_CLASS_OFFSET + MESSAGE_CLASS_LENGTH)
 615 #define MESSAGE_LENGTH_OFFSET  (MESSAGE_TYPE_OFFSET + MESSAGE_TYPE_LENGTH)
 616 #define PARAMETERS_OFFSET      (COMMON_HEADER_OFFSET + COMMON_HEADER_LENGTH)
 617
 618 #define PROTOCOL_VERSION_RELEASE_1             1
 619
 620 static const value_string protocol_version_values[] = {
 621   { PROTOCOL_VERSION_RELEASE_1,  "Release 1" },
 622   { 0,                           NULL } };
 623
 624 #define MESSAGE_CLASS_MGMT_MESSAGE        0
 625 #define MESSAGE_CLASS_TFER_MESSAGE        1
 626 #define MESSAGE_CLASS_SSNM_MESSAGE        2
 627 #define MESSAGE_CLASS_ASPSM_MESSAGE       3
 628 #define MESSAGE_CLASS_ASPTM_MESSAGE       4
 629 #define MESSAGE_CLASS_QPTM_MESSAGE        5
 630 #define MESSAGE_CLASS_MAUP_MESSAGE        6
 631 #define MESSAGE_CLASS_CL_SUA_MESSAGE      7
 632 #define MESSAGE_CLASS_CO_SUA_MESSAGE      8
 633
 634 static const value_string message_class_values[] = {
 635   { MESSAGE_CLASS_MGMT_MESSAGE,   "Management messages" },
 636   { MESSAGE_CLASS_TFER_MESSAGE,   "Transfer messages" },
 637   { MESSAGE_CLASS_SSNM_MESSAGE,   "SS7 signalling network management messages" },
 638   { MESSAGE_CLASS_ASPSM_MESSAGE,  "ASP state maintenance messages" },
 639   { MESSAGE_CLASS_ASPTM_MESSAGE,  "ASP traffic maintenance messages" },
 640   { MESSAGE_CLASS_QPTM_MESSAGE,   "Q.921/Q.931 boundary primitive transport messages" },
 641   { MESSAGE_CLASS_MAUP_MESSAGE,   "MTP2 user adaptation messages" },
 642   { MESSAGE_CLASS_CL_SUA_MESSAGE, "Connectionless messages (SUA)" },
 643   { MESSAGE_CLASS_CO_SUA_MESSAGE, "Connection-oriented messages (SUA)" },
 644   { 0,                             NULL } };
 645
 646 /* message types for MGMT messages */
 647 #define MESSAGE_TYPE_ERR                  0
 648 #define MESSAGE_TYPE_NTFY                 1
 649 #define MESSAGE_TYPE_TEI_STATUS_REQ       2
 650 #define MESSAGE_TYPE_TEI_STATUS_CON       3
 651 #define MESSAGE_TYPE_TEI_STATUS_IND       4
 652 #define MESSAGE_TYPE_TEI_QUERY_REQ        5
 653
 654 /* message types for ASPSM messages */
 655 #define MESSAGE_TYPE_UP                   1
 656 #define MESSAGE_TYPE_DOWN                 2
 657 #define MESSAGE_TYPE_BEAT                 3
 658 #define MESSAGE_TYPE_UP_ACK               4
 659 #define MESSAGE_TYPE_DOWN_ACK             5
 660 #define MESSAGE_TYPE_BEAT_ACK             6
 661
 662 /* message types for ASPTM messages */
 663 #define MESSAGE_TYPE_ACTIVE               1
 664 #define MESSAGE_TYPE_INACTIVE             2
 665 #define MESSAGE_TYPE_ACTIVE_ACK           3
 666 #define MESSAGE_TYPE_INACTIVE_ACK         4
 667
 668 /* message types for QPTM messages */
 669 #define MESSAGE_TYPE_DATA_REQUEST         1
 670 #define MESSAGE_TYPE_DATA_INDICATION      2
 671 #define MESSAGE_TYPE_UNIT_DATA_REQUEST    3
 672 #define MESSAGE_TYPE_UNIT_DATA_INDICATION 4
 673 #define MESSAGE_TYPE_ESTABLISH_REQUEST    5
 674 #define MESSAGE_TYPE_ESTABLISH_CONFIRM    6
 675 #define MESSAGE_TYPE_ESTABLISH_INDICATION 7
 676 #define MESSAGE_TYPE_RELEASE_REQUEST      8
 677 #define MESSAGE_TYPE_RELEASE_CONFIRM      9
 678 #define MESSAGE_TYPE_RELEASE_INDICATION  10
 679
 680
 681 static const value_string message_class_type_values[] = {
 682   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,                  "Error" },
 683   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,                 "Notify" },
 684   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_REQ,       "TEI status request" },
 685   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_CON,       "TEI status confirmation" },
 686   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_IND,       "TEI status indication" },
 687   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,                   "ASP up" },
 688   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,                 "ASP down" },
 689   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,                 "Heartbeat" },
 690   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,               "ASP up ack" },
 691   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,             "ASP down ack" },
 692   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,             "Heartbeat ack" },
 693   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,              "ASP active" },
 694   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,            "ASP inactive" },
 695   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,          "ASP active ack" },
 696   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK ,        "ASP inactive ack" },
 697   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_DATA_REQUEST,         "Data request" },
 698   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_DATA_INDICATION,      "Data indication" },
 699   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_UNIT_DATA_REQUEST,    "Unit data request" },
 700   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_UNIT_DATA_INDICATION, "Unit data indication" },
 701   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_REQUEST,    "Establish request" },
 702   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_CONFIRM,    "Establish confirmation" },
 703   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_INDICATION, "Establish indication" },
 704   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_REQUEST,      "Release request" },
 705   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_CONFIRM,      "Release confirmation" },
 706   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_INDICATION,   "Release indication" },
 707   { 0,                                                                     NULL } };
 708
 709 static const value_string message_class_type_ig_values[] = {
 710   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,                  "Error" },
 711   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,                 "Notify" },
 712   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_REQ,       "TEI status request" },
 713   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_CON,       "TEI status confirmation" },
 714   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_IND,       "TEI status indication" },
 715   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_QUERY_REQ,        "TEI query request" },
 716   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,                   "ASP up" },
 717   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,                 "ASP down" },
 718   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,                 "Heartbeat" },
 719   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,               "ASP up ack" },
 720   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,             "ASP down ack" },
 721   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,             "Heartbeat ack" },
 722   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,              "ASP active" },
 723   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,            "ASP inactive" },
 724   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,          "ASP active ack" },
 725   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK ,        "ASP inactive ack" },
 726   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_DATA_REQUEST,         "Data request" },
 727   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_DATA_INDICATION,      "Data indication" },
 728   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_UNIT_DATA_REQUEST,    "Unit data request" },
 729   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_UNIT_DATA_INDICATION, "Unit data indication" },
 730   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_REQUEST,    "Establish request" },
 731   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_CONFIRM,    "Establish confirmation" },
 732   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_INDICATION, "Establish indication" },
 733   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_REQUEST,      "Release request" },
 734   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_CONFIRM,      "Release confirmation" },
 735   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_INDICATION,   "Release indication" },
 736   { 0,                                                                     NULL } };
 737
 738 static const value_string message_class_type_acro_values[] = {
 739   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,                  "ERR" },
 740   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,                 "NTFY" },
 741   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_REQ,       "TEI_STAT_REQ" },
 742   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_CON,       "TEI_STAT_CON" },
 743   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_IND,       "TEI_STAT_IND" },
 744   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,                   "ASP_UP" },
 745   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,                 "ASP_DOWN" },
 746   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,                 "BEAT" },
 747   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,               "ASP_UP_ACK" },
 748   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,             "ASP_DOWN_ACK" },
 749   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,             "BEAT_ACK" },
 750   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,              "ASP_ACTIVE" },
 751   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,            "ASP_INACTIVE" },
 752   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,          "ASP_ACTIVE_ACK" },
 753   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK ,        "ASP_INACTIVE_ACK" },
 754   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_DATA_REQUEST,         "DATA_REQ" },
 755   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_DATA_INDICATION,      "DATA_IND" },
 756   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_UNIT_DATA_REQUEST,    "U_DATA_REQ" },
 757   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_UNIT_DATA_INDICATION, "U_DATA_IND" },
 758   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_REQUEST,    "EST_REQ" },
 759   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_CONFIRM,    "EST_CON" },
 760   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_INDICATION, "EST_IND" },
 761   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_REQUEST,      "REL_REQ" },
 762   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_CONFIRM,      "REL_CON" },
 763   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_INDICATION,   "REL_IND" },
 764   { 0,                                                                     NULL } };
 765
 766 static const value_string message_class_type_acro_ig_values[] = {
 767   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,                  "ERR" },
 768   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,                 "NTFY" },
 769   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_REQ,       "TEI_STAT_REQ" },
 770   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_CON,       "TEI_STAT_CON" },
 771   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_STATUS_IND,       "TEI_STAT_IND" },
 772   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_TEI_QUERY_REQ,        "TEI_QUERY_REQ" },
 773   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,                   "ASP_UP" },
 774   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,                 "ASP_DOWN" },
 775   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,                 "BEAT" },
 776   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,               "ASP_UP_ACK" },
 777   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,             "ASP_DOWN_ACK" },
 778   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,             "BEAT_ACK" },
 779   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,              "ASP_ACTIVE" },
 780   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,            "ASP_INACTIVE" },
 781   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,          "ASP_ACTIVE_ACK" },
 782   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK ,        "ASP_INACTIVE_ACK" },
 783   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_DATA_REQUEST,         "DATA_REQ" },
 784   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_DATA_INDICATION,      "DATA_IND" },
 785   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_UNIT_DATA_REQUEST,    "U_DATA_REQ" },
 786   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_UNIT_DATA_INDICATION, "U_DATA_IND" },
 787   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_REQUEST,    "EST_REQ" },
 788   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_CONFIRM,    "EST_CON" },
 789   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_ESTABLISH_INDICATION, "EST_IND" },
 790   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_REQUEST,      "REL_REQ" },
 791   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_CONFIRM,      "REL_CON" },
 792   { MESSAGE_CLASS_QPTM_MESSAGE  * 256 + MESSAGE_TYPE_RELEASE_INDICATION,   "REL_IND" },
 793   { 0,                                                                     NULL } };
 794
 795 static void
 796 dissect_common_header(tvbuff_t *common_header_tvb, packet_info *pinfo, proto_tree *iua_tree)
 797 {
 798   guint8 message_class, message_type;
 799
 800   message_class  = tvb_get_guint8(common_header_tvb, MESSAGE_CLASS_OFFSET);
 801   message_type   = tvb_get_guint8(common_header_tvb, MESSAGE_TYPE_OFFSET);
 802
 803   if (check_col(pinfo->cinfo, COL_INFO)) {
 804     col_append_str(pinfo->cinfo, COL_INFO, val_to_str(message_class * 256 + message_type, support_IG?message_class_type_acro_ig_values:message_class_type_acro_values, "UNKNOWN"));
 805     col_append_str(pinfo->cinfo, COL_INFO, " ");
 806   };
 807
 808   if (iua_tree) {
 809     /* add the components of the common header to the protocol tree */
 810     proto_tree_add_item(iua_tree, hf_version, common_header_tvb, VERSION_OFFSET, VERSION_LENGTH, NETWORK_BYTE_ORDER);
 811     proto_tree_add_item(iua_tree, hf_reserved, common_header_tvb, RESERVED_OFFSET, RESERVED_LENGTH, NETWORK_BYTE_ORDER);
 812     proto_tree_add_item(iua_tree, hf_message_class, common_header_tvb, MESSAGE_CLASS_OFFSET, MESSAGE_CLASS_LENGTH, NETWORK_BYTE_ORDER);
 813     proto_tree_add_uint_format(iua_tree, hf_message_type,
 814                                common_header_tvb, MESSAGE_TYPE_OFFSET, MESSAGE_TYPE_LENGTH,
 815                                message_type, "Message type: %u (%s)",
 816                                message_type, val_to_str(message_class * 256 + message_type, support_IG?message_class_type_ig_values:message_class_type_values, "reserved"));
 817     proto_tree_add_item(iua_tree, hf_message_length, common_header_tvb, MESSAGE_LENGTH_OFFSET, MESSAGE_LENGTH_LENGTH, NETWORK_BYTE_ORDER);
 818   }
 819 }
 820
 821 static void
 822 dissect_iua_message(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *iua_tree)
 823 {
 824   tvbuff_t *common_header_tvb, *parameters_tvb;
 825
 826   common_header_tvb = tvb_new_subset(message_tvb, COMMON_HEADER_OFFSET, COMMON_HEADER_LENGTH, COMMON_HEADER_LENGTH);
 827   parameters_tvb    = tvb_new_subset(message_tvb, PARAMETERS_OFFSET, -1, -1);
 828   dissect_common_header(common_header_tvb, pinfo, iua_tree);
 829   dissect_parameters(parameters_tvb, pinfo, tree, iua_tree);
 830 }
 831
 832 static void
 833 dissect_iua(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree)
 834 {
 835   proto_item *iua_item;
 836   proto_tree *iua_tree;
 837
 838   /* make entry in the Protocol column on summary display */
 839   if (check_col(pinfo->cinfo, COL_PROTOCOL))
 840     col_set_str(pinfo->cinfo, COL_PROTOCOL, support_IG?"IUA (IG)":"IUA (RFC 3057)");
 841
 842   /* In the interest of speed, if "tree" is NULL, don't do any work not
 843      necessary to generate protocol tree items. */
 844   if (tree) {
 845     /* create the m3ua protocol tree */
 846     iua_item = proto_tree_add_item(tree, proto_iua, message_tvb, 0, -1, FALSE);
 847     iua_tree = proto_item_add_subtree(iua_item, ett_iua);
 848   } else {
 849     iua_tree = NULL;
 850   };
 851   /* dissect the message */
 852   dissect_iua_message(message_tvb, pinfo, tree, iua_tree);
 853 }
 854
 855 /* Register the protocol with Ethereal */
 856 void
 857 proto_register_iua(void)
 858 {
 859
 860   /* Setup list of header fields */
 861   static hf_register_info hf[] = {
 862     { &hf_int_interface_id,      { "Integer interface identifier", "iua.int_interface_identifier",  FT_INT32,   BASE_HEX,  NULL,                           0x0,            "", HFILL } },
 863     { &hf_text_interface_id,     { "Text interface identifier",    "iua.text_interface_identifier", FT_STRING,  BASE_NONE, NULL,                           0x0,            "", HFILL } },
 864     { &hf_info_string,           { "Info string",                  "iua.info_string",               FT_STRING,  BASE_NONE, NULL,                           0x0,            "", HFILL } },
 865     { &hf_dlci_zero_bit,         { "Zero bit",                     "iua.dlci_zero_bit",             FT_BOOLEAN, 8,         NULL,                           ZERO_BIT_MASK,  "", HFILL } },
 866     { &hf_dlci_spare_bit,        { "Spare bit",                    "iua.dlci_spare_bit",            FT_BOOLEAN, 8,         NULL,                           SPARE_BIT_MASK, "", HFILL } },
 867     { &hf_dlci_sapi,             { "SAPI",                         "iua.dlci_sapi",                 FT_UINT8,   BASE_HEX,  NULL,                           SAPI_MASK,      "", HFILL } },
 868     { &hf_dlci_one_bit,          { "One bit",                      "iua.dlci_one_bit",              FT_BOOLEAN, 8,         NULL,                           ONE_BIT_MASK,   "", HFILL } },
 869     { &hf_dlci_tei,              { "TEI",                          "iua.dlci_tei",                  FT_UINT8,   BASE_HEX,  NULL,                           TEI_MASK,       "", HFILL } },
 870     { &hf_dlci_spare,            { "Spare",                        "iua.dlci_spare",                FT_UINT16,  BASE_HEX,  NULL,                           0x0,            "", HFILL } },
 871     { &hf_diag_info,             { "Diagnostic information",       "iua.diagnostic_information",    FT_BYTES,   BASE_NONE, NULL,                           0x0,            "", HFILL } },
 872     { &hf_interface_range_start, { "Start",                        "iua.interface_range_start",     FT_UINT32,  BASE_DEC,  NULL,                           0x0,            "", HFILL } },
 873     { &hf_interface_range_end,   { "End",                          "iua.interface_range_end",       FT_UINT32,  BASE_DEC,  NULL,                           0x0,            "", HFILL } },
 874     { &hf_heartbeat_data,        { "Heartbeat data",               "iua.heartbeat_data",            FT_BYTES,   BASE_NONE, NULL,                           0x0,            "", HFILL } },
 875     { &hf_asp_reason,            { "Reason",                       "iua.asp_reason",                FT_UINT32,  BASE_HEX,  VALS(asp_reason_values),        0x0,            "", HFILL } },
 876     { &hf_traffic_mode_type,     { "Traffic mode type",            "iua.traffic_mode_type",         FT_UINT32,  BASE_HEX,  VALS(traffic_mode_type_values), 0x0,            "", HFILL } },
 877     { &hf_error_code,            { "Error code",                   "iua.error_code",                FT_UINT32,  BASE_DEC,  VALS(error_code_values),        0x0,            "", HFILL } },
 878     { &hf_error_code_ig,         { "Error code",                   "iua.error_code",                FT_UINT32,  BASE_DEC,  VALS(error_code_ig_values),     0x0,            "", HFILL } },
 879     { &hf_status_type,           { "Status type",                  "iua.status_type",               FT_UINT16,  BASE_DEC,  VALS(status_type_values),       0x0,            "", HFILL } },
 880     { &hf_status_id,             { "Status identification",        "iua.status_identification",     FT_UINT16,  BASE_DEC,  NULL,                           0x0,            "", HFILL } },
 881     { &hf_release_reason,        { "Reason",                       "iua.release_reason",            FT_UINT32,  BASE_HEX,  VALS(release_reason_values),    0x0,            "", HFILL } },
 882     { &hf_tei_status,            { "TEI status",                   "iua.tei_status",                FT_UINT32,  BASE_HEX,  VALS(tei_status_values),        0x0,            "", HFILL } },
 883     { &hf_asp_id,                { "ASP identifier",               "iua.asp_identifier",            FT_UINT32,  BASE_HEX,  NULL,                           0x0,            "", HFILL } },
 884     { &hf_parameter_tag,         { "Parameter Tag",                "iua.parameter_tag",             FT_UINT16,  BASE_DEC,  VALS(parameter_tag_values),     0x0,            "", HFILL } },
 885     { &hf_parameter_tag_ig,      { "Parameter Tag",                "iua.parameter_tag",             FT_UINT16,  BASE_DEC,  VALS(parameter_tag_ig_values),  0x0,            "", HFILL } },
 886     { &hf_parameter_length,      { "Parameter length",             "iua.parameter_length",          FT_UINT16,  BASE_DEC,  NULL,                           0x0,            "", HFILL } },
 887     { &hf_parameter_value,       { "Parameter value",              "iua.parameter_value",           FT_BYTES,   BASE_NONE, NULL,                           0x0,            "", HFILL } },
 888     { &hf_parameter_padding,     { "Parameter padding",            "iua.parameter_padding",         FT_BYTES,   BASE_NONE, NULL,                           0x0,            "", HFILL } },
 889     { &hf_version,               { "Version",                      "iua.version",                   FT_UINT8,   BASE_DEC,  VALS(protocol_version_values),  0x0,            "", HFILL } },
 890     { &hf_reserved,              { "Reserved",                     "iua.reserved",                  FT_UINT8,   BASE_HEX,  NULL,                           0x0,            "", HFILL } },
 891     { &hf_message_class,         { "Message class",                "iua.message_class",             FT_UINT8,   BASE_DEC,  VALS(message_class_values),     0x0,            "", HFILL } },
 892     { &hf_message_type,          { "Message Type",                 "iua.message_type",              FT_UINT8,   BASE_DEC,  NULL,                           0x0,            "", HFILL } },
 893     { &hf_message_length,        { "Message length",               "iua.message_length",            FT_UINT32,  BASE_DEC,  NULL,                           0x0,            "", HFILL } },
 894    };
 895   /* Setup protocol subtree array */
 896   static gint *ett[] = {
 897     &ett_iua,
 898     &ett_iua_parameter,
 899   };
 900
 901   /* Register the protocol name and description */
 902   proto_iua = proto_register_protocol("ISDN Q.921-User Adaptation Layer", "IUA", "iua");
 903   iua_module = prefs_register_protocol(proto_iua, NULL);
 904
 905   /* Required function calls to register the header fields and subtrees used */
 906   proto_register_field_array(proto_iua, hf, array_length(hf));
 907   proto_register_subtree_array(ett, array_length(ett));
 908   prefs_register_bool_preference(iua_module, "support_ig", "Support Implementers Guide", "Support Implementers Guide (version 00)", &support_IG);
 909 };
 910
 911 #define SCTP_PORT_IUA          9900
 912 #define IUA_PAYLOAD_PROTO_ID   1
 913
 914 void
 915 proto_reg_handoff_iua(void)
 916 {
 917   dissector_handle_t iua_handle;
 918
 919   iua_handle  = create_dissector_handle(dissect_iua, proto_iua);
 920   q931_handle = find_dissector("q931");
 921
 922   dissector_add("sctp.port", SCTP_PORT_IUA,        iua_handle);
 923   dissector_add("sctp.ppi",  IUA_PAYLOAD_PROTO_ID, iua_handle);
 924 }