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