2 * Routines for ISDN Q.921-User Adaptation Layer dissection
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
9 * Copyright 2002, Michael Tuexen <Michael.Tuexen@icn.siemens.de>
11 * $Id: packet-iua.c,v 1.15 2002/07/12 19:37:33 guy Exp $
13 * Ethereal - Network traffic analyzer
14 * By Gerald Combs <gerald@ethereal.com>
15 * Copyright 1998 Gerald Combs
17 * Copied from README.developer
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.
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.
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.
38 #include <epan/packet.h>
41 #define NETWORK_BYTE_ORDER FALSE
43 static module_t *iua_module;
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;
80 /* Initialize the subtree pointers */
81 static gint ett_iua = -1;
82 static gint ett_iua_parameter = -1;
84 /* option setable via preferences, default is plain RFC 3057 */
85 static gboolean support_IG = FALSE;
87 static dissector_handle_t q931_handle;
90 nr_of_padding_bytes (guint length)
94 remainder = length % 4;
102 #define PARAMETER_TAG_LENGTH 2
103 #define PARAMETER_LENGTH_LENGTH 2
104 #define PARAMETER_HEADER_LENGTH (PARAMETER_TAG_LENGTH + PARAMETER_LENGTH_LENGTH)
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
111 #define INT_INTERFACE_ID_OFFSET PARAMETER_VALUE_OFFSET
112 #define INT_INTERFACE_ID_LENGTH 4
115 dissect_int_interface_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
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));
121 #define TEXT_INTERFACE_ID_OFFSET PARAMETER_VALUE_OFFSET
124 dissect_text_interface_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
126 guint16 interface_id_length;
128 interface_id_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
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));
135 #define INFO_STRING_OFFSET PARAMETER_VALUE_OFFSET
138 dissect_info_string_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
140 guint16 info_string_length;
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));
148 #define DLCI_SAPI_LENGTH 1
149 #define DLCI_TEI_LENGTH 1
150 #define DLCI_SPARE_LENGTH 2
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)
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
163 dissect_dlci_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree)
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);
174 dissect_diagnostic_information_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
176 guint16 diag_info_length;
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"));
183 #define START_LENGTH 4
185 #define INTERVAL_LENGTH (START_LENGTH + END_LENGTH)
187 #define START_OFFSET 0
188 #define END_OFFSET (START_OFFSET + START_LENGTH)
191 dissect_integer_range_interface_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
193 guint16 number_of_ranges, range_number;
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;
204 proto_item_append_text(parameter_item, " (%u range%s)", number_of_ranges, plurality(number_of_ranges, "", "s"));
207 #define HEARTBEAT_DATA_OFFSET PARAMETER_VALUE_OFFSET
210 dissect_heartbeat_data_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
212 guint16 heartbeat_data_length;
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"));
219 #define ASP_MGMT_REASON 1
221 static const value_string asp_reason_values[] = {
222 { ASP_MGMT_REASON, "Management inhibit" },
225 #define ASP_REASON_LENGTH 4
226 #define ASP_REASON_OFFSET PARAMETER_VALUE_OFFSET
229 dissect_asp_reason_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
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"));
235 #define OVER_RIDE_TRAFFIC_MODE_TYPE 1
236 #define LOAD_SHARE_TRAFFIC_MODE_TYPE 2
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" },
243 #define TRAFFIC_MODE_TYPE_LENGTH 4
244 #define TRAFFIC_MODE_TYPE_OFFSET PARAMETER_VALUE_OFFSET
247 dissect_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
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"));
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
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" },
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" },
303 #define ERROR_CODE_LENGTH 4
304 #define ERROR_CODE_OFFSET PARAMETER_VALUE_OFFSET
307 dissect_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
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"));
314 #define ASP_STATE_CHANGE_STATUS_TYPE 0x01
315 #define OTHER_STATUS_TYPE 0x02
317 static const value_string status_type_values[] = {
318 { ASP_STATE_CHANGE_STATUS_TYPE, "Application server state change" },
319 { OTHER_STATUS_TYPE, "Other" },
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
327 #define INSUFFICIENT_ASP_RESOURCES_STATUS_IDENT 0x01
328 #define ALTERNATE_ASP_ACTIVE_STATUS_IDENT 0x02
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" },
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" },
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)
353 dissect_status_type_identification_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
355 guint16 status_type, status_id;
357 status_type = tvb_get_ntohs(parameter_tvb, STATUS_TYPE_OFFSET);
358 status_id = tvb_get_ntohs(parameter_tvb, STATUS_IDENT_OFFSET);
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"));
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"));
369 #define PROTOCOL_DATA_OFFSET PARAMETER_VALUE_OFFSET
372 dissect_protocol_data_parameter(tvbuff_t *parameter_tvb, proto_item *parameter_item, packet_info *pinfo, proto_tree *tree)
374 guint16 protocol_data_length;
375 tvbuff_t *protocol_data_tvb;
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);
381 proto_item_append_text(parameter_item, " (%u byte%s)", protocol_data_length, plurality(protocol_data_length, "", "s"));
384 #define RELEASE_MGMT_REASON 0
385 #define RELEASE_PHYS_REASON 1
386 #define RELEASE_DM_REASON 2
387 #define RELEASE_OTHER_REASON 4
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" },
396 #define RELEASE_REASON_OFFSET PARAMETER_VALUE_OFFSET
397 #define RELEASE_REASON_LENGTH 4
400 dissect_release_reason_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
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"));
407 #define TEI_STATUS_ASSIGNED 0
408 #define TEI_STATUS_UNASSIGNED 1
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" },
415 #define TEI_STATUS_LENGTH 4
416 #define TEI_STATUS_OFFSET PARAMETER_VALUE_OFFSET
419 dissect_tei_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
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"));
426 #define ASP_ID_LENGTH 4
427 #define ASP_ID_OFFSET PARAMETER_VALUE_OFFSET
430 dissect_asp_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
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));
437 dissect_unknown_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
439 guint16 parameter_value_length;
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"));
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
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" },
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"},
499 dissect_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *iua_tree)
501 guint16 tag, length, padding_length;
502 proto_item *parameter_item;
503 proto_tree *parameter_tree;
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;
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);
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);
520 case INT_INTERFACE_IDENTIFIER_PARAMETER_TAG:
521 dissect_int_interface_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
523 case TEXT_INTERFACE_IDENTIFIER_PARAMETER_TAG:
524 dissect_text_interface_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
526 case INFO_PARAMETER_TAG:
527 dissect_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
529 case DLCI_PARAMETER_TAG:
530 dissect_dlci_parameter(parameter_tvb, parameter_tree);
532 case DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
533 dissect_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
535 case INTEGER_RANGE_INTERFACE_IDENTIFIER_PARAMETER_TAG:
536 dissect_integer_range_interface_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
538 case HEARTBEAT_DATA_PARAMETER_TAG:
539 dissect_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
541 case ASP_REASON_PARAMETER_TAG:
543 dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
545 dissect_asp_reason_parameter(parameter_tvb, parameter_tree, parameter_item);
547 case TRAFFIC_MODE_TYPE_PARAMETER_TAG:
548 dissect_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
550 case ERROR_CODE_PARAMETER_TAG:
551 dissect_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
553 case STATUS_TYPE_INDENTIFICATION_PARAMETER_TAG:
554 dissect_status_type_identification_parameter(parameter_tvb, parameter_tree, parameter_item);
556 case PROTOCOL_DATA_PARAMETER_TAG:
557 dissect_protocol_data_parameter(parameter_tvb, parameter_item, pinfo, tree);
559 case RELEASE_REASON_PARAMETER_TAG:
560 dissect_release_reason_parameter(parameter_tvb, parameter_tree, parameter_item);
562 case TEI_STATUS_PARAMETER_TAG:
563 dissect_tei_status_parameter(parameter_tvb, parameter_tree, parameter_item);
565 case ASP_IDENTIFIER_PARAMETER_TAG:
567 dissect_asp_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
569 dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
572 dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
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);
581 dissect_parameters(tvbuff_t *parameters_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *iua_tree)
583 gint offset, length, padding_length, total_length, remaining_length;
584 tvbuff_t *parameter_tvb;
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);
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;
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)
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)
618 #define PROTOCOL_VERSION_RELEASE_1 1
620 static const value_string protocol_version_values[] = {
621 { PROTOCOL_VERSION_RELEASE_1, "Release 1" },
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
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)" },
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
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
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
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
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" },
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" },
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" },
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" },
796 dissect_common_header(tvbuff_t *common_header_tvb, packet_info *pinfo, proto_tree *iua_tree)
798 guint8 message_class, message_type;
800 message_class = tvb_get_guint8(common_header_tvb, MESSAGE_CLASS_OFFSET);
801 message_type = tvb_get_guint8(common_header_tvb, MESSAGE_TYPE_OFFSET);
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, " ");
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);
822 dissect_iua_message(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *iua_tree)
824 tvbuff_t *common_header_tvb, *parameters_tvb;
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);
833 dissect_iua(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree)
835 proto_item *iua_item;
836 proto_tree *iua_tree;
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)");
842 /* In the interest of speed, if "tree" is NULL, don't do any work not
843 necessary to generate protocol tree items. */
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);
851 /* dissect the message */
852 dissect_iua_message(message_tvb, pinfo, tree, iua_tree);
855 /* Register the protocol with Ethereal */
857 proto_register_iua(void)
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 } },
895 /* Setup protocol subtree array */
896 static gint *ett[] = {
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);
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);
911 #define SCTP_PORT_IUA 9900
912 #define IUA_PAYLOAD_PROTO_ID 1
915 proto_reg_handoff_iua(void)
917 dissector_handle_t iua_handle;
919 iua_handle = create_dissector_handle(dissect_iua, proto_iua);
920 q931_handle = find_dissector("q931");
922 dissector_add("sctp.port", SCTP_PORT_IUA, iua_handle);
923 dissector_add("sctp.ppi", IUA_PAYLOAD_PROTO_ID, iua_handle);