1 /* packet-m3ua.c
2  * Routines for MTP3 User Adaptation Layer dissection
3  * It is hopefully (needs testing) compliant to
4  * https://tools.ietf.org/html/draft-ietf-sigtran-m3ua-05 (expired)
5  * https://tools.ietf.org/html/draft-ietf-sigtran-m3ua-06 (expired)
6  * https://tools.ietf.org/html/draft-ietf-sigtran-m3ua-07 (expired)
7  * https://tools.ietf.org/html/rfc3332
8  * https://datatracker.ietf.org/doc/rfc4666/
9  *
10  * Copyright 2000, 2001, 2002, 2003, 2004 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 README.developer
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/prefs.h>
25 #include <epan/address_types.h>
26 #include <epan/sctpppids.h>
27 #include <wsutil/str_util.h>
28 #include "packet-mtp3.h"
29 #include "packet-sccp.h"
30 #include "packet-frame.h"
31 #include "packet-q708.h"
32 #include <epan/tap.h>
33 
34 void proto_register_m3ua(void);
35 void proto_reg_handoff_m3ua(void);
36 
37 static gint m3ua_pref_mtp3_standard;
38 
39 #define SCTP_PORT_M3UA         2905
40 #define ADD_PADDING(x) ((((x) + 3) >> 2) << 2)
41 
42 #define VERSION_LENGTH         1
43 #define RESERVED_LENGTH        1
44 #define MESSAGE_CLASS_LENGTH   1
45 #define MESSAGE_TYPE_LENGTH    1
46 #define MESSAGE_LENGTH_LENGTH  4
47 #define COMMON_HEADER_LENGTH   (VERSION_LENGTH + RESERVED_LENGTH + MESSAGE_CLASS_LENGTH + \
48                                 MESSAGE_TYPE_LENGTH + MESSAGE_LENGTH_LENGTH)
49 
50 #define VERSION_OFFSET         0
51 #define RESERVED_OFFSET        (VERSION_OFFSET + VERSION_LENGTH)
52 #define MESSAGE_CLASS_OFFSET   (RESERVED_OFFSET + RESERVED_LENGTH)
53 #define MESSAGE_TYPE_OFFSET    (MESSAGE_CLASS_OFFSET + MESSAGE_CLASS_LENGTH)
54 #define MESSAGE_LENGTH_OFFSET  (MESSAGE_TYPE_OFFSET + MESSAGE_TYPE_LENGTH)
55 
56 #define PARAMETER_TAG_LENGTH    2
57 #define PARAMETER_LENGTH_LENGTH 2
58 #define PARAMETER_HEADER_LENGTH (PARAMETER_TAG_LENGTH + PARAMETER_LENGTH_LENGTH)
59 
60 #define PARAMETER_TAG_OFFSET    0
61 #define PARAMETER_LENGTH_OFFSET (PARAMETER_TAG_OFFSET + PARAMETER_TAG_LENGTH)
62 #define PARAMETER_VALUE_OFFSET  (PARAMETER_LENGTH_OFFSET + PARAMETER_LENGTH_LENGTH)
63 #define PARAMETER_HEADER_OFFSET PARAMETER_TAG_OFFSET
64 
65 #define PROTOCOL_VERSION_RELEASE_1             1
66 
67 static const value_string protocol_version_values[] = {
68   { PROTOCOL_VERSION_RELEASE_1,  "Release 1" },
69   { 0,                           NULL } };
70 
71 #define MESSAGE_CLASS_MGMT_MESSAGE        0
72 #define MESSAGE_CLASS_TFER_MESSAGE        1
73 #define MESSAGE_CLASS_SSNM_MESSAGE        2
74 #define MESSAGE_CLASS_ASPSM_MESSAGE       3
75 #define MESSAGE_CLASS_ASPTM_MESSAGE       4
76 #define MESSAGE_CLASS_RKM_MESSAGE         9
77 
78 static const value_string message_class_values[] = {
79   { MESSAGE_CLASS_MGMT_MESSAGE,   "Management messages" },
80   { MESSAGE_CLASS_TFER_MESSAGE,   "Transfer messages" },
81   { MESSAGE_CLASS_SSNM_MESSAGE,   "SS7 signalling network management messages" },
82   { MESSAGE_CLASS_ASPSM_MESSAGE,  "ASP state maintenance messages" },
83   { MESSAGE_CLASS_ASPTM_MESSAGE,  "ASP traffic maintenance messages" },
84   { MESSAGE_CLASS_RKM_MESSAGE,    "Routing key management messages" },
85   { 0,                           NULL } };
86 
87 static const value_string v5_message_class_values[] = {
88   { MESSAGE_CLASS_MGMT_MESSAGE,   "Management messages" },
89   { MESSAGE_CLASS_TFER_MESSAGE,   "Transfer messages" },
90   { MESSAGE_CLASS_SSNM_MESSAGE,   "SS7 signalling network management messages" },
91   { MESSAGE_CLASS_ASPSM_MESSAGE,  "ASP state maintenance messages" },
92   { MESSAGE_CLASS_ASPTM_MESSAGE,  "ASP traffic maintenance messages" },
93   { 0,                           NULL } };
94 
95 #define MESSAGE_TYPE_ERR                  0
96 #define MESSAGE_TYPE_NTFY                 1
97 
98 #define MESSAGE_TYPE_DATA                 1
99 
100 #define MESSAGE_TYPE_DUNA                 1
101 #define MESSAGE_TYPE_DAVA                 2
102 #define MESSAGE_TYPE_DAUD                 3
103 #define MESSAGE_TYPE_SCON                 4
104 #define MESSAGE_TYPE_DUPU                 5
105 #define MESSAGE_TYPE_DRST                 6
106 
107 #define MESSAGE_TYPE_UP                   1
108 #define MESSAGE_TYPE_DOWN                 2
109 #define MESSAGE_TYPE_BEAT                 3
110 #define MESSAGE_TYPE_UP_ACK               4
111 #define MESSAGE_TYPE_DOWN_ACK             5
112 #define MESSAGE_TYPE_BEAT_ACK             6
113 
114 #define MESSAGE_TYPE_ACTIVE               1
115 #define MESSAGE_TYPE_INACTIVE             2
116 #define MESSAGE_TYPE_ACTIVE_ACK           3
117 #define MESSAGE_TYPE_INACTIVE_ACK         4
118 
119 #define MESSAGE_TYPE_REG_REQ              1
120 #define MESSAGE_TYPE_REG_RSP              2
121 #define MESSAGE_TYPE_DEREG_REQ            3
122 #define MESSAGE_TYPE_DEREG_RSP            4
123 
124 static const value_string v5_message_class_type_values[] = {
125   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,           "Error (ERR)" },
126   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,          "Notify (NTFY)" },
127   { MESSAGE_CLASS_TFER_MESSAGE  * 256 + MESSAGE_TYPE_DATA,          "Payload data (DATA)" },
128   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUNA,          "Destination unavailable (DUNA)" },
129   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAVA,          "Destination available (DAVA)" },
130   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAUD,          "Destination state audit (DAUD)" },
131   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_SCON,          "SS7 Network congestion state (SCON)" },
132   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUPU,          "Destination userpart unavailable (DUPU)" },
133   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,            "ASP up (UP)" },
134   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,          "ASP down (DOWN)" },
135   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,          "Heartbeat (BEAT)" },
136   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,        "ASP up ack (UP ACK)" },
137   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,      "ASP down ack (DOWN ACK)" },
138   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,      "Heartbeat ack (BEAT ACK)" },
139   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,       "ASP active (ACTIVE)" },
140   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,     "ASP inactive (INACTIVE)" },
141   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,   "ASP active ack (ACTIVE ACK)" },
142   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK , "ASP inactive ack (INACTIVE ACK)" },
143   { 0,                                                              NULL } };
144 
145 static const value_string message_class_type_values[] = {
146   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,           "Error (ERR)" },
147   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,          "Notify (NTFY)" },
148   { MESSAGE_CLASS_TFER_MESSAGE  * 256 + MESSAGE_TYPE_DATA,          "Payload data (DATA)" },
149   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUNA,          "Destination unavailable (DUNA)" },
150   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAVA,          "Destination available (DAVA)" },
151   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAUD,          "Destination state audit (DAUD)" },
152   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_SCON,          "SS7 Network congestion state (SCON)" },
153   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUPU,          "Destination userpart unavailable (DUPU)" },
154   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DRST,          "Destination Restricted (DRST)" },
155   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,            "ASP up (ASPUP)" },
156   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,          "ASP down (ASPDN)" },
157   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,          "Heartbeat (BEAT)" },
158   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,        "ASP up ack (ASPUP_ACK)" },
159   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,      "ASP down ack (ASPDN_ACK)" },
160   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,      "Heartbeat ack (BEAT_ACK)" },
161   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,       "ASP active (ASPAC)" },
162   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,     "ASP inactive (ASPIA)" },
163   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,   "ASP active ack (ASPAC_ACK)" },
164   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK , "ASP inactive ack (ASPIA_ACK)" },
165   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_REG_REQ ,      "Registration request (REG_REQ)" },
166   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_REG_RSP ,      "Registration response (REG_RSP)" },
167   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_REQ ,    "Deregistration request (DEREG_REQ)" },
168   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_RSP ,    "Deregistration response (DEREG_RSP)" },
169   { 0,                           NULL } };
170 
171 static const value_string v5_message_class_type_acro_values[] = {
172   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,           "ERR" },
173   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,          "NTFY" },
174   { MESSAGE_CLASS_TFER_MESSAGE  * 256 + MESSAGE_TYPE_DATA,          "DATA" },
175   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUNA,          "DUNA" },
176   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAVA,          "DAVA" },
177   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAUD,          "DAUD" },
178   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_SCON,          "SCON" },
179   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUPU,          "DUPU" },
180   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,            "ASP_UP" },
181   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,          "ASP_DOWN" },
182   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,          "BEAT" },
183   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,        "ASP_UP_ACK" },
184   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,      "ASP_DOWN_ACK" },
185   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,      "BEAT_ACK" },
186   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,       "ASP_ACTIVE" },
187   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,     "ASP_INACTIVE" },
188   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,   "ASP_ACTIVE_ACK" },
189   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK , "ASP_INACTIVE_ACK" },
190   { 0,                                                              NULL } };
191 
192 static const value_string message_class_type_acro_values[] = {
193   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_ERR,           "ERR" },
194   { MESSAGE_CLASS_MGMT_MESSAGE  * 256 + MESSAGE_TYPE_NTFY,          "NTFY" },
195   { MESSAGE_CLASS_TFER_MESSAGE  * 256 + MESSAGE_TYPE_DATA,          "DATA" },
196   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUNA,          "DUNA" },
197   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAVA,          "DAVA" },
198   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DAUD,          "DAUD" },
199   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_SCON,          "SCON" },
200   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DUPU,          "DUPU" },
201   { MESSAGE_CLASS_SSNM_MESSAGE  * 256 + MESSAGE_TYPE_DRST,          "DRST" },
202   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP,            "ASPUP" },
203   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN,          "ASPDN" },
204   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT,          "BEAT" },
205   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_UP_ACK,        "ASPUP_ACK" },
206   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_DOWN_ACK,      "ASPDN_ACK" },
207   { MESSAGE_CLASS_ASPSM_MESSAGE * 256 + MESSAGE_TYPE_BEAT_ACK,      "BEAT_ACK" },
208   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE ,       "ASPAC" },
209   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE ,     "ASPIA" },
210   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_ACTIVE_ACK ,   "ASPAC_ACK" },
211   { MESSAGE_CLASS_ASPTM_MESSAGE * 256 + MESSAGE_TYPE_INACTIVE_ACK , "ASPIA_ACK" },
212   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_REG_REQ ,      "REG_REQ" },
213   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_REG_RSP ,      "REG_RSP" },
214   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_REQ ,    "DEREG_REQ" },
215   { MESSAGE_CLASS_RKM_MESSAGE   * 256 + MESSAGE_TYPE_DEREG_RSP ,    "DEREG_RSP" },
216   { 0,                           NULL } };
217 
218 /* Initialize the protocol and registered fields */
219 static int proto_m3ua = -1;
220 static int hf_version = -1;
221 static int hf_reserved = -1;
222 static int hf_message_class = -1;
223 static int hf_v5_message_class = -1;
224 static int hf_message_type = -1;
225 static int hf_message_length = -1;
226 static int hf_v5_parameter_tag = -1;
227 static int hf_v6_parameter_tag = -1;
228 static int hf_v7_parameter_tag = -1;
229 static int hf_parameter_tag = -1;
230 static int hf_parameter_length = -1;
231 static int hf_parameter_value = -1;
232 static int hf_parameter_padding = -1;
233 /* static int hf_parameter_trailer = -1; */
234 static int hf_network_appearance = -1;
235 static int hf_info_string = -1;
236 static int hf_routing_context = -1;
237 static int hf_diagnostic_information = -1;
238 static int hf_heartbeat_data = -1;
239 static int hf_v5_error_code = -1;
240 static int hf_v6_error_code = -1;
241 static int hf_v7_error_code = -1;
242 static int hf_error_code = -1;
243 static int hf_status_type = -1;
244 static int hf_status_info = -1;
245 static int hf_asp_identifier = -1;
246 static int hf_affected_point_code_mask = -1;
247 static int hf_affected_point_code_pc = -1;
248 static int hf_cause = -1;
249 static int hf_user = -1;
250 static int hf_reason = -1;
251 static int hf_v5_traffic_mode_type = -1;
252 static int hf_v6_traffic_mode_type = -1;
253 static int hf_v7_traffic_mode_type = -1;
254 static int hf_traffic_mode_type = -1;
255 static int hf_congestion_reserved = -1;
256 static int hf_congestion_level = -1;
257 static int hf_concerned_dest_reserved = -1;
258 static int hf_concerned_dest_pc = -1;
259 static int hf_local_rk_identifier = -1;
260 static int hf_dpc_mask = -1;
261 static int hf_dpc_pc = -1;
262 static int hf_si = -1;
263 static int hf_ssn = -1;
264 static int hf_opc_list_mask = -1;
265 static int hf_opc_list_pc = -1;
266 static int hf_cic_range_mask = -1;
267 static int hf_cic_range_pc = -1;
268 static int hf_cic_range_upper = -1;
269 static int hf_cic_range_lower = -1;
270 static int hf_protocol_data_opc = -1;
271 static int hf_protocol_data_dpc = -1;
272 static int hf_protocol_data_mtp3_opc = -1;
273 static int hf_protocol_data_mtp3_dpc = -1;
274 static int hf_protocol_data_mtp3_pc = -1;
275 static int hf_protocol_data_si = -1;
276 static int hf_protocol_data_ni = -1;
277 static int hf_protocol_data_mtp3_ni = -1;
278 static int hf_protocol_data_mp = -1;
279 static int hf_protocol_data_sls = -1;
280 static int hf_protocol_data_mtp3_sls = -1;
281 static int hf_correlation_identifier = -1;
282 static int hf_registration_status = -1;
283 static int hf_deregistration_status = -1;
284 static int hf_registration_result_identifier = -1;
285 static int hf_registration_result_status = -1;
286 static int hf_registration_result_context = -1;
287 static int hf_v6_deregistration_result_status = -1;
288 static int hf_v6_deregistration_result_context = -1;
289 static int hf_li = -1;
290 static int hf_heuristic_standard = -1;
291 
292 static int m3ua_tap = -1;
293 
294 /* Initialize the subtree pointers */
295 static gint ett_m3ua = -1;
296 static gint ett_parameter = -1;
297 static gint ett_mtp3_equiv = -1;
298 static gint ett_q708_opc = -1;
299 static gint ett_q708_dpc = -1;
300 
301 static module_t *m3ua_module;
302 static dissector_handle_t mtp3_handle;
303 static dissector_handle_t m3ua_handle;
304 static dissector_table_t si_dissector_table;
305 
306 static int ss7pc_address_type = -1;
307 
308 /* stuff for supporting multiple versions */
309 typedef enum {
310   M3UA_V5,
311   M3UA_V6,
312   M3UA_V7,
313   M3UA_RFC
314 } Version_Type;
315 
316 static gint version = M3UA_RFC;
317 
318 
319 
320 static void
321 dissect_parameters(tvbuff_t *, packet_info *, proto_tree *, proto_tree *);
322 
323 static void
dissect_v5_common_header(tvbuff_t * common_header_tvb,packet_info * pinfo,proto_tree * m3ua_tree)324 dissect_v5_common_header(tvbuff_t *common_header_tvb, packet_info *pinfo, proto_tree *m3ua_tree)
325 {
326   guint8  message_class, message_type;
327 
328   /* Extract the common header */
329   message_class  = tvb_get_guint8(common_header_tvb, MESSAGE_CLASS_OFFSET);
330   message_type   = tvb_get_guint8(common_header_tvb, MESSAGE_TYPE_OFFSET);
331 
332   col_add_fstr(pinfo->cinfo, COL_INFO, "%s ", val_to_str_const(message_class * 256 + message_type, v5_message_class_type_acro_values, "reserved"));
333 
334   if (m3ua_tree) {
335     /* add the components of the common header to the protocol tree */
336     proto_tree_add_item(m3ua_tree, hf_version, common_header_tvb, VERSION_OFFSET, VERSION_LENGTH, ENC_BIG_ENDIAN);
337     proto_tree_add_item(m3ua_tree, hf_reserved, common_header_tvb, RESERVED_OFFSET, RESERVED_LENGTH, ENC_BIG_ENDIAN);
338     proto_tree_add_item(m3ua_tree, hf_v5_message_class, common_header_tvb, MESSAGE_CLASS_OFFSET, MESSAGE_CLASS_LENGTH, ENC_BIG_ENDIAN);
339     proto_tree_add_uint_format_value(m3ua_tree, hf_message_type, common_header_tvb, MESSAGE_TYPE_OFFSET, MESSAGE_TYPE_LENGTH, message_type,
340                                "%s (%u)", val_to_str_const(message_class * 256 + message_type, v5_message_class_type_values, "reserved"), message_type);
341     proto_tree_add_item(m3ua_tree, hf_message_length, common_header_tvb, MESSAGE_LENGTH_OFFSET, MESSAGE_LENGTH_LENGTH, ENC_BIG_ENDIAN);
342   }
343 }
344 
345 static void
dissect_common_header(tvbuff_t * common_header_tvb,packet_info * pinfo,proto_tree * m3ua_tree)346 dissect_common_header(tvbuff_t *common_header_tvb, packet_info *pinfo, proto_tree *m3ua_tree)
347 {
348   guint8  message_class, message_type;
349 
350   /* Extract the common header */
351   message_class  = tvb_get_guint8(common_header_tvb, MESSAGE_CLASS_OFFSET);
352   message_type   = tvb_get_guint8(common_header_tvb, MESSAGE_TYPE_OFFSET);
353 
354   col_add_fstr(pinfo->cinfo, COL_INFO,"%s ", val_to_str_const(message_class * 256 + message_type, message_class_type_acro_values, "reserved"));
355 
356   if (m3ua_tree) {
357     /* add the components of the common header to the protocol tree */
358     proto_tree_add_item(m3ua_tree, hf_version, common_header_tvb, VERSION_OFFSET, VERSION_LENGTH, ENC_BIG_ENDIAN);
359     proto_tree_add_item(m3ua_tree, hf_reserved, common_header_tvb, RESERVED_OFFSET, RESERVED_LENGTH, ENC_BIG_ENDIAN);
360     proto_tree_add_item(m3ua_tree, hf_message_class, common_header_tvb, MESSAGE_CLASS_OFFSET, MESSAGE_CLASS_LENGTH, ENC_BIG_ENDIAN);
361     proto_tree_add_uint_format_value(m3ua_tree, hf_message_type, common_header_tvb, MESSAGE_TYPE_OFFSET, MESSAGE_TYPE_LENGTH, message_type,
362                                "%s (%u)", val_to_str_const(message_class * 256 + message_type, message_class_type_values, "reserved"), message_type);
363     proto_tree_add_item(m3ua_tree, hf_message_length, common_header_tvb, MESSAGE_LENGTH_OFFSET, MESSAGE_LENGTH_LENGTH, ENC_BIG_ENDIAN);
364   }
365 }
366 
367 #define NETWORK_APPEARANCE_LENGTH 4
368 #define NETWORK_APPEARANCE_OFFSET PARAMETER_VALUE_OFFSET
369 
370 static void
dissect_network_appearance_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)371 dissect_network_appearance_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
372 {
373   proto_tree_add_item(parameter_tree, hf_network_appearance, parameter_tvb, NETWORK_APPEARANCE_OFFSET, NETWORK_APPEARANCE_LENGTH, ENC_BIG_ENDIAN);
374   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohl(parameter_tvb, NETWORK_APPEARANCE_OFFSET));
375 }
376 
377 #define V5_PROTOCOL_DATA_OFFSET PARAMETER_VALUE_OFFSET
378 
379 static void
dissect_v5_protocol_data_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_item * parameter_item)380 dissect_v5_protocol_data_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_item *parameter_item)
381 {
382   guint16 length, protocol_data_length;
383   tvbuff_t *payload_tvb;
384 
385   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
386   protocol_data_length = length - PARAMETER_HEADER_LENGTH;
387   payload_tvb          = tvb_new_subset_length(parameter_tvb, V5_PROTOCOL_DATA_OFFSET, protocol_data_length);
388   proto_item_append_text(parameter_item, " (SS7 message of %u byte%s)", protocol_data_length, plurality(protocol_data_length, "", "s"));
389   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH);
390   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
391 }
392 
393 #define INFO_STRING_OFFSET PARAMETER_VALUE_OFFSET
394 
395 static void
dissect_info_string_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)396 dissect_info_string_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
397 {
398   guint16 info_string_length;
399 
400   info_string_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
401   proto_tree_add_item(parameter_tree, hf_info_string, parameter_tvb, INFO_STRING_OFFSET, info_string_length, ENC_ASCII|ENC_NA);
402   proto_item_append_text(parameter_item, " (%.*s)", info_string_length,
403                          tvb_format_text(wmem_packet_scope(), parameter_tvb, INFO_STRING_OFFSET, info_string_length));
404 }
405 
406 #define AFFECTED_MASK_LENGTH 1
407 #define AFFECTED_DPC_LENGTH  3
408 #define AFFECTED_DESTINATION_LENGTH (AFFECTED_MASK_LENGTH + AFFECTED_DPC_LENGTH)
409 
410 #define AFFECTED_MASK_OFFSET 0
411 #define AFFECTED_DPC_OFFSET  1
412 
413 static void
dissect_affected_destinations_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)414 dissect_affected_destinations_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
415 {
416   guint16 number_of_destinations, destination_number;
417   gint destination_offset;
418   proto_item *item;
419 
420   number_of_destinations = (tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH) >> 2;
421   destination_offset = PARAMETER_VALUE_OFFSET;
422   for(destination_number=0; destination_number < number_of_destinations; destination_number++) {
423     proto_tree_add_item(parameter_tree, hf_affected_point_code_mask, parameter_tvb, destination_offset + AFFECTED_MASK_OFFSET, AFFECTED_MASK_LENGTH, ENC_BIG_ENDIAN);
424     item = proto_tree_add_item(parameter_tree, hf_affected_point_code_pc,   parameter_tvb, destination_offset + AFFECTED_DPC_OFFSET,  AFFECTED_DPC_LENGTH,  ENC_BIG_ENDIAN);
425     if (mtp3_pc_structured())
426       proto_item_append_text(item, " (%s)", mtp3_pc_to_str(tvb_get_ntoh24(parameter_tvb, destination_offset + AFFECTED_DPC_OFFSET)));
427     destination_offset += AFFECTED_DESTINATION_LENGTH;
428   }
429   proto_item_append_text(parameter_item, " (%u destination%s)", number_of_destinations, plurality(number_of_destinations, "", "s"));
430 }
431 
432 #define ROUTING_CONTEXT_LENGTH 4
433 
434 static void
dissect_routing_context_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)435 dissect_routing_context_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
436 {
437   guint16 number_of_contexts, context_number;
438   gint context_offset;
439 
440   number_of_contexts = (tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH) >> 2;
441   context_offset = PARAMETER_VALUE_OFFSET;
442   for(context_number=0; context_number < number_of_contexts; context_number++) {
443     proto_tree_add_item(parameter_tree, hf_routing_context, parameter_tvb, context_offset, ROUTING_CONTEXT_LENGTH, ENC_BIG_ENDIAN);
444     context_offset += ROUTING_CONTEXT_LENGTH;
445   };
446   proto_item_append_text(parameter_item, " (%u context%s)", number_of_contexts, plurality(number_of_contexts, "", "s"));
447 }
448 
449 #define DIAGNOSTIC_INFO_OFFSET PARAMETER_VALUE_OFFSET
450 
451 static void
dissect_diagnostic_information_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)452 dissect_diagnostic_information_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
453 {
454   guint16 diag_info_length;
455 
456   diag_info_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
457   proto_tree_add_item(parameter_tree, hf_diagnostic_information, parameter_tvb, DIAGNOSTIC_INFO_OFFSET, diag_info_length, ENC_NA);
458   proto_item_append_text(parameter_item, " (%u byte%s)", diag_info_length, plurality(diag_info_length, "", "s"));
459 }
460 
461 #define HEARTBEAT_DATA_OFFSET PARAMETER_VALUE_OFFSET
462 
463 static void
dissect_heartbeat_data_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)464 dissect_heartbeat_data_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
465 {
466   guint16 heartbeat_data_length;
467 
468   heartbeat_data_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
469   proto_tree_add_item(parameter_tree, hf_heartbeat_data, parameter_tvb, HEARTBEAT_DATA_OFFSET, heartbeat_data_length, ENC_NA);
470   proto_item_append_text(parameter_item, " (%u byte%s)", heartbeat_data_length, plurality(heartbeat_data_length, "", "s"));
471 }
472 
473 #define UNKNOWN_UNAVAIL_CAUSE                  0
474 #define UNEQUIPPED_REMOTE_USER_UNAVAIL_CAUSE   1
475 #define INACCESSIBLE_REMOTE_USER_UNAVAIL_CAUSE 2
476 
477 static const value_string unavailability_cause_values[] = {
478   { UNKNOWN_UNAVAIL_CAUSE,                  "Unknown"                  },
479   { UNEQUIPPED_REMOTE_USER_UNAVAIL_CAUSE,   "Unequipped remote user"   },
480   { INACCESSIBLE_REMOTE_USER_UNAVAIL_CAUSE, "Inaccessible remote user" },
481   {0,                                       NULL } };
482 
483 #define RESERVED_0_USER_ID                0
484 #define RESERVED_1_USER_ID                1
485 #define RESERVED_2_USER_ID                2
486 #define SCCP_USER_ID                      3
487 #define TUP_USER_ID                       4
488 #define ISUP_USER_ID                      5
489 #define RESERVED_6_USER_ID                6
490 #define RESERVED_7_USER_ID                7
491 #define RESERVED_8_USER_ID                8
492 #define BROADBAND_ISUP_USER_ID            9
493 #define SATELLITE_ISUP_USER_ID           10
494 #define RESERVED_11_USER_ID              11
495 #define AAL_2_SIGNALING_USER_ID          12
496 #define BICC_USER_ID                     13
497 #define GATEWAY_CONTROL_PROTOCOL_USER_ID 14
498 #define RESERVED_15_USER_ID              15
499 
500 static const value_string user_identity_values[] = {
501   { RESERVED_0_USER_ID,     "Reserved"       },
502   { RESERVED_1_USER_ID,     "Reserved"       },
503   { RESERVED_2_USER_ID,     "Reserved"       },
504   { SCCP_USER_ID,           "SCCP"           },
505   { TUP_USER_ID,            "TUP"            },
506   { ISUP_USER_ID,           "ISUP"           },
507   { RESERVED_6_USER_ID,     "Reserved"       },
508   { RESERVED_7_USER_ID,     "Reserved"       },
509   { RESERVED_8_USER_ID,     "Reserved"       },
510   { BROADBAND_ISUP_USER_ID, "Broadband ISUP" },
511   { SATELLITE_ISUP_USER_ID, "Satellite ISUP" },
512   { RESERVED_11_USER_ID,    "Reserved"       },
513   { AAL_2_SIGNALING_USER_ID,"AAL type2 Signaling"},
514   { BICC_USER_ID,           "Bearer Independent Call Control (BICC)"},
515   { GATEWAY_CONTROL_PROTOCOL_USER_ID, "Gateway Control Protocol"},
516   { RESERVED_15_USER_ID,    "Reserved"       },
517 
518   {0,                       NULL             } };
519 
520 #define CAUSE_LENGTH 2
521 #define USER_LENGTH  2
522 
523 #define CAUSE_OFFSET  PARAMETER_VALUE_OFFSET
524 #define USER_OFFSET   (CAUSE_OFFSET + CAUSE_LENGTH)
525 
526 static void
dissect_user_cause_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)527 dissect_user_cause_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
528 {
529   proto_tree_add_item(parameter_tree, hf_cause, parameter_tvb, CAUSE_OFFSET, CAUSE_LENGTH, ENC_BIG_ENDIAN);
530   proto_tree_add_item(parameter_tree, hf_user,  parameter_tvb, USER_OFFSET,  USER_LENGTH,  ENC_BIG_ENDIAN);
531   proto_item_append_text(parameter_item, " (%s: %s)",
532                          val_to_str_const(tvb_get_ntohs(parameter_tvb, USER_OFFSET),  user_identity_values,        "Unknown user"),
533                          val_to_str_const(tvb_get_ntohs(parameter_tvb, CAUSE_OFFSET), unavailability_cause_values, "unknown cause"));
534 }
535 
536 #define UNSPECIFIED_REASON          0
537 #define USER_UNAVAILABLE_REASON     1
538 #define MANAGEMENT_BLOCKING_REASON  2
539 
540 static const value_string reason_values[] = {
541   { UNSPECIFIED_REASON,         "Unspecified" },
542   { USER_UNAVAILABLE_REASON,    "User unavailable" },
543   { MANAGEMENT_BLOCKING_REASON, "Management blocking" },
544   {0,                           NULL } };
545 
546 #define REASON_LENGTH 4
547 #define REASON_OFFSET PARAMETER_VALUE_OFFSET
548 
549 static void
dissect_reason_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)550 dissect_reason_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
551 {
552   proto_tree_add_item(parameter_tree, hf_reason, parameter_tvb, REASON_OFFSET, REASON_LENGTH, ENC_BIG_ENDIAN);
553   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, REASON_OFFSET), reason_values, "unknown"));
554 }
555 
556 #define TRAFFIC_MODE_TYPE_LENGTH 4
557 #define TRAFFIC_MODE_TYPE_OFFSET PARAMETER_VALUE_OFFSET
558 
559 static const value_string v5_traffic_mode_type_values[] = {
560   { 1, "Over-ride"            },
561   { 2, "Load-share"           },
562   { 3, "Over-ride (standby)"  },
563   { 4, "Load-share (standby)" },
564   { 0, NULL                   } };
565 
566 static void
dissect_v5_traffic_mode_type_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)567 dissect_v5_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
568 {
569   proto_tree_add_item(parameter_tree, hf_v5_traffic_mode_type, parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH, ENC_BIG_ENDIAN);
570   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET), v5_traffic_mode_type_values, "unknown"));
571 }
572 
573 static const value_string v6_traffic_mode_type_values[] = {
574   { 1, "Over-ride"            },
575   { 2, "Load-share"           },
576   { 3, "Over-ride (standby)"  },
577   { 4, "Load-share (standby)" },
578   { 0, NULL                   } };
579 
580 static void
dissect_v6_traffic_mode_type_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)581 dissect_v6_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
582 {
583   proto_tree_add_item(parameter_tree, hf_v6_traffic_mode_type, parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH, ENC_BIG_ENDIAN);
584   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET), v6_traffic_mode_type_values, "unknown"));
585 }
586 
587 static const value_string v7_traffic_mode_type_values[] = {
588   { 1, "Over-ride"            },
589   { 2, "Load-share"           },
590   { 0, NULL                   } };
591 
592 static void
dissect_v7_traffic_mode_type_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)593 dissect_v7_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
594 {
595   proto_tree_add_item(parameter_tree, hf_v7_traffic_mode_type, parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH, ENC_BIG_ENDIAN);
596   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET), v7_traffic_mode_type_values, "unknown"));
597 }
598 
599 static const value_string traffic_mode_type_values[] = {
600   { 1, "Over-ride"  },
601   { 2, "Load-share" },
602   { 3, "Broadcast"  },
603   { 0, NULL         } };
604 
605 static void
dissect_traffic_mode_type_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)606 dissect_traffic_mode_type_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
607 {
608   proto_tree_add_item(parameter_tree, hf_traffic_mode_type, parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET, TRAFFIC_MODE_TYPE_LENGTH, ENC_BIG_ENDIAN);
609   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, TRAFFIC_MODE_TYPE_OFFSET), traffic_mode_type_values, "unknown"));
610 }
611 
612 #define ERROR_CODE_LENGTH 4
613 #define ERROR_CODE_OFFSET PARAMETER_VALUE_OFFSET
614 
615 static const value_string v5_error_code_values[] = {
616   {  1, "Invalid version"               },
617   {  2, "Invalid network appearance"    },
618   {  3, "Unsupported message class"     },
619   {  4, "Unsupported message type"      },
620   {  5, "Invalid traffic handling mode" },
621   {  6, "Unexpected message"            },
622   {  7, "Protocol error"                },
623   {  8, "Invalid routing context"       },
624   {  0,  NULL                           } };
625 
626 static void
dissect_v5_error_code_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)627 dissect_v5_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
628 {
629   proto_tree_add_item(parameter_tree, hf_v5_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, ENC_BIG_ENDIAN);
630   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET), v5_error_code_values, "unknown"));
631 }
632 
633 static const value_string v6_error_code_values[] = {
634   {  1, "Invalid version"               },
635   {  2, "Invalid network appearance"    },
636   {  3, "Unsupported message class"     },
637   {  4, "Unsupported message type"      },
638   {  5, "Invalid traffic handling mode" },
639   {  6, "Unexpected message"            },
640   {  7, "Protocol error"                },
641   {  8, "Invalid routing context"       },
642   {  9, "Invalid stream identifier"     },
643   { 10, "Invalid parameter value"       },
644   {  0,  NULL                           } };
645 
646 
647 static void
dissect_v6_error_code_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)648 dissect_v6_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
649 {
650   proto_tree_add_item(parameter_tree, hf_v6_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, ENC_BIG_ENDIAN);
651   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET), v6_error_code_values, "unknown"));
652 }
653 
654 static const value_string v7_error_code_values[] = {
655   {  1, "Invalid version"               },
656   {  2, "Invalid network appearance"    },
657   {  3, "Unsupported message class"     },
658   {  4, "Unsupported message type"      },
659   {  5, "Invalid traffic handling mode" },
660   {  6, "Unexpected message"            },
661   {  7, "Protocol error"                },
662   {  8, "Invalid routing context"       },
663   {  9, "Invalid stream identifier"     },
664   { 10, "Invalid parameter value"       },
665   { 11, "Refused - Management Blocking" },
666   { 12, "Unknown Routing Context"       },
667   {  0,  NULL                           } };
668 
669 
670 static void
dissect_v7_error_code_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)671 dissect_v7_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
672 {
673   proto_tree_add_item(parameter_tree, hf_v7_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, ENC_BIG_ENDIAN);
674   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET), v7_error_code_values, "unknown"));
675 }
676 
677 static const value_string error_code_values[] = {
678   { 0x01, "Invalid version"                   },
679   { 0x03, "Unsupported message class"         },
680   { 0x04, "Unsupported message type"          },
681   { 0x05, "Unsupported traffic handling mode" },
682   { 0x06, "Unexpected message"                },
683   { 0x07, "Protocol error"                    },
684   { 0x09, "Invalid stream identifier"         },
685   { 0x0d, "Refused - management blocking"     },
686   { 0x0e, "ASP identifier required"           },
687   { 0x0f, "Invalid ASP identifier"            },
688   { 0x11, "Invalid parameter value"           },
689   { 0x12, "Parameter field error"             },
690   { 0x13, "Unexpected parameter"              },
691   { 0x14, "Destination status unknown"        },
692   { 0x15, "Invalid network appearance"        },
693   { 0x16, "Missing parameter"                 },
694   { 0x19, "Invalid routing context"           },
695   { 0x1a, "No configured AS for ASP"          },
696   { 0,    NULL                                } };
697 
698 static void
dissect_error_code_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)699 dissect_error_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
700 {
701   proto_tree_add_item(parameter_tree, hf_error_code, parameter_tvb, ERROR_CODE_OFFSET, ERROR_CODE_LENGTH, ENC_BIG_ENDIAN);
702   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, ERROR_CODE_OFFSET), error_code_values, "unknown"));
703 }
704 
705 #define AS_STATE_CHANGE_TYPE       1
706 #define OTHER_TYPE                 2
707 
708 static const value_string status_type_values[] = {
709   { AS_STATE_CHANGE_TYPE,            "Application server state change" },
710   { OTHER_TYPE,                      "Other" },
711   { 0,                           NULL } };
712 
713 #define RESERVED_INFO              1
714 #define AS_INACTIVE_INFO           2
715 #define AS_ACTIVE_INFO             3
716 #define AS_PENDING_INFO            4
717 
718 #define INSUFFICIENT_ASP_RES_INFO  1
719 #define ALTERNATE_ASP_ACTIVE_INFO  2
720 #define ASP_FAILURE_INFO           3
721 
722 static const value_string v567_status_type_info_values[] = {
723   { AS_STATE_CHANGE_TYPE * 256 * 256 + RESERVED_INFO,             "Reserved" },
724   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_INACTIVE_INFO,          "Application server inactive" },
725   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_ACTIVE_INFO,            "Application server active" },
726   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_PENDING_INFO,           "Application server pending" },
727   { OTHER_TYPE           * 256 * 256 + INSUFFICIENT_ASP_RES_INFO, "Insufficient ASP resources active in AS" },
728   { OTHER_TYPE           * 256 * 256 + ALTERNATE_ASP_ACTIVE_INFO, "Alternate ASP active" },
729   {0,                           NULL } };
730 
731 
732 #define STATUS_TYPE_LENGTH 2
733 #define STATUS_INFO_LENGTH 2
734 
735 #define STATUS_TYPE_OFFSET PARAMETER_VALUE_OFFSET
736 #define STATUS_INFO_OFFSET (STATUS_TYPE_OFFSET + STATUS_TYPE_LENGTH)
737 
738 static void
dissect_v567_status_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)739 dissect_v567_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
740 {
741   guint16 status_type, status_info;
742 
743   status_type = tvb_get_ntohs(parameter_tvb, STATUS_TYPE_OFFSET);
744   status_info = tvb_get_ntohs(parameter_tvb, STATUS_INFO_OFFSET);
745 
746   proto_tree_add_item(parameter_tree, hf_status_type, parameter_tvb, STATUS_TYPE_OFFSET, STATUS_TYPE_LENGTH, ENC_BIG_ENDIAN);
747   proto_tree_add_uint_format_value(parameter_tree, hf_status_info, parameter_tvb, STATUS_INFO_OFFSET, STATUS_INFO_LENGTH, status_info,
748                              "%s (%u)", val_to_str_const(status_type * 256 * 256 + status_info, v567_status_type_info_values, "unknown"), status_info);
749 
750   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(status_type * 256 * 256 + status_info, v567_status_type_info_values, "unknown status information"));
751 }
752 
753 static const value_string status_type_info_values[] = {
754   { AS_STATE_CHANGE_TYPE * 256 * 256 + RESERVED_INFO,             "Reserved" },
755   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_INACTIVE_INFO,          "Application server inactive" },
756   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_ACTIVE_INFO,            "Application server active" },
757   { AS_STATE_CHANGE_TYPE * 256 * 256 + AS_PENDING_INFO,           "Application server pending" },
758   { OTHER_TYPE           * 256 * 256 + INSUFFICIENT_ASP_RES_INFO, "Insufficient ASP resources active in AS" },
759   { OTHER_TYPE           * 256 * 256 + ALTERNATE_ASP_ACTIVE_INFO, "Alternate ASP active" },
760   { OTHER_TYPE           * 256 * 256 + ASP_FAILURE_INFO,          "ASP Failure" },
761   {0,                           NULL } };
762 
763 static void
dissect_status_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)764 dissect_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
765 {
766   guint16 status_type, status_info;
767 
768   status_type = tvb_get_ntohs(parameter_tvb, STATUS_TYPE_OFFSET);
769   status_info = tvb_get_ntohs(parameter_tvb, STATUS_INFO_OFFSET);
770 
771   proto_tree_add_item(parameter_tree, hf_status_type, parameter_tvb, STATUS_TYPE_OFFSET, STATUS_TYPE_LENGTH, ENC_BIG_ENDIAN);
772   proto_tree_add_uint_format_value(parameter_tree, hf_status_info, parameter_tvb, STATUS_INFO_OFFSET, STATUS_INFO_LENGTH, status_info,
773                              "%s (%u)", val_to_str_const(status_type * 256 * 256 + status_info, status_type_info_values, "unknown"), status_info);
774 
775   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(status_type * 256 * 256 + status_info, status_type_info_values, "unknown status information"));
776 }
777 
778 static const value_string congestion_level_values[] = {
779   { 0, "No congestion or undefined" },
780   { 1, "Congestion level 1"         },
781   { 2, "Congestion level 2"         },
782   { 3, "Congestion level 3"         },
783   { 0, NULL                         } };
784 
785 #define CONG_IND_RESERVED_LENGTH    3
786 #define CONG_IND_LEVEL_LENGTH       1
787 
788 #define CONG_IND_RESERVED_OFFSET     PARAMETER_VALUE_OFFSET
789 #define CONG_IND_LEVEL_OFFSET        (CONG_IND_RESERVED_OFFSET + CONG_IND_RESERVED_LENGTH)
790 
791 static void
dissect_congestion_indication_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)792 dissect_congestion_indication_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
793 {
794   proto_tree_add_item(parameter_tree, hf_congestion_reserved, parameter_tvb, CONG_IND_RESERVED_OFFSET, CONG_IND_RESERVED_LENGTH, ENC_NA);
795   proto_tree_add_item(parameter_tree, hf_congestion_level,    parameter_tvb, CONG_IND_LEVEL_OFFSET,    CONG_IND_LEVEL_LENGTH,    ENC_BIG_ENDIAN);
796   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_guint8(parameter_tvb, CONG_IND_LEVEL_OFFSET), congestion_level_values, "unknown"));
797 }
798 
799 #define ASP_IDENTIFIER_OFFSET PARAMETER_VALUE_OFFSET
800 #define ASP_IDENTIFIER_LENGTH  4
801 
802 static void
dissect_asp_identifier_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)803 dissect_asp_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
804 {
805   proto_tree_add_item(parameter_tree, hf_asp_identifier, parameter_tvb, ASP_IDENTIFIER_OFFSET, ASP_IDENTIFIER_LENGTH, ENC_BIG_ENDIAN);
806   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohl(parameter_tvb, ASP_IDENTIFIER_OFFSET));
807 }
808 
809 #define PROTOCOL_DATA_1_OFFSET PARAMETER_VALUE_OFFSET
810 
811 static void
dissect_protocol_data_1_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_item * parameter_item)812 dissect_protocol_data_1_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_item *parameter_item)
813 {
814   guint16 protocol_data_length;
815   tvbuff_t *payload_tvb;
816 
817   protocol_data_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
818   payload_tvb          = tvb_new_subset_length(parameter_tvb, PROTOCOL_DATA_1_OFFSET, protocol_data_length);
819   proto_item_append_text(parameter_item, " (SS7 message of %u byte%s)", protocol_data_length, plurality(protocol_data_length, "", "s"));
820   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH);
821   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
822 }
823 
824 #define LI_OCTETT_LENGTH 1
825 #define LI_OCTETT_OFFSET PARAMETER_VALUE_OFFSET
826 #define PROTOCOL_DATA_2_OFFSET (PARAMETER_VALUE_OFFSET + LI_OCTETT_LENGTH)
827 
828 static void
dissect_protocol_data_2_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * parameter_tree,proto_item * parameter_item)829 dissect_protocol_data_2_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
830 {
831   guint16 protocol_data_length;
832   tvbuff_t *payload_tvb;
833 
834   protocol_data_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH - LI_OCTETT_LENGTH;
835   payload_tvb          = tvb_new_subset_length(parameter_tvb, PROTOCOL_DATA_2_OFFSET, protocol_data_length);
836   proto_tree_add_item(parameter_tree, hf_li, parameter_tvb, LI_OCTETT_OFFSET, LI_OCTETT_LENGTH, ENC_BIG_ENDIAN);
837   proto_item_append_text(parameter_item, " (SS7 message of %u byte%s)", protocol_data_length, plurality(protocol_data_length, "", "s"));
838   proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH + LI_OCTETT_LENGTH);
839   call_dissector(mtp3_handle, payload_tvb, pinfo, tree);
840 }
841 
842 
843 
844 #define CON_DEST_RESERVED_LENGTH    1
845 #define CON_DEST_PC_LENGTH          3
846 
847 #define CON_DEST_RESERVED_OFFSET    PARAMETER_VALUE_OFFSET
848 #define CON_DEST_PC_OFFSET          (CON_DEST_RESERVED_OFFSET + CON_DEST_RESERVED_LENGTH)
849 
850 static void
dissect_concerned_destination_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)851 dissect_concerned_destination_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
852 {
853   proto_item *item;
854 
855   proto_tree_add_item(parameter_tree, hf_concerned_dest_reserved, parameter_tvb, CON_DEST_RESERVED_OFFSET, CON_DEST_RESERVED_LENGTH, ENC_NA);
856   item = proto_tree_add_item(parameter_tree, hf_concerned_dest_pc,       parameter_tvb, CON_DEST_PC_OFFSET,       CON_DEST_PC_LENGTH,       ENC_BIG_ENDIAN);
857   if (mtp3_pc_structured())
858     proto_item_append_text(item, " (%s)", mtp3_pc_to_str(tvb_get_ntoh24(parameter_tvb, CON_DEST_PC_OFFSET)));
859   proto_item_append_text(parameter_item, " (%s)", mtp3_pc_to_str(tvb_get_ntoh24(parameter_tvb, CON_DEST_PC_OFFSET)));
860 }
861 
862 static void
dissect_routing_key_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * parameter_tree)863 dissect_routing_key_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree)
864 {
865   tvbuff_t *parameters_tvb;
866   guint16 length, parameters_length;
867 
868   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
869   parameters_length = length - PARAMETER_HEADER_LENGTH;
870   parameters_tvb          = tvb_new_subset_length(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length);
871   dissect_parameters(parameters_tvb, pinfo, tree, parameter_tree);
872 }
873 
874 static const value_string registration_result_status_values[] = {
875   { 0, "Successfully Registered" } ,
876   { 1, "Error - Unknown" } ,
877   { 2, "Error - Invalid DPC" } ,
878   { 3, "Error - Invalid Network Appearance" } ,
879   { 4, "Error - Invalid Routing Key" } ,
880   { 5, "Error - Permission Denied" } ,
881   { 6, "Error - Overlapping (Non-unique) Routing Key" } ,
882   { 7, "Error - Routing Key not Provisioned" } ,
883   { 8, "Error - Insufficient Resources" } ,
884   { 0, NULL } };
885 
886 #define REG_RES_IDENTIFIER_LENGTH 4
887 #define REG_RES_STATUS_LENGTH     4
888 #define REG_RES_CONTEXT_LENGTH    4
889 
890 #define REG_RES_IDENTIFIER_OFFSET PARAMETER_VALUE_OFFSET
891 #define REG_RES_STATUS_OFFSET     (REG_RES_IDENTIFIER_OFFSET + REG_RES_IDENTIFIER_LENGTH)
892 #define REG_RES_CONTEXT_OFFSET    (REG_RES_STATUS_OFFSET + REG_RES_STATUS_LENGTH)
893 
894 static void
dissect_v67_registration_result_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree)895 dissect_v67_registration_result_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree)
896 {
897   proto_tree_add_item(parameter_tree, hf_registration_result_identifier, parameter_tvb, REG_RES_IDENTIFIER_OFFSET, REG_RES_IDENTIFIER_LENGTH, ENC_BIG_ENDIAN);
898   proto_tree_add_item(parameter_tree, hf_registration_result_status,     parameter_tvb, REG_RES_STATUS_OFFSET,     REG_RES_STATUS_LENGTH,     ENC_BIG_ENDIAN);
899   proto_tree_add_item(parameter_tree, hf_registration_result_context,    parameter_tvb, REG_RES_CONTEXT_OFFSET,    REG_RES_CONTEXT_LENGTH,    ENC_BIG_ENDIAN);
900 }
901 
902 static void
dissect_registration_result_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * parameter_tree)903 dissect_registration_result_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree)
904 {
905   tvbuff_t *parameters_tvb;
906   guint16 length, parameters_length;
907 
908   length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
909   parameters_length = length - PARAMETER_HEADER_LENGTH;
910   parameters_tvb          = tvb_new_subset_length(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length);
911   dissect_parameters(parameters_tvb, pinfo, tree, parameter_tree);
912 }
913 
914 static const value_string v6_deregistration_result_status_values[] = {
915   { 0, "Successfully De-registered" } ,
916   { 1, "Error - Unknown" } ,
917   { 2, "Error - Invalid Routing context" } ,
918   { 3, "Error - Permission Denied" } ,
919   { 4, "Error - Not registered" } ,
920   { 0, NULL } };
921 
922 #define DEREG_RES_CONTEXT_LENGTH 4
923 #define DEREG_RES_STATUS_LENGTH  4
924 
925 #define DEREG_RES_CONTEXT_OFFSET PARAMETER_VALUE_OFFSET
926 #define DEREG_RES_STATUS_OFFSET  (DEREG_RES_CONTEXT_OFFSET + DEREG_RES_CONTEXT_LENGTH)
927 
928 static void
dissect_v67_deregistration_result_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree)929 dissect_v67_deregistration_result_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree)
930 {
931   proto_tree_add_item(parameter_tree, hf_v6_deregistration_result_context, parameter_tvb, DEREG_RES_CONTEXT_OFFSET, DEREG_RES_CONTEXT_LENGTH, ENC_BIG_ENDIAN);
932   proto_tree_add_item(parameter_tree, hf_v6_deregistration_result_status,  parameter_tvb, DEREG_RES_STATUS_OFFSET,  DEREG_RES_STATUS_LENGTH,  ENC_BIG_ENDIAN);
933 }
934 
935 static void
dissect_deregistration_result_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * parameter_tree)936 dissect_deregistration_result_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree)
937 {
938   tvbuff_t *parameters_tvb;
939   guint16 length, parameters_length;
940 
941   length            = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
942   parameters_length = length - PARAMETER_HEADER_LENGTH;
943   parameters_tvb    = tvb_new_subset_length(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length);
944   dissect_parameters(parameters_tvb, pinfo, tree, parameter_tree);
945 }
946 
947 
948 #define LOCAL_RK_IDENTIFIER_OFFSET PARAMETER_VALUE_OFFSET
949 #define LOCAL_RK_IDENTIFIER_LENGTH 4
950 
951 static void
dissect_local_routing_key_identifier_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)952 dissect_local_routing_key_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
953 {
954   proto_tree_add_item(parameter_tree, hf_local_rk_identifier, parameter_tvb, LOCAL_RK_IDENTIFIER_OFFSET, LOCAL_RK_IDENTIFIER_LENGTH, ENC_BIG_ENDIAN);
955   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohl(parameter_tvb, LOCAL_RK_IDENTIFIER_OFFSET));
956 }
957 
958 #define DPC_MASK_LENGTH    1
959 #define DPC_PC_LENGTH      3
960 
961 #define DPC_MASK_OFFSET    PARAMETER_VALUE_OFFSET
962 #define DPC_PC_OFFSET      (DPC_MASK_OFFSET + DPC_MASK_LENGTH)
963 
964 static void
dissect_destination_point_code_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)965 dissect_destination_point_code_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
966 {
967   proto_item *item;
968 
969   proto_tree_add_item(parameter_tree, hf_dpc_mask, parameter_tvb, DPC_MASK_OFFSET, DPC_MASK_LENGTH, ENC_BIG_ENDIAN);
970   item = proto_tree_add_item(parameter_tree, hf_dpc_pc,   parameter_tvb, DPC_PC_OFFSET,   DPC_PC_LENGTH,   ENC_BIG_ENDIAN);
971   if (mtp3_pc_structured())
972     proto_item_append_text(item, " (%s)", mtp3_pc_to_str(tvb_get_ntoh24(parameter_tvb, DPC_PC_OFFSET)));
973   proto_item_append_text(parameter_item, " (%s)", mtp3_pc_to_str(tvb_get_ntoh24(parameter_tvb, DPC_PC_OFFSET)));
974 }
975 
976 #define SI_LENGTH 1
977 
978 static void
dissect_service_indicators_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)979 dissect_service_indicators_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
980 {
981   guint16 length, number_of_sis, si_number;
982   gint si_offset;
983 
984   length        = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
985   number_of_sis = length - PARAMETER_HEADER_LENGTH;
986 
987   si_offset = PARAMETER_VALUE_OFFSET;
988   for(si_number=0; si_number < number_of_sis; si_number++) {
989     proto_tree_add_item(parameter_tree, hf_si, parameter_tvb, si_offset, SI_LENGTH, ENC_BIG_ENDIAN);
990     si_offset += SI_LENGTH;
991   };
992   proto_item_append_text(parameter_item, " (%u indicator%s)", number_of_sis, plurality(number_of_sis, "", "s"));
993 
994 }
995 #define SSN_LENGTH 1
996 
997 static void
dissect_subsystem_numbers_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)998 dissect_subsystem_numbers_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
999 {
1000   guint16 length, number_of_ssns, ssn_number;
1001   gint ssn_offset;
1002 
1003   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1004   number_of_ssns = length - PARAMETER_HEADER_LENGTH;
1005 
1006   ssn_offset = PARAMETER_VALUE_OFFSET;
1007   for(ssn_number=0; ssn_number < number_of_ssns; ssn_number++) {
1008     proto_tree_add_item(parameter_tree, hf_ssn, parameter_tvb, ssn_offset, SSN_LENGTH, ENC_BIG_ENDIAN);
1009     ssn_offset += SSN_LENGTH;
1010   };
1011   proto_item_append_text(parameter_item, " (%u number%s)", number_of_ssns, plurality(number_of_ssns, "", "s"));
1012 
1013 }
1014 
1015 #define OPC_MASK_LENGTH             1
1016 #define OPC_PC_LENGTH               3
1017 #define OPC_LENGTH                  (OPC_MASK_LENGTH + OPC_PC_LENGTH)
1018 #define OPC_MASK_OFFSET             0
1019 #define OPC_PC_OFFSET               (OPC_MASK_OFFSET + OPC_MASK_LENGTH)
1020 
1021 static void
dissect_originating_point_code_list_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)1022 dissect_originating_point_code_list_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1023 {
1024   guint16 length, number_of_point_codes, point_code_number;
1025   gint point_code_offset;
1026   proto_item *item;
1027 
1028   length                = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1029   number_of_point_codes = (length - PARAMETER_HEADER_LENGTH) / 4;
1030 
1031   point_code_offset = PARAMETER_VALUE_OFFSET;
1032   for(point_code_number=0; point_code_number < number_of_point_codes; point_code_number++) {
1033     proto_tree_add_item(parameter_tree, hf_opc_list_mask, parameter_tvb, point_code_offset + OPC_MASK_OFFSET, OPC_MASK_LENGTH, ENC_BIG_ENDIAN);
1034     item = proto_tree_add_item(parameter_tree, hf_opc_list_pc,   parameter_tvb, point_code_offset + OPC_PC_OFFSET,   OPC_PC_LENGTH,   ENC_BIG_ENDIAN);
1035     if (mtp3_pc_structured())
1036       proto_item_append_text(item, " (%s)", mtp3_pc_to_str(tvb_get_ntoh24(parameter_tvb, point_code_offset + OPC_PC_OFFSET)));
1037     point_code_offset += OPC_LENGTH;
1038   };
1039   proto_item_append_text(parameter_item, " (%u point code%s)", number_of_point_codes, plurality(number_of_point_codes, "", "s"));
1040 }
1041 
1042 #define CIC_RANGE_MASK_LENGTH             1
1043 #define CIC_RANGE_PC_LENGTH               3
1044 #define CIC_RANGE_LOWER_LENGTH            2
1045 #define CIC_RANGE_UPPER_LENGTH            2
1046 #define CIC_RANGE_LENGTH                  (CIC_RANGE_MASK_LENGTH + CIC_RANGE_PC_LENGTH + CIC_RANGE_LOWER_LENGTH + CIC_RANGE_UPPER_LENGTH)
1047 #define CIC_RANGE_MASK_OFFSET             0
1048 #define CIC_RANGE_PC_OFFSET               (CIC_RANGE_MASK_OFFSET + CIC_RANGE_MASK_LENGTH)
1049 #define CIC_RANGE_LOWER_OFFSET            (CIC_RANGE_PC_OFFSET + CIC_RANGE_PC_LENGTH)
1050 #define CIC_RANGE_UPPER_OFFSET            (CIC_RANGE_LOWER_OFFSET + CIC_RANGE_LOWER_LENGTH)
1051 
1052 static void
dissect_circuit_range_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)1053 dissect_circuit_range_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1054 {
1055   guint16 length, number_of_point_codes, point_code_number, cic_low, cic_high;
1056   guint32 pc;
1057   gint point_code_offset;
1058   proto_item *pc_item, *cic_range_item;
1059   proto_tree *cic_range_tree;
1060   gchar *pc_string;
1061 
1062   length                = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1063   number_of_point_codes = (length - PARAMETER_HEADER_LENGTH) / CIC_RANGE_LENGTH;
1064 
1065   point_code_offset = PARAMETER_VALUE_OFFSET;
1066   for(point_code_number = 0; point_code_number < number_of_point_codes; point_code_number++) {
1067     cic_range_tree = proto_tree_add_subtree(parameter_tree, parameter_tvb, point_code_offset + CIC_RANGE_MASK_OFFSET, CIC_RANGE_LENGTH, ett_parameter, &cic_range_item, "CIC range");
1068 
1069     proto_tree_add_item(cic_range_tree, hf_cic_range_mask,  parameter_tvb, point_code_offset + CIC_RANGE_MASK_OFFSET,  CIC_RANGE_MASK_LENGTH,  ENC_BIG_ENDIAN);
1070 
1071     pc = tvb_get_ntoh24(parameter_tvb, point_code_offset + CIC_RANGE_PC_OFFSET);
1072     pc_string = mtp3_pc_to_str(pc);
1073     pc_item = proto_tree_add_item(cic_range_tree, hf_cic_range_pc,    parameter_tvb, point_code_offset + CIC_RANGE_PC_OFFSET,    CIC_RANGE_PC_LENGTH,    ENC_BIG_ENDIAN);
1074     if (mtp3_pc_structured())
1075       proto_item_append_text(pc_item, " (%s)", pc_string);
1076 
1077     cic_low = tvb_get_ntohs(parameter_tvb, point_code_offset + CIC_RANGE_LOWER_OFFSET);
1078     proto_tree_add_item(cic_range_tree, hf_cic_range_lower, parameter_tvb, point_code_offset + CIC_RANGE_LOWER_OFFSET, CIC_RANGE_LOWER_LENGTH, ENC_BIG_ENDIAN);
1079     cic_high = tvb_get_ntohs(parameter_tvb, point_code_offset + CIC_RANGE_UPPER_OFFSET);
1080     proto_tree_add_item(cic_range_tree, hf_cic_range_upper, parameter_tvb, point_code_offset + CIC_RANGE_UPPER_OFFSET, CIC_RANGE_UPPER_LENGTH, ENC_BIG_ENDIAN);
1081 
1082     proto_item_append_text(cic_range_item, " (%s: %d-%d)", pc_string, cic_low, cic_high);
1083     point_code_offset += CIC_RANGE_LENGTH;
1084   };
1085   proto_item_append_text(parameter_item, " (%u range%s)", number_of_point_codes, plurality(number_of_point_codes, "", "s"));
1086 }
1087 
1088 #define DATA_OPC_LENGTH   4
1089 #define DATA_DPC_LENGTH   4
1090 #define DATA_SI_LENGTH    1
1091 #define DATA_NI_LENGTH    1
1092 #define DATA_MP_LENGTH    1
1093 #define DATA_SLS_LENGTH   1
1094 #define DATA_HDR_LENGTH   (DATA_OPC_LENGTH + DATA_DPC_LENGTH + DATA_SI_LENGTH + DATA_NI_LENGTH + DATA_MP_LENGTH + DATA_SLS_LENGTH)
1095 
1096 #define DATA_OPC_OFFSET   PARAMETER_VALUE_OFFSET
1097 #define DATA_DPC_OFFSET   (DATA_OPC_OFFSET + DATA_OPC_LENGTH)
1098 #define DATA_SI_OFFSET    (DATA_DPC_OFFSET + DATA_DPC_LENGTH)
1099 #define DATA_NI_OFFSET    (DATA_SI_OFFSET  + DATA_SI_LENGTH)
1100 #define DATA_MP_OFFSET    (DATA_NI_OFFSET  + DATA_NI_LENGTH)
1101 #define DATA_SLS_OFFSET   (DATA_MP_OFFSET  + DATA_MP_LENGTH)
1102 #define DATA_ULP_OFFSET   (DATA_SLS_OFFSET + DATA_SLS_LENGTH)
1103 
1104 static guint
m3ua_heur_mtp3_standard(tvbuff_t * tvb,packet_info * pinfo,guint32 opc,guint32 dpc,guint8 si)1105 m3ua_heur_mtp3_standard(tvbuff_t *tvb, packet_info *pinfo, guint32 opc, guint32 dpc, guint8 si)
1106 {
1107   switch (si) {
1108   case MTP_SI_SCCP:
1109   {
1110     if (opc < ITU_PC_MASK && dpc < ITU_PC_MASK &&
1111         looks_like_valid_sccp(pinfo->num, tvb, ITU_STANDARD)) {
1112 
1113       return ITU_STANDARD;
1114     }
1115     /* Network 0 is reserved in ANSI */
1116     /* Could also check that cluster!=0 for small networks (networks 1-5) */
1117     if ((opc & ANSI_NETWORK_MASK) > 0 && (dpc & ANSI_NETWORK_MASK) > 0 &&
1118         looks_like_valid_sccp(pinfo->num, tvb, ANSI_STANDARD)) {
1119 
1120       return ANSI_STANDARD;
1121     }
1122     if (looks_like_valid_sccp(pinfo->num, tvb, CHINESE_ITU_STANDARD)) {
1123       return CHINESE_ITU_STANDARD;
1124     }
1125     if (opc < JAPAN_PC_MASK && dpc < JAPAN_PC_MASK &&
1126         looks_like_valid_sccp(pinfo->num, tvb, JAPAN_STANDARD)) {
1127 
1128       return JAPAN_STANDARD;
1129     }
1130 
1131     return HEURISTIC_FAILED_STANDARD;
1132 
1133   }
1134   default:
1135     return HEURISTIC_FAILED_STANDARD;
1136   }
1137 }
1138 
1139 static void
m3ua_reset_mtp3_standard(void)1140 m3ua_reset_mtp3_standard(void)
1141 {
1142   mtp3_standard = m3ua_pref_mtp3_standard;
1143 }
1144 
1145 static void
dissect_protocol_data_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * parameter_tree,proto_item * parameter_item)1146 dissect_protocol_data_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree, proto_item *parameter_item)
1147 {
1148   guint16 ulp_length;
1149   tvbuff_t *payload_tvb;
1150   proto_item *item, *gen_item;
1151   mtp3_tap_rec_t* mtp3_tap;
1152   proto_tree *q708_tree;
1153   gint heuristic_standard;
1154   guint8 si;
1155   guint32 opc, dpc;
1156 
1157   mtp3_tap = wmem_new0(pinfo->pool, mtp3_tap_rec_t);
1158 
1159   si = tvb_get_guint8(parameter_tvb, DATA_SI_OFFSET);
1160   ulp_length  = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH - DATA_HDR_LENGTH;
1161   payload_tvb = tvb_new_subset_length(parameter_tvb, DATA_ULP_OFFSET, ulp_length);
1162   dpc = tvb_get_ntohl(parameter_tvb, DATA_DPC_OFFSET);
1163   opc = tvb_get_ntohl(parameter_tvb, DATA_OPC_OFFSET);
1164 
1165   m3ua_pref_mtp3_standard = mtp3_standard;
1166 
1167   if (mtp3_heuristic_standard) {
1168     heuristic_standard = m3ua_heur_mtp3_standard(payload_tvb, pinfo, opc, dpc, si);
1169     if (heuristic_standard == HEURISTIC_FAILED_STANDARD) {
1170       gen_item = proto_tree_add_uint_format(tree, hf_heuristic_standard, parameter_tvb, 0, 0, heuristic_standard,
1171         "Could not determine Heuristic using %s", val_to_str_const(mtp3_standard, mtp3_standard_vals, "unknown"));
1172     } else {
1173       gen_item = proto_tree_add_uint_format(tree, hf_heuristic_standard, parameter_tvb, 0, 0, heuristic_standard,
1174         "%s", val_to_str_const(heuristic_standard, mtp3_standard_vals, "unknown"));
1175 
1176       mtp3_standard = heuristic_standard;
1177 
1178       /* Register a frame-end routine to ensure mtp3_standard is set
1179        * back even if an exception is thrown.
1180        */
1181       register_frame_end_routine(pinfo, m3ua_reset_mtp3_standard);
1182     }
1183     proto_item_set_generated(gen_item);
1184   }
1185 
1186   mtp3_tap->addr_dpc.type = (Standard_Type)mtp3_standard;
1187   mtp3_tap->addr_dpc.pc = dpc;
1188   mtp3_tap->addr_dpc.ni = tvb_get_guint8(parameter_tvb, DATA_NI_OFFSET);
1189   set_address(&pinfo->dst, ss7pc_address_type, sizeof(mtp3_addr_pc_t), (guint8 *) &mtp3_tap->addr_dpc);
1190 
1191 
1192   mtp3_tap->addr_opc.type = (Standard_Type)mtp3_standard;
1193   mtp3_tap->addr_opc.pc = opc;
1194   mtp3_tap->addr_opc.ni = tvb_get_guint8(parameter_tvb, DATA_NI_OFFSET);
1195   set_address(&pinfo->src, ss7pc_address_type, sizeof(mtp3_addr_pc_t), (guint8 *) &mtp3_tap->addr_opc);
1196 
1197   mtp3_tap->mtp3_si_code = tvb_get_guint8(parameter_tvb, DATA_SI_OFFSET);
1198   mtp3_tap->size = 0;
1199 
1200   tap_queue_packet(m3ua_tap, pinfo, mtp3_tap);
1201 
1202   ulp_length  = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH - DATA_HDR_LENGTH;
1203 
1204   if (parameter_tree) {
1205     item = proto_tree_add_item(parameter_tree, hf_protocol_data_opc, parameter_tvb, DATA_OPC_OFFSET, DATA_OPC_LENGTH, ENC_BIG_ENDIAN);
1206     if (mtp3_pc_structured())
1207       proto_item_append_text(item, " (%s)", mtp3_pc_to_str(opc));
1208     if(mtp3_tap->addr_opc.ni == MTP3_NI_INT0) {
1209         q708_tree = proto_item_add_subtree(item,ett_q708_opc);
1210         /*  Q.708 (1984-10)  Numbering of International Signalling Point Codes  */
1211         analyze_q708_ispc(parameter_tvb, q708_tree, DATA_OPC_OFFSET, DATA_OPC_LENGTH, opc);
1212     }
1213 
1214     item = proto_tree_add_item(parameter_tree, hf_protocol_data_dpc, parameter_tvb, DATA_DPC_OFFSET, DATA_DPC_LENGTH, ENC_BIG_ENDIAN);
1215     if (mtp3_pc_structured())
1216       proto_item_append_text(item, " (%s)", mtp3_pc_to_str(dpc));
1217     if(mtp3_tap->addr_dpc.ni == MTP3_NI_INT0) {
1218         q708_tree = proto_item_add_subtree(item,ett_q708_dpc);
1219         analyze_q708_ispc(parameter_tvb, q708_tree, DATA_DPC_OFFSET, DATA_DPC_LENGTH, dpc);
1220     }
1221 
1222     proto_tree_add_item(parameter_tree, hf_protocol_data_si,  parameter_tvb, DATA_SI_OFFSET,  DATA_SI_LENGTH,  ENC_BIG_ENDIAN);
1223     proto_tree_add_item(parameter_tree, hf_protocol_data_ni,  parameter_tvb, DATA_NI_OFFSET,  DATA_NI_LENGTH,  ENC_BIG_ENDIAN);
1224     proto_tree_add_item(parameter_tree, hf_protocol_data_mp,  parameter_tvb, DATA_MP_OFFSET,  DATA_MP_LENGTH,  ENC_BIG_ENDIAN);
1225     proto_tree_add_item(parameter_tree, hf_protocol_data_sls, parameter_tvb, DATA_SLS_OFFSET, DATA_SLS_LENGTH, ENC_BIG_ENDIAN);
1226 
1227     proto_item_append_text(parameter_item, " (SS7 message of %u byte%s)", ulp_length, plurality(ulp_length, "", "s"));
1228     proto_item_set_len(parameter_item, PARAMETER_HEADER_LENGTH + DATA_HDR_LENGTH);
1229 
1230     parameter_tree = proto_tree_add_subtree(parameter_tree,parameter_tvb,0,0,ett_mtp3_equiv,&item,"MTP3 equivalents");
1231     proto_item_set_generated(item);
1232 
1233     item = proto_tree_add_item(parameter_tree, hf_protocol_data_mtp3_opc, parameter_tvb, DATA_OPC_OFFSET, DATA_OPC_LENGTH, ENC_BIG_ENDIAN);
1234     proto_item_set_generated(item);
1235     item = proto_tree_add_item(parameter_tree, hf_protocol_data_mtp3_dpc, parameter_tvb, DATA_DPC_OFFSET, DATA_OPC_LENGTH, ENC_BIG_ENDIAN);
1236     proto_item_set_generated(item);
1237     item = proto_tree_add_item(parameter_tree, hf_protocol_data_mtp3_pc, parameter_tvb, DATA_OPC_OFFSET, DATA_OPC_LENGTH, ENC_BIG_ENDIAN);
1238     proto_item_set_generated(item);
1239     item = proto_tree_add_item(parameter_tree, hf_protocol_data_mtp3_pc, parameter_tvb, DATA_DPC_OFFSET, DATA_OPC_LENGTH, ENC_BIG_ENDIAN);
1240     proto_item_set_generated(item);
1241     item = proto_tree_add_item(parameter_tree, hf_protocol_data_mtp3_ni,  parameter_tvb, DATA_NI_OFFSET,  DATA_NI_LENGTH,  ENC_BIG_ENDIAN);
1242     proto_item_set_generated(item);
1243     item = proto_tree_add_item(parameter_tree, hf_protocol_data_mtp3_sls, parameter_tvb, DATA_SLS_OFFSET, DATA_SLS_LENGTH, ENC_BIG_ENDIAN);
1244     proto_item_set_generated(item);
1245 
1246   }/* parameter_tree */
1247 
1248   payload_tvb = tvb_new_subset_length(parameter_tvb, DATA_ULP_OFFSET, ulp_length);
1249   if (!dissector_try_uint(si_dissector_table, tvb_get_guint8(parameter_tvb, DATA_SI_OFFSET), payload_tvb, pinfo, tree))
1250     call_data_dissector(payload_tvb, pinfo, tree);
1251 
1252   mtp3_standard = m3ua_pref_mtp3_standard;
1253 }
1254 
1255 #define CORR_ID_OFFSET PARAMETER_VALUE_OFFSET
1256 #define CORR_ID_LENGTH 4
1257 
1258 static void
dissect_correlation_identifier_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)1259 dissect_correlation_identifier_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1260 {
1261   proto_tree_add_item(parameter_tree, hf_correlation_identifier, parameter_tvb, CORR_ID_OFFSET, CORR_ID_LENGTH, ENC_BIG_ENDIAN);
1262   proto_item_append_text(parameter_item, " (%u)", tvb_get_ntohl(parameter_tvb, CORR_ID_OFFSET));
1263 }
1264 
1265 #define REG_STATUS_LENGTH  4
1266 #define REG_STATUS_OFFSET  PARAMETER_VALUE_OFFSET
1267 
1268 static const value_string registration_status_values[] = {
1269   {  0, "Successfully Registered" },
1270   {  1, "Error - Unknown" },
1271   {  2, "Error - Invalid DPC" },
1272   {  3, "Error - Invalid Network Appearance" },
1273   {  4, "Error - Invalid Routing Key" },
1274   {  5, "Error - Permission Denied" },
1275   {  6, "Error - Cannot Support Unique Routing" },
1276   {  7, "Error - Routing Key not Currently Provisioned" },
1277   {  8, "Error - Insufficient Resources" },
1278   {  9, "Error - Unsupported RK parameter Field" },
1279   { 10, "Error - Unsupported/Invalid Traffic Handling Mode" },
1280   { 11, "Error - Routing Key Change Refused" },
1281   { 12, "Error - Routing Key Already Registered" },
1282   {  0, NULL } };
1283 
1284 static void
dissect_registration_status_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)1285 dissect_registration_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1286 {
1287   proto_tree_add_item(parameter_tree, hf_registration_status, parameter_tvb, REG_STATUS_OFFSET, REG_STATUS_LENGTH, ENC_BIG_ENDIAN);
1288   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, REG_STATUS_OFFSET), registration_status_values, "unknown"));
1289 }
1290 
1291 #define DEREG_STATUS_LENGTH  4
1292 #define DEREG_STATUS_OFFSET  PARAMETER_VALUE_OFFSET
1293 
1294 static const value_string deregistration_status_values[] = {
1295   { 0, "Successfully Deregistered" },
1296   { 1, "Error - Unknown" },
1297   { 2, "Error - Invalid Routing Context" },
1298   { 3, "Error - Permission Denied" },
1299   { 4, "Error - Not Registered" },
1300   { 5, "Error - ASP Currently Active for Routing Context" },
1301   { 0, NULL } };
1302 
1303 static void
dissect_deregistration_status_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)1304 dissect_deregistration_status_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1305 {
1306   proto_tree_add_item(parameter_tree, hf_deregistration_status, parameter_tvb, DEREG_STATUS_OFFSET, DEREG_STATUS_LENGTH, ENC_BIG_ENDIAN);
1307   proto_item_append_text(parameter_item, " (%s)", val_to_str_const(tvb_get_ntohl(parameter_tvb, DEREG_STATUS_OFFSET), deregistration_status_values, "unknown"));
1308 }
1309 
1310 static void
dissect_registration_results_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * parameter_tree)1311 dissect_registration_results_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree)
1312 {
1313   tvbuff_t *parameters_tvb;
1314   guint16 parameters_length;
1315 
1316   parameters_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
1317   parameters_tvb    = tvb_new_subset_length(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length);
1318   dissect_parameters(parameters_tvb, pinfo, tree, parameter_tree);
1319 }
1320 
1321 static void
dissect_deregistration_results_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * parameter_tree)1322 dissect_deregistration_results_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *parameter_tree)
1323 {
1324   tvbuff_t *parameters_tvb;
1325   guint16 parameters_length;
1326 
1327   parameters_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
1328   parameters_tvb    = tvb_new_subset_length(parameter_tvb, PARAMETER_VALUE_OFFSET, parameters_length);
1329   dissect_parameters(parameters_tvb, pinfo, tree, parameter_tree);
1330 }
1331 
1332 static void
dissect_unknown_parameter(tvbuff_t * parameter_tvb,proto_tree * parameter_tree,proto_item * parameter_item)1333 dissect_unknown_parameter(tvbuff_t *parameter_tvb, proto_tree *parameter_tree, proto_item *parameter_item)
1334 {
1335   guint16 tag, parameter_value_length;
1336 
1337   tag                    = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1338   parameter_value_length = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET) - PARAMETER_HEADER_LENGTH;
1339   proto_tree_add_item(parameter_tree, hf_parameter_value, parameter_tvb, PARAMETER_VALUE_OFFSET, parameter_value_length, ENC_NA);
1340   proto_item_append_text(parameter_item, " (tag %u and %u byte%s value)", tag, parameter_value_length, plurality(parameter_value_length, "", "s"));
1341 }
1342 
1343 #define V5_NETWORK_APPEARANCE_PARAMETER_TAG       1
1344 #define V5_PROTOCOL_DATA_PARAMETER_TAG            3
1345 #define V5_INFO_PARAMETER_TAG                     4
1346 #define V5_AFFECTED_DESTINATIONS_PARAMETER_TAG    5
1347 #define V5_ROUTING_CONTEXT_PARAMETER_TAG          6
1348 #define V5_DIAGNOSTIC_INFORMATION_PARAMETER_TAG   7
1349 #define V5_HEARTBEAT_DATA_PARAMETER_TAG           8
1350 #define V5_USER_CAUSE_PARAMETER_TAG               9
1351 #define V5_REASON_PARAMETER_TAG                   10
1352 #define V5_TRAFFIC_MODE_TYPE_PARAMETER_TAG        11
1353 #define V5_ERROR_CODE_PARAMETER_TAG               12
1354 #define V5_STATUS_PARAMETER_TAG                   13
1355 #define V5_CONGESTION_INDICATION_PARAMETER_TAG    14
1356 
1357 static const value_string v5_parameter_tag_values[] = {
1358   { V5_NETWORK_APPEARANCE_PARAMETER_TAG,     "Network appearance" },
1359   { V5_PROTOCOL_DATA_PARAMETER_TAG,          "Protocol data" },
1360   { V5_INFO_PARAMETER_TAG,                   "Info" },
1361   { V5_AFFECTED_DESTINATIONS_PARAMETER_TAG,  "Affected destinations" },
1362   { V5_ROUTING_CONTEXT_PARAMETER_TAG,        "Routing context" },
1363   { V5_DIAGNOSTIC_INFORMATION_PARAMETER_TAG, "Diagnostic information" },
1364   { V5_HEARTBEAT_DATA_PARAMETER_TAG,         "Heartbeat data" },
1365   { V5_USER_CAUSE_PARAMETER_TAG,             "User / Cause" },
1366   { V5_REASON_PARAMETER_TAG,                 "Reason" },
1367   { V5_TRAFFIC_MODE_TYPE_PARAMETER_TAG,      "Traffic mode type" },
1368   { V5_ERROR_CODE_PARAMETER_TAG,             "Error code" },
1369   { V5_STATUS_PARAMETER_TAG,                 "Status" },
1370   { V5_CONGESTION_INDICATION_PARAMETER_TAG,  "Congestion indication" },
1371   { 0,                                       NULL } };
1372 
1373 static void
dissect_v5_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * m3ua_tree)1374 dissect_v5_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1375 {
1376   guint16 tag, length, padding_length;
1377   proto_item *parameter_item;
1378   proto_tree *parameter_tree;
1379 
1380   /* extract tag and length from the parameter */
1381   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1382   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1383   padding_length = tvb_reported_length(parameter_tvb) - length;
1384 
1385   if (!tree && tag != V5_PROTOCOL_DATA_PARAMETER_TAG)
1386     return;    /* Nothing to do here */
1387 
1388   /* create proto_tree stuff */
1389   parameter_tree = proto_tree_add_subtree(m3ua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, -1, ett_parameter, &parameter_item,
1390                                         val_to_str_const(tag, v5_parameter_tag_values, "Unknown parameter"));
1391 
1392   /* add tag and length to the parameter tree */
1393   proto_tree_add_item(parameter_tree, hf_v5_parameter_tag, parameter_tvb, PARAMETER_TAG_OFFSET,    PARAMETER_TAG_LENGTH,    ENC_BIG_ENDIAN);
1394   proto_tree_add_item(parameter_tree, hf_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, ENC_BIG_ENDIAN);
1395 
1396   switch(tag) {
1397   case V5_NETWORK_APPEARANCE_PARAMETER_TAG:
1398     dissect_network_appearance_parameter(parameter_tvb, parameter_tree, parameter_item);
1399     break;
1400   case V5_PROTOCOL_DATA_PARAMETER_TAG:
1401     dissect_v5_protocol_data_parameter(parameter_tvb, pinfo, tree, parameter_item);
1402     break;
1403   case V5_INFO_PARAMETER_TAG:
1404     dissect_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
1405     break;
1406   case V5_AFFECTED_DESTINATIONS_PARAMETER_TAG:
1407     dissect_affected_destinations_parameter(parameter_tvb, parameter_tree, parameter_item);
1408     break;
1409   case V5_ROUTING_CONTEXT_PARAMETER_TAG:
1410     dissect_routing_context_parameter(parameter_tvb, parameter_tree, parameter_item);
1411     break;
1412   case V5_DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
1413     dissect_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
1414     break;
1415   case V5_HEARTBEAT_DATA_PARAMETER_TAG:
1416     dissect_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
1417     break;
1418   case V5_USER_CAUSE_PARAMETER_TAG:
1419     dissect_user_cause_parameter(parameter_tvb, parameter_tree, parameter_item);
1420     break;
1421   case V5_REASON_PARAMETER_TAG:
1422     dissect_reason_parameter(parameter_tvb, parameter_tree, parameter_item);
1423     break;
1424   case V5_TRAFFIC_MODE_TYPE_PARAMETER_TAG:
1425     dissect_v5_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
1426     break;
1427   case V5_ERROR_CODE_PARAMETER_TAG:
1428     dissect_v5_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1429     break;
1430   case V5_STATUS_PARAMETER_TAG:
1431     dissect_v567_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1432     break;
1433   case V5_CONGESTION_INDICATION_PARAMETER_TAG:
1434     dissect_congestion_indication_parameter(parameter_tvb, parameter_tree, parameter_item);
1435     break;
1436   default:
1437     dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
1438     break;
1439   };
1440   if (padding_length > 0)
1441     proto_tree_add_item(parameter_tree, hf_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length, ENC_NA);
1442 }
1443 
1444 #define V6_NETWORK_APPEARANCE_PARAMETER_TAG            1
1445 #define V6_PROTOCOL_DATA_1_PARAMETER_TAG               2
1446 #define V6_PROTOCOL_DATA_2_PARAMETER_TAG               3
1447 #define V6_INFO_PARAMETER_TAG                          4
1448 #define V6_AFFECTED_DESTINATIONS_PARAMETER_TAG         5
1449 #define V6_ROUTING_CONTEXT_PARAMETER_TAG               6
1450 #define V6_DIAGNOSTIC_INFORMATION_PARAMETER_TAG        7
1451 #define V6_HEARTBEAT_DATA_PARAMETER_TAG                8
1452 #define V6_USER_CAUSE_PARAMETER_TAG                    9
1453 #define V6_REASON_PARAMETER_TAG                       10
1454 #define V6_TRAFFIC_MODE_TYPE_PARAMETER_TAG            11
1455 #define V6_ERROR_CODE_PARAMETER_TAG                   12
1456 #define V6_STATUS_PARAMETER_TAG                       13
1457 #define V6_CONGESTION_INDICATION_PARAMETER_TAG        14
1458 #define V6_CONCERNED_DESTINATION_PARAMETER_TAG        15
1459 #define V6_ROUTING_KEY_PARAMETER_TAG                  16
1460 #define V6_REGISTRATION_RESULT_PARAMETER_TAG          17
1461 #define V6_DEREGISTRATION_RESULT_PARAMETER_TAG        18
1462 #define V6_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG 19
1463 #define V6_DESTINATION_POINT_CODE_PARAMETER_TAG       20
1464 #define V6_SERVICE_INDICATORS_PARAMETER_TAG           21
1465 #define V6_SUBSYSTEM_NUMBERS_PARAMETER_TAG            22
1466 #define V6_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG  23
1467 #define V6_CIRCUIT_RANGE_PARAMETER_TAG                24
1468 #define V6_REGISTRATION_RESULTS_PARAMETER_TAG         25
1469 #define V6_DEREGISTRATION_RESULTS_PARAMETER_TAG       26
1470 
1471 static const value_string v6_parameter_tag_values[] = {
1472   { V6_NETWORK_APPEARANCE_PARAMETER_TAG,           "Network appearance" },
1473   { V6_PROTOCOL_DATA_1_PARAMETER_TAG,              "Protocol data 1" },
1474   { V6_PROTOCOL_DATA_2_PARAMETER_TAG,              "Protocol data 2" },
1475   { V6_INFO_PARAMETER_TAG,                         "Info" },
1476   { V6_AFFECTED_DESTINATIONS_PARAMETER_TAG,        "Affected destinations" },
1477   { V6_ROUTING_CONTEXT_PARAMETER_TAG,              "Routing context" },
1478   { V6_DIAGNOSTIC_INFORMATION_PARAMETER_TAG,       "Diagnostic information" },
1479   { V6_HEARTBEAT_DATA_PARAMETER_TAG,               "Heartbeat data" },
1480   { V6_USER_CAUSE_PARAMETER_TAG,                   "User / Cause" },
1481   { V6_REASON_PARAMETER_TAG,                       "Reason" },
1482   { V6_TRAFFIC_MODE_TYPE_PARAMETER_TAG,            "Traffic mode type" },
1483   { V6_ERROR_CODE_PARAMETER_TAG,                   "Error code" },
1484   { V6_STATUS_PARAMETER_TAG,                       "Status" },
1485   { V6_CONGESTION_INDICATION_PARAMETER_TAG,        "Congestion indication" },
1486   { V6_CONCERNED_DESTINATION_PARAMETER_TAG,        "Concerned destination" },
1487   { V6_ROUTING_KEY_PARAMETER_TAG,                  "Routing Key" },
1488   { V6_REGISTRATION_RESULT_PARAMETER_TAG,          "Registration result" },
1489   { V6_DEREGISTRATION_RESULT_PARAMETER_TAG,        "De-registration result" },
1490   { V6_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG, "Local routing key identifier" },
1491   { V6_DESTINATION_POINT_CODE_PARAMETER_TAG,       "Destination point code" },
1492   { V6_SERVICE_INDICATORS_PARAMETER_TAG,           "Service indicators" },
1493   { V6_SUBSYSTEM_NUMBERS_PARAMETER_TAG,            "Subsystem numbers" },
1494   { V6_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG,  "Originating point code list" },
1495   { V6_CIRCUIT_RANGE_PARAMETER_TAG,                "Circuit range" },
1496   { V6_REGISTRATION_RESULTS_PARAMETER_TAG,         "Registration results" },
1497   { V6_DEREGISTRATION_RESULTS_PARAMETER_TAG,       "De-registration results" },
1498   { 0,                           NULL } };
1499 
1500 static void
dissect_v6_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * m3ua_tree)1501 dissect_v6_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1502 {
1503   guint16 tag, length, padding_length;
1504   proto_item *parameter_item;
1505   proto_tree *parameter_tree;
1506 
1507   /* extract tag and length from the parameter */
1508   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1509   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1510   padding_length = tvb_reported_length(parameter_tvb) - length;
1511 
1512   if (!tree && tag != V6_PROTOCOL_DATA_1_PARAMETER_TAG && tag != V6_PROTOCOL_DATA_2_PARAMETER_TAG)
1513     return;    /* Nothing to do here */
1514 
1515   /* create proto_tree stuff */
1516   parameter_tree = proto_tree_add_subtree(m3ua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, -1,
1517             ett_parameter, &parameter_item, val_to_str_const(tag, v6_parameter_tag_values, "Unknown parameter"));
1518 
1519   /* add tag and length to the parameter tree */
1520   proto_tree_add_item(parameter_tree, hf_v6_parameter_tag, parameter_tvb, PARAMETER_TAG_OFFSET,    PARAMETER_TAG_LENGTH,    ENC_BIG_ENDIAN);
1521   proto_tree_add_item(parameter_tree, hf_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, ENC_BIG_ENDIAN);
1522 
1523   switch(tag) {
1524   case V6_NETWORK_APPEARANCE_PARAMETER_TAG:
1525     dissect_network_appearance_parameter(parameter_tvb, parameter_tree, parameter_item);
1526     break;
1527   case V6_PROTOCOL_DATA_1_PARAMETER_TAG:
1528     dissect_protocol_data_1_parameter(parameter_tvb, pinfo, tree, parameter_item);
1529     break;
1530   case V6_PROTOCOL_DATA_2_PARAMETER_TAG:
1531     dissect_protocol_data_2_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1532     break;
1533   case V6_INFO_PARAMETER_TAG:
1534     dissect_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
1535     break;
1536   case V6_AFFECTED_DESTINATIONS_PARAMETER_TAG:
1537     dissect_affected_destinations_parameter(parameter_tvb, parameter_tree, parameter_item);
1538     break;
1539   case V6_ROUTING_CONTEXT_PARAMETER_TAG:
1540     dissect_routing_context_parameter(parameter_tvb, parameter_tree, parameter_item);
1541     break;
1542   case V6_DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
1543     dissect_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
1544     break;
1545   case V6_HEARTBEAT_DATA_PARAMETER_TAG:
1546     dissect_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
1547     break;
1548   case V6_USER_CAUSE_PARAMETER_TAG:
1549     dissect_user_cause_parameter(parameter_tvb, parameter_tree, parameter_item);
1550     break;
1551   case V6_REASON_PARAMETER_TAG:
1552     dissect_reason_parameter(parameter_tvb, parameter_tree, parameter_item);
1553     break;
1554   case V6_TRAFFIC_MODE_TYPE_PARAMETER_TAG:
1555     dissect_v6_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
1556     break;
1557   case V6_ERROR_CODE_PARAMETER_TAG:
1558     dissect_v6_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1559     break;
1560   case V6_STATUS_PARAMETER_TAG:
1561     dissect_v567_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1562     break;
1563   case V6_CONGESTION_INDICATION_PARAMETER_TAG:
1564     dissect_congestion_indication_parameter(parameter_tvb, parameter_tree, parameter_item);
1565     break;
1566   case V6_CONCERNED_DESTINATION_PARAMETER_TAG:
1567     dissect_concerned_destination_parameter(parameter_tvb, parameter_tree, parameter_item);
1568     break;
1569   case V6_ROUTING_KEY_PARAMETER_TAG:
1570     dissect_routing_key_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1571     break;
1572   case V6_REGISTRATION_RESULT_PARAMETER_TAG:
1573     dissect_v67_registration_result_parameter(parameter_tvb, parameter_tree);
1574     break;
1575   case V6_DEREGISTRATION_RESULT_PARAMETER_TAG:
1576     dissect_v67_deregistration_result_parameter(parameter_tvb, parameter_tree);
1577     break;
1578   case V6_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG:
1579     dissect_local_routing_key_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1580     break;
1581   case V6_DESTINATION_POINT_CODE_PARAMETER_TAG:
1582     dissect_destination_point_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1583     break;
1584   case V6_SERVICE_INDICATORS_PARAMETER_TAG:
1585     dissect_service_indicators_parameter(parameter_tvb, parameter_tree, parameter_item);
1586     break;
1587   case V6_SUBSYSTEM_NUMBERS_PARAMETER_TAG:
1588     dissect_subsystem_numbers_parameter(parameter_tvb, parameter_tree, parameter_item);
1589     break;
1590   case V6_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG:
1591     dissect_originating_point_code_list_parameter(parameter_tvb, parameter_tree, parameter_item);
1592     break;
1593   case V6_CIRCUIT_RANGE_PARAMETER_TAG:
1594     dissect_circuit_range_parameter(parameter_tvb, parameter_tree, parameter_item);
1595     break;
1596   case V6_REGISTRATION_RESULTS_PARAMETER_TAG:
1597     dissect_registration_results_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1598     break;
1599   case V6_DEREGISTRATION_RESULTS_PARAMETER_TAG:
1600     dissect_deregistration_results_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1601     break;
1602   default:
1603     dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
1604     break;
1605   };
1606 
1607   if (padding_length > 0)
1608     proto_tree_add_item(parameter_tree, hf_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length, ENC_NA);
1609 }
1610 
1611 #define V7_NETWORK_APPEARANCE_PARAMETER_TAG            0x80
1612 #define V7_PROTOCOL_DATA_1_PARAMETER_TAG               0x81
1613 #define V7_PROTOCOL_DATA_2_PARAMETER_TAG               0x82
1614 #define V7_INFO_PARAMETER_TAG                          0x04
1615 #define V7_AFFECTED_DESTINATIONS_PARAMETER_TAG         0x83
1616 #define V7_ROUTING_CONTEXT_PARAMETER_TAG               0x06
1617 #define V7_DIAGNOSTIC_INFORMATION_PARAMETER_TAG        0x07
1618 #define V7_HEARTBEAT_DATA_PARAMETER_TAG                0x09
1619 #define V7_USER_CAUSE_PARAMETER_TAG                    0x84
1620 #define V7_REASON_PARAMETER_TAG                        0x0a
1621 #define V7_TRAFFIC_MODE_TYPE_PARAMETER_TAG             0x0b
1622 #define V7_ERROR_CODE_PARAMETER_TAG                    0x0c
1623 #define V7_STATUS_PARAMETER_TAG                        0x0d
1624 #define V7_CONGESTION_INDICATION_PARAMETER_TAG         0x85
1625 #define V7_CONCERNED_DESTINATION_PARAMETER_TAG         0x86
1626 #define V7_ROUTING_KEY_PARAMETER_TAG                   0x87
1627 #define V7_REGISTRATION_RESULT_PARAMETER_TAG           0x88
1628 #define V7_DEREGISTRATION_RESULT_PARAMETER_TAG         0x89
1629 #define V7_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG  0x8a
1630 #define V7_DESTINATION_POINT_CODE_PARAMETER_TAG        0x8b
1631 #define V7_SERVICE_INDICATORS_PARAMETER_TAG            0x8c
1632 #define V7_SUBSYSTEM_NUMBERS_PARAMETER_TAG             0x8d
1633 #define V7_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG   0x8e
1634 #define V7_CIRCUIT_RANGE_PARAMETER_TAG                 0x8f
1635 #define V7_REGISTRATION_RESULTS_PARAMETER_TAG          0x90
1636 #define V7_DEREGISTRATION_RESULTS_PARAMETER_TAG        0x91
1637 
1638 static const value_string v7_parameter_tag_values[] = {
1639   { V7_NETWORK_APPEARANCE_PARAMETER_TAG,           "Network appearance" },
1640   { V7_PROTOCOL_DATA_1_PARAMETER_TAG,              "Protocol data 1" },
1641   { V7_PROTOCOL_DATA_2_PARAMETER_TAG,              "Protocol data 2" },
1642   { V7_INFO_PARAMETER_TAG,                         "Info" },
1643   { V7_AFFECTED_DESTINATIONS_PARAMETER_TAG,        "Affected destinations" },
1644   { V7_ROUTING_CONTEXT_PARAMETER_TAG,              "Routing context" },
1645   { V7_DIAGNOSTIC_INFORMATION_PARAMETER_TAG,       "Diagnostic information" },
1646   { V7_HEARTBEAT_DATA_PARAMETER_TAG,               "Heartbeat data" },
1647   { V7_USER_CAUSE_PARAMETER_TAG,                   "User / Cause" },
1648   { V7_REASON_PARAMETER_TAG,                       "Reason" },
1649   { V7_TRAFFIC_MODE_TYPE_PARAMETER_TAG,            "Traffic mode type" },
1650   { V7_ERROR_CODE_PARAMETER_TAG,                   "Error code" },
1651   { V7_STATUS_PARAMETER_TAG,                       "Status" },
1652   { V7_CONGESTION_INDICATION_PARAMETER_TAG,        "Congestion indication" },
1653   { V7_CONCERNED_DESTINATION_PARAMETER_TAG,        "Concerned destination" },
1654   { V7_ROUTING_KEY_PARAMETER_TAG,                  "Routing Key" },
1655   { V7_REGISTRATION_RESULT_PARAMETER_TAG,          "Registration result" },
1656   { V7_DEREGISTRATION_RESULT_PARAMETER_TAG,        "De-registration result" },
1657   { V7_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG, "Local routing key identifier" },
1658   { V7_DESTINATION_POINT_CODE_PARAMETER_TAG,       "Destination point code" },
1659   { V7_SERVICE_INDICATORS_PARAMETER_TAG,           "Service indicators" },
1660   { V7_SUBSYSTEM_NUMBERS_PARAMETER_TAG,            "Subsystem numbers" },
1661   { V7_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG,  "Originating point code list" },
1662   { V7_CIRCUIT_RANGE_PARAMETER_TAG,                "Circuit range" },
1663   { V7_REGISTRATION_RESULTS_PARAMETER_TAG,         "Registration results" },
1664   { V7_DEREGISTRATION_RESULTS_PARAMETER_TAG,       "De-registration results" },
1665   { 0,                           NULL } };
1666 
1667 static void
dissect_v7_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * m3ua_tree)1668 dissect_v7_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1669 {
1670   guint16 tag, length, padding_length;
1671   proto_item *parameter_item;
1672   proto_tree *parameter_tree;
1673 
1674   /* extract tag and length from the parameter */
1675   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1676   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1677   padding_length = tvb_reported_length(parameter_tvb) - length;
1678 
1679   if (!tree && tag != V7_PROTOCOL_DATA_1_PARAMETER_TAG && tag != V7_PROTOCOL_DATA_2_PARAMETER_TAG)
1680     return;    /* Nothing to do here */
1681 
1682   /* create proto_tree stuff */
1683   parameter_tree = proto_tree_add_subtree(m3ua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, -1,
1684         ett_parameter, &parameter_item, val_to_str_const(tag, v7_parameter_tag_values, "Unknown parameter"));
1685 
1686   /* add tag and length to the parameter tree */
1687   proto_tree_add_item(parameter_tree, hf_v7_parameter_tag, parameter_tvb, PARAMETER_TAG_OFFSET,    PARAMETER_TAG_LENGTH,    ENC_BIG_ENDIAN);
1688   proto_tree_add_item(parameter_tree, hf_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, ENC_BIG_ENDIAN);
1689 
1690   switch(tag) {
1691   case V7_NETWORK_APPEARANCE_PARAMETER_TAG:
1692     dissect_network_appearance_parameter(parameter_tvb, parameter_tree, parameter_item);
1693     break;
1694   case V7_PROTOCOL_DATA_1_PARAMETER_TAG:
1695     dissect_protocol_data_1_parameter(parameter_tvb, pinfo, tree, parameter_item);
1696     break;
1697   case V7_PROTOCOL_DATA_2_PARAMETER_TAG:
1698     dissect_protocol_data_2_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1699     break;
1700   case V7_INFO_PARAMETER_TAG:
1701     dissect_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
1702     break;
1703   case V7_AFFECTED_DESTINATIONS_PARAMETER_TAG:
1704     dissect_affected_destinations_parameter(parameter_tvb, parameter_tree, parameter_item);
1705     break;
1706   case V7_ROUTING_CONTEXT_PARAMETER_TAG:
1707     dissect_routing_context_parameter(parameter_tvb, parameter_tree, parameter_item);
1708     break;
1709   case V7_DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
1710     dissect_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
1711     break;
1712   case V7_HEARTBEAT_DATA_PARAMETER_TAG:
1713     dissect_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
1714     break;
1715   case V7_USER_CAUSE_PARAMETER_TAG:
1716     dissect_user_cause_parameter(parameter_tvb, parameter_tree, parameter_item);
1717     break;
1718   case V7_REASON_PARAMETER_TAG:
1719     dissect_reason_parameter(parameter_tvb, parameter_tree, parameter_item);
1720     break;
1721   case V7_TRAFFIC_MODE_TYPE_PARAMETER_TAG:
1722     dissect_v7_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
1723     break;
1724   case V7_ERROR_CODE_PARAMETER_TAG:
1725     dissect_v7_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1726     break;
1727   case V7_STATUS_PARAMETER_TAG:
1728     dissect_v567_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1729     break;
1730   case V7_CONGESTION_INDICATION_PARAMETER_TAG:
1731     dissect_congestion_indication_parameter(parameter_tvb, parameter_tree, parameter_item);
1732     break;
1733   case V7_CONCERNED_DESTINATION_PARAMETER_TAG:
1734     dissect_concerned_destination_parameter(parameter_tvb, parameter_tree, parameter_item);
1735     break;
1736   case V7_ROUTING_KEY_PARAMETER_TAG:
1737     dissect_routing_key_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1738     break;
1739   case V7_REGISTRATION_RESULT_PARAMETER_TAG:
1740     dissect_v67_registration_result_parameter(parameter_tvb, parameter_tree);
1741     break;
1742   case V7_DEREGISTRATION_RESULT_PARAMETER_TAG:
1743     dissect_v67_deregistration_result_parameter(parameter_tvb, parameter_tree);
1744     break;
1745   case V7_LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG:
1746     dissect_local_routing_key_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1747     break;
1748   case V7_DESTINATION_POINT_CODE_PARAMETER_TAG:
1749     dissect_destination_point_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1750     break;
1751   case V7_SERVICE_INDICATORS_PARAMETER_TAG:
1752     dissect_service_indicators_parameter(parameter_tvb, parameter_tree, parameter_item);
1753     break;
1754   case V7_SUBSYSTEM_NUMBERS_PARAMETER_TAG:
1755     dissect_subsystem_numbers_parameter(parameter_tvb, parameter_tree, parameter_item);
1756     break;
1757   case V7_ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG:
1758     dissect_originating_point_code_list_parameter(parameter_tvb, parameter_tree, parameter_item);
1759     break;
1760   case V7_CIRCUIT_RANGE_PARAMETER_TAG:
1761     dissect_circuit_range_parameter(parameter_tvb, parameter_tree, parameter_item);
1762     break;
1763   case V7_REGISTRATION_RESULTS_PARAMETER_TAG:
1764     dissect_registration_results_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1765     break;
1766   case V7_DEREGISTRATION_RESULTS_PARAMETER_TAG:
1767     dissect_deregistration_results_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1768     break;
1769   default:
1770     dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
1771     break;
1772   };
1773 
1774   if (padding_length > 0)
1775     proto_tree_add_item(parameter_tree, hf_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length, ENC_NA);
1776 }
1777 
1778 #define INFO_STRING_PARAMETER_TAG                  0x0004
1779 #define ROUTING_CONTEXT_PARAMETER_TAG              0x0006
1780 #define DIAGNOSTIC_INFORMATION_PARAMETER_TAG       0x0007
1781 #define HEARTBEAT_DATA_PARAMETER_TAG               0x0009
1782 #define TRAFFIC_MODE_TYPE_PARAMETER_TAG            0x000b
1783 #define ERROR_CODE_PARAMETER_TAG                   0x000c
1784 #define STATUS_PARAMETER_TAG                       0x000d
1785 #define ASP_IDENTIFIER_PARAMETER_TAG               0x0011
1786 #define AFFECTED_POINT_CODE_PARAMETER_TAG          0x0012
1787 #define CORRELATION_IDENTIFIER_PARAMETER_TAG       0x0013
1788 
1789 #define NETWORK_APPEARANCE_PARAMETER_TAG           0x0200
1790 #define USER_CAUSE_PARAMETER_TAG                   0x0204
1791 #define CONGESTION_INDICATIONS_PARAMETER_TAG       0x0205
1792 #define CONCERNED_DESTINATION_PARAMETER_TAG        0x0206
1793 #define ROUTING_KEY_PARAMETER_TAG                  0x0207
1794 #define REGISTRATION_RESULT_PARAMETER_TAG          0x0208
1795 #define DEREGISTRATION_RESULT_PARAMETER_TAG        0x0209
1796 #define LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG 0x020a
1797 #define DESTINATION_POINT_CODE_PARAMETER_TAG       0x020b
1798 #define SERVICE_INDICATORS_PARAMETER_TAG           0x020c
1799 #define ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG  0x020e
1800 #define CIRCUIT_RANGE_PARAMETER_TAG                0x020f
1801 #define PROTOCOL_DATA_PARAMETER_TAG                0x0210
1802 #define REGISTRATION_STATUS_PARAMETER_TAG          0x0212
1803 #define DEREGISTRATION_STATUS_PARAMETER_TAG        0x0213
1804 
1805 static const value_string parameter_tag_values[] = {
1806   { INFO_STRING_PARAMETER_TAG,                  "Info string" } ,
1807   { ROUTING_CONTEXT_PARAMETER_TAG,              "Routing context" } ,
1808   { DIAGNOSTIC_INFORMATION_PARAMETER_TAG,       "Diagnostic Information" } ,
1809   { HEARTBEAT_DATA_PARAMETER_TAG,               "Heartbeat data" } ,
1810   { TRAFFIC_MODE_TYPE_PARAMETER_TAG,            "Traffic mode type" } ,
1811   { ERROR_CODE_PARAMETER_TAG,                   "Error code" } ,
1812   { STATUS_PARAMETER_TAG,                       "Status" } ,
1813   { ASP_IDENTIFIER_PARAMETER_TAG,               "ASP identifier" } ,
1814   { AFFECTED_POINT_CODE_PARAMETER_TAG,          "Affected point code" } ,
1815   { CORRELATION_IDENTIFIER_PARAMETER_TAG,       "Correlation identifier" } ,
1816   { NETWORK_APPEARANCE_PARAMETER_TAG,           "Network appearance" } ,
1817   { USER_CAUSE_PARAMETER_TAG,                   "User / cause" } ,
1818   { CONGESTION_INDICATIONS_PARAMETER_TAG,       "Congestion indications" } ,
1819   { CONCERNED_DESTINATION_PARAMETER_TAG,        "Concerned destination" } ,
1820   { ROUTING_KEY_PARAMETER_TAG,                  "Routing key" } ,
1821   { REGISTRATION_RESULT_PARAMETER_TAG,          "Registration result" } ,
1822   { DEREGISTRATION_RESULT_PARAMETER_TAG,        "Deregistration result" } ,
1823   { LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG, "Local routing key identifier" } ,
1824   { DESTINATION_POINT_CODE_PARAMETER_TAG,       "Destination point code" } ,
1825   { SERVICE_INDICATORS_PARAMETER_TAG,           "Service indicators" } ,
1826   { ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG,  "Originating point code list" } ,
1827   { CIRCUIT_RANGE_PARAMETER_TAG,                "Circuit range" } ,
1828   { PROTOCOL_DATA_PARAMETER_TAG,                "Protocol data" } ,
1829   { REGISTRATION_STATUS_PARAMETER_TAG,          "Registration status" } ,
1830   { DEREGISTRATION_STATUS_PARAMETER_TAG,        "Deregistration status" } ,
1831   { 0,                           NULL } };
1832 
1833 static void
dissect_parameter(tvbuff_t * parameter_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * m3ua_tree)1834 dissect_parameter(tvbuff_t *parameter_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1835 {
1836   guint16 tag, length, padding_length;
1837   proto_item *parameter_item;
1838   proto_tree *parameter_tree;
1839 
1840   /* extract tag and length from the parameter */
1841   tag            = tvb_get_ntohs(parameter_tvb, PARAMETER_TAG_OFFSET);
1842   length         = tvb_get_ntohs(parameter_tvb, PARAMETER_LENGTH_OFFSET);
1843   padding_length = tvb_reported_length(parameter_tvb) - length;
1844 
1845 
1846   if (!tree && tag != PROTOCOL_DATA_PARAMETER_TAG)
1847     return;    /* Nothing to do here */
1848 
1849   /* create proto_tree stuff */
1850   parameter_tree = proto_tree_add_subtree(m3ua_tree, parameter_tvb, PARAMETER_HEADER_OFFSET, -1,
1851                 ett_parameter, &parameter_item, val_to_str_const(tag, parameter_tag_values, "Unknown parameter"));
1852 
1853   /* add tag and length to the parameter tree */
1854   proto_tree_add_item(parameter_tree, hf_parameter_tag,    parameter_tvb, PARAMETER_TAG_OFFSET,    PARAMETER_TAG_LENGTH,    ENC_BIG_ENDIAN);
1855   proto_tree_add_item(parameter_tree, hf_parameter_length, parameter_tvb, PARAMETER_LENGTH_OFFSET, PARAMETER_LENGTH_LENGTH, ENC_BIG_ENDIAN);
1856 
1857   switch(tag) {
1858   case INFO_STRING_PARAMETER_TAG:
1859     dissect_info_string_parameter(parameter_tvb, parameter_tree, parameter_item);
1860     break;
1861   case ROUTING_CONTEXT_PARAMETER_TAG:
1862     dissect_routing_context_parameter(parameter_tvb, parameter_tree, parameter_item);
1863     break;
1864   case DIAGNOSTIC_INFORMATION_PARAMETER_TAG:
1865     dissect_diagnostic_information_parameter(parameter_tvb, parameter_tree, parameter_item);
1866     break;
1867   case HEARTBEAT_DATA_PARAMETER_TAG:
1868     dissect_heartbeat_data_parameter(parameter_tvb, parameter_tree, parameter_item);
1869     break;
1870   case TRAFFIC_MODE_TYPE_PARAMETER_TAG:
1871     dissect_traffic_mode_type_parameter(parameter_tvb, parameter_tree, parameter_item);
1872     break;
1873   case ERROR_CODE_PARAMETER_TAG:
1874     dissect_error_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1875     break;
1876   case STATUS_PARAMETER_TAG:
1877     dissect_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1878     break;
1879   case ASP_IDENTIFIER_PARAMETER_TAG:
1880     dissect_asp_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1881     break;
1882   case AFFECTED_POINT_CODE_PARAMETER_TAG:
1883     dissect_affected_destinations_parameter(parameter_tvb, parameter_tree, parameter_item);
1884     break;
1885   case NETWORK_APPEARANCE_PARAMETER_TAG:
1886     dissect_network_appearance_parameter(parameter_tvb, parameter_tree, parameter_item);
1887     break;
1888   case USER_CAUSE_PARAMETER_TAG:
1889     dissect_user_cause_parameter(parameter_tvb, parameter_tree, parameter_item);
1890     break;
1891   case CONGESTION_INDICATIONS_PARAMETER_TAG:
1892     dissect_congestion_indication_parameter(parameter_tvb, parameter_tree, parameter_item);
1893     break;
1894   case CONCERNED_DESTINATION_PARAMETER_TAG:
1895     dissect_concerned_destination_parameter(parameter_tvb, parameter_tree, parameter_item);
1896     break;
1897   case ROUTING_KEY_PARAMETER_TAG:
1898     dissect_routing_key_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1899     break;
1900   case REGISTRATION_RESULT_PARAMETER_TAG:
1901     dissect_registration_result_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1902     break;
1903   case DEREGISTRATION_RESULT_PARAMETER_TAG:
1904     dissect_deregistration_result_parameter(parameter_tvb, pinfo, tree, parameter_tree);
1905     break;
1906   case LOCAL_ROUTING_KEY_IDENTIFIER_PARAMETER_TAG:
1907     dissect_local_routing_key_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1908     break;
1909   case DESTINATION_POINT_CODE_PARAMETER_TAG:
1910     dissect_destination_point_code_parameter(parameter_tvb, parameter_tree, parameter_item);
1911     break;
1912   case SERVICE_INDICATORS_PARAMETER_TAG:
1913     dissect_service_indicators_parameter(parameter_tvb, parameter_tree, parameter_item);
1914     break;
1915   case ORIGINATING_POINT_CODE_LIST_PARAMETER_TAG:
1916     dissect_originating_point_code_list_parameter(parameter_tvb, parameter_tree, parameter_item);
1917     break;
1918   case CIRCUIT_RANGE_PARAMETER_TAG:
1919     dissect_circuit_range_parameter(parameter_tvb, parameter_tree, parameter_item);
1920     break;
1921   case PROTOCOL_DATA_PARAMETER_TAG:
1922     dissect_protocol_data_parameter(parameter_tvb, pinfo, tree, parameter_tree, parameter_item);
1923     break;
1924   case CORRELATION_IDENTIFIER_PARAMETER_TAG:
1925     dissect_correlation_identifier_parameter(parameter_tvb, parameter_tree, parameter_item);
1926     break;
1927   case REGISTRATION_STATUS_PARAMETER_TAG:
1928     dissect_registration_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1929     break;
1930   case DEREGISTRATION_STATUS_PARAMETER_TAG:
1931     dissect_deregistration_status_parameter(parameter_tvb, parameter_tree, parameter_item);
1932     break;
1933   default:
1934     dissect_unknown_parameter(parameter_tvb, parameter_tree, parameter_item);
1935     break;
1936   };
1937 
1938   if (padding_length > 0)
1939     proto_tree_add_item(parameter_tree, hf_parameter_padding, parameter_tvb, PARAMETER_HEADER_OFFSET + length, padding_length, ENC_NA);
1940 }
1941 
1942 static void
dissect_parameters(tvbuff_t * parameters_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * m3ua_tree)1943 dissect_parameters(tvbuff_t *parameters_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1944 {
1945   gint offset, length, total_length, remaining_length;
1946   tvbuff_t *parameter_tvb;
1947 
1948   offset = 0;
1949   while((remaining_length = tvb_reported_length_remaining(parameters_tvb, offset))) {
1950     length       = tvb_get_ntohs(parameters_tvb, offset + PARAMETER_LENGTH_OFFSET);
1951     total_length = ADD_PADDING(length);
1952     if (remaining_length >= length)
1953       total_length = MIN(total_length, remaining_length);
1954     /* create a tvb for the parameter including the padding bytes */
1955     parameter_tvb    = tvb_new_subset_length(parameters_tvb, offset, total_length);
1956     switch(version) {
1957       case M3UA_V5:
1958         dissect_v5_parameter(parameter_tvb, pinfo, tree, m3ua_tree);
1959         break;
1960       case M3UA_V6:
1961         dissect_v6_parameter(parameter_tvb, pinfo, tree, m3ua_tree);
1962         break;
1963       case M3UA_V7:
1964         dissect_v7_parameter(parameter_tvb, pinfo, tree, m3ua_tree);
1965         break;
1966       case M3UA_RFC:
1967         dissect_parameter(parameter_tvb, pinfo, tree, m3ua_tree);
1968         break;
1969     }
1970     /* get rid of the handled parameter */
1971     offset += total_length;
1972   }
1973 }
1974 
1975 
1976 static void
dissect_message(tvbuff_t * message_tvb,packet_info * pinfo,proto_tree * tree,proto_tree * m3ua_tree)1977 dissect_message(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree, proto_tree *m3ua_tree)
1978 {
1979   tvbuff_t *common_header_tvb, *parameters_tvb;
1980 
1981   common_header_tvb = tvb_new_subset_length(message_tvb, 0, COMMON_HEADER_LENGTH);
1982   parameters_tvb    = tvb_new_subset_remaining(message_tvb, COMMON_HEADER_LENGTH);
1983   if (version == M3UA_V5)
1984     dissect_v5_common_header(common_header_tvb, pinfo, m3ua_tree);
1985   else
1986     dissect_common_header(common_header_tvb, pinfo, m3ua_tree);
1987 
1988   /*  Need to dissect (certain) parameters even when !tree, so subdissectors
1989    *  (e.g., MTP3) are always called.
1990    */
1991   dissect_parameters(parameters_tvb, pinfo, tree, m3ua_tree);
1992 }
1993 
1994 static int
dissect_m3ua(tvbuff_t * message_tvb,packet_info * pinfo,proto_tree * tree,void * data _U_)1995 dissect_m3ua(tvbuff_t *message_tvb, packet_info *pinfo, proto_tree *tree, void* data _U_)
1996 {
1997   proto_item *m3ua_item;
1998   proto_tree *m3ua_tree;
1999 
2000 
2001   /* make entry in the Protocol column on summary display */
2002   switch(version) {
2003       case M3UA_V5:
2004         col_set_str(pinfo->cinfo, COL_PROTOCOL, "M3UA (ID 05)");
2005         break;
2006       case M3UA_V6:
2007         col_set_str(pinfo->cinfo, COL_PROTOCOL, "M3UA (ID 06)");
2008         break;
2009       case M3UA_V7:
2010         col_set_str(pinfo->cinfo, COL_PROTOCOL, "M3UA (ID 07)");
2011         break;
2012       case M3UA_RFC:
2013         col_set_str(pinfo->cinfo, COL_PROTOCOL, "M3UA (RFC 4666)");
2014         break;
2015   };
2016 
2017   /* create the m3ua protocol tree */
2018   m3ua_item = proto_tree_add_item(tree, proto_m3ua, message_tvb, 0, -1, ENC_NA);
2019   m3ua_tree = proto_item_add_subtree(m3ua_item, ett_m3ua);
2020 
2021   /* dissect the message */
2022   dissect_message(message_tvb, pinfo, tree, m3ua_tree);
2023   return tvb_captured_length(message_tvb);
2024 }
2025 
2026 /* Register the protocol with Wireshark */
2027 void
proto_register_m3ua(void)2028 proto_register_m3ua(void)
2029 {
2030 
2031   /* Setup list of header fields */
2032   static hf_register_info hf[] = {
2033     { &hf_version,                          { "Version",                      "m3ua.version",                               FT_UINT8,  BASE_DEC,  VALS(protocol_version_values),                0x0, NULL,                              HFILL } },
2034     { &hf_reserved,                         { "Reserved",                     "m3ua.reserved",                              FT_UINT8,  BASE_HEX,  NULL,                                         0x0, NULL,                              HFILL } },
2035     { &hf_v5_message_class,                 { "Message class",                "m3ua.message_class",                         FT_UINT8,  BASE_DEC,  VALS(v5_message_class_values),                0x0, NULL,                              HFILL } },
2036     { &hf_message_class,                    { "Message class",                "m3ua.message_class",                         FT_UINT8,  BASE_DEC,  VALS(message_class_values),                   0x0, NULL,                              HFILL } },
2037     { &hf_message_type,                     { "Message Type",                 "m3ua.message_type",                          FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2038     { &hf_message_length,                   { "Message length",               "m3ua.message_length",                        FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2039     { &hf_v5_parameter_tag,                 { "Parameter Tag",                "m3ua.parameter_tag",                         FT_UINT16, BASE_DEC,  VALS(v5_parameter_tag_values),                0x0, NULL,                              HFILL } },
2040     { &hf_v6_parameter_tag,                 { "Parameter Tag",                "m3ua.parameter_tag",                         FT_UINT16, BASE_DEC,  VALS(v6_parameter_tag_values),                0x0, NULL,                              HFILL } },
2041     { &hf_v7_parameter_tag,                 { "Parameter Tag",                "m3ua.parameter_tag",                         FT_UINT16, BASE_DEC,  VALS(v7_parameter_tag_values),                0x0, NULL,                              HFILL } },
2042     { &hf_parameter_tag,                    { "Parameter Tag",                "m3ua.parameter_tag",                         FT_UINT16, BASE_DEC,  VALS(parameter_tag_values),                   0x0, NULL,                              HFILL } },
2043     { &hf_parameter_length,                 { "Parameter length",             "m3ua.parameter_length",                      FT_UINT16, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2044     { &hf_parameter_value,                  { "Parameter value",              "m3ua.parameter_value",                       FT_BYTES,  BASE_NONE, NULL,                                         0x0, NULL,                              HFILL } },
2045     { &hf_parameter_padding,                { "Padding",                      "m3ua.parameter_padding",                     FT_BYTES,  BASE_NONE, NULL,                                         0x0, NULL,                              HFILL } },
2046 #if 0
2047     { &hf_parameter_trailer,                { "Trailer",                      "m3ua.parameter_trailer",                      FT_BYTES,  BASE_NONE, NULL,                                         0x0, NULL,                              HFILL } },
2048 #endif
2049     { &hf_network_appearance,               { "Network appearance",           "m3ua.network_appearance",                    FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2050     { &hf_info_string,                      { "Info string",                  "m3ua.info_string",                           FT_STRING, BASE_NONE, NULL,                                         0x0, NULL,                              HFILL } },
2051     { &hf_routing_context,                  { "Routing context",              "m3ua.routing_context",                       FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2052     { &hf_diagnostic_information,           { "Diagnostic information",       "m3ua.diagnostic_information",                FT_BYTES,  BASE_NONE, NULL,                                         0x0, NULL,                              HFILL } },
2053     { &hf_heartbeat_data,                   { "Heartbeat data",               "m3ua.heartbeat_data",                        FT_BYTES,  BASE_NONE, NULL,                                         0x0, NULL,                              HFILL } },
2054     { &hf_v5_error_code,                    { "Error code",                   "m3ua.error_code",                            FT_UINT32, BASE_DEC,  VALS(v5_error_code_values),                   0x0, NULL,                              HFILL } },
2055     { &hf_v6_error_code,                    { "Error code",                   "m3ua.error_code",                            FT_UINT32, BASE_DEC,  VALS(v6_error_code_values),                   0x0, NULL,                              HFILL } },
2056     { &hf_v7_error_code,                    { "Error code",                   "m3ua.error_code",                            FT_UINT32, BASE_DEC,  VALS(v7_error_code_values),                   0x0, NULL,                              HFILL } },
2057     { &hf_error_code,                       { "Error code",                   "m3ua.error_code",                            FT_UINT32, BASE_DEC,  VALS(error_code_values),                      0x0, NULL,                              HFILL } },
2058     { &hf_status_type,                      { "Status type",                  "m3ua.status_type",                           FT_UINT16, BASE_DEC,  VALS(status_type_values),                     0x0, NULL,                              HFILL } },
2059     { &hf_status_info,                      { "Status info",                  "m3ua.status_info",                           FT_UINT16, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2060     { &hf_asp_identifier,                   { "ASP identifier",               "m3ua.asp_identifier",                        FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2061     { &hf_affected_point_code_mask,         { "Mask",                         "m3ua.affected_point_code_mask",              FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2062     { &hf_affected_point_code_pc,           { "Affected point code",          "m3ua.affected_point_code_pc",                FT_UINT24, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2063     { &hf_cause,                            { "Unavailability cause",         "m3ua.unavailability_cause",                  FT_UINT16, BASE_DEC,  VALS(unavailability_cause_values),            0x0, NULL,                              HFILL } },
2064     { &hf_user,                             { "User Identity",                "m3ua.user_identity",                         FT_UINT16, BASE_DEC,  VALS(user_identity_values),                   0x0, NULL,                              HFILL } },
2065     { &hf_reason,                           { "Reason",                       "m3ua.reason",                                FT_UINT32, BASE_DEC,  VALS(reason_values),                          0x0, NULL,                              HFILL } },
2066     { &hf_v5_traffic_mode_type,             { "Traffic mode Type",            "m3ua.traffic_mode_type",                     FT_UINT32, BASE_DEC,  VALS(v5_traffic_mode_type_values),            0x0, NULL,                              HFILL } },
2067     { &hf_v6_traffic_mode_type,             { "Traffic mode Type",            "m3ua.traffic_mode_type",                     FT_UINT32, BASE_DEC,  VALS(v6_traffic_mode_type_values),            0x0, NULL,                              HFILL } },
2068     { &hf_v7_traffic_mode_type,             { "Traffic mode Type",            "m3ua.traffic_mode_type",                     FT_UINT32, BASE_DEC,  VALS(v7_traffic_mode_type_values),            0x0, NULL,                              HFILL } },
2069     { &hf_traffic_mode_type,                { "Traffic mode Type",            "m3ua.traffic_mode_type",                     FT_UINT32, BASE_DEC,  VALS(traffic_mode_type_values),               0x0, NULL,                              HFILL } },
2070     { &hf_congestion_reserved,              { "Reserved",                     "m3ua.congestion_reserved",                   FT_BYTES,  BASE_NONE, NULL,                                         0x0, NULL,                              HFILL } },
2071     { &hf_congestion_level,                 { "Congestion level",             "m3ua.congestion_level",                      FT_UINT8,  BASE_DEC,  VALS(congestion_level_values),                0x0, NULL,                              HFILL } },
2072     { &hf_concerned_dest_reserved,          { "Reserved",                     "m3ua.concerned_reserved",                    FT_BYTES,  BASE_NONE, NULL,                                         0x0, NULL,                              HFILL } },
2073     { &hf_concerned_dest_pc,                { "Concerned DPC",                "m3ua.concerned_dpc",                         FT_UINT24, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2074     { &hf_local_rk_identifier,              { "Local routing key identifier", "m3ua.local_rk_identifier",                   FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2075     { &hf_dpc_mask,                         { "Mask",                         "m3ua.dpc_mask",                              FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2076     { &hf_dpc_pc,                           { "Destination point code",       "m3ua.dpc_pc",                                FT_UINT24, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2077     { &hf_si,                               { "Service indicator",            "m3ua.si",                                    FT_UINT8,  BASE_DEC,  VALS(user_identity_values),                   0x0, NULL,                              HFILL } },
2078     { &hf_ssn,                              { "Subsystem number",             "m3ua.ssn",                                   FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2079     { &hf_opc_list_mask,                    { "Mask",                         "m3ua.opc_list_mask",                         FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2080     { &hf_opc_list_pc,                      { "Originating point code",       "m3ua.opc_list_pc",                           FT_UINT24, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2081     { &hf_cic_range_mask,                   { "Mask",                         "m3ua.cic_range_mask",                        FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2082     { &hf_cic_range_pc,                     { "Originating point code",       "m3ua.cic_range_pc",                          FT_UINT24, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2083     { &hf_cic_range_lower,                  { "Lower CIC value",              "m3ua.cic_range_lower",                       FT_UINT16, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2084     { &hf_cic_range_upper,                  { "Upper CIC value",              "m3ua.cic_range_upper",                       FT_UINT16, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2085     { &hf_li,                               { "Length indicator",             "m3ua.protocol_data_2_li",                    FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2086     { &hf_protocol_data_opc,                { "OPC",                          "m3ua.protocol_data_opc",                     FT_UINT32, BASE_DEC,  NULL,                                         0x0, "Originating Point Code",          HFILL } },
2087     { &hf_protocol_data_dpc,                { "DPC",                          "m3ua.protocol_data_dpc",                     FT_UINT32, BASE_DEC,  NULL,                                         0x0, "Destination Point Code",          HFILL } },
2088     { &hf_protocol_data_mtp3_opc,           { "OPC",                          "mtp3.opc",                                   FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2089     { &hf_protocol_data_mtp3_dpc,           { "DPC",                          "mtp3.dpc",                                   FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2090     { &hf_protocol_data_mtp3_pc,            { "PC",                           "mtp3.pc",                                    FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2091     { &hf_protocol_data_si,                 { "SI",                           "m3ua.protocol_data_si",                      FT_UINT8,  BASE_DEC,  VALS(mtp3_service_indicator_code_short_vals), 0x0, "Service Indicator",               HFILL } },
2092     { &hf_protocol_data_ni,                 { "NI",                           "m3ua.protocol_data_ni",                      FT_UINT8,  BASE_DEC,  VALS(mtp3_network_indicator_vals),            0x0, "Network Indicator",               HFILL } },
2093     { &hf_protocol_data_mtp3_ni,            { "NI",                           "mtp3.ni",                                    FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2094     { &hf_protocol_data_mp,                 { "MP",                           "m3ua.protocol_data_mp",                      FT_UINT8,  BASE_DEC,  NULL,                                         0x0, "Message Priority",                HFILL } },
2095     { &hf_protocol_data_sls,                { "SLS",                          "m3ua.protocol_data_sls",                     FT_UINT8,  BASE_DEC,  NULL,                                         0x0, "Signalling Link Selection",       HFILL } },
2096     { &hf_protocol_data_mtp3_sls,           { "SLS",                          "mtp3.sls",                                   FT_UINT8,  BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2097     { &hf_correlation_identifier,           { "Correlation Identifier",       "m3ua.correlation_identifier",                FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2098     { &hf_registration_status,              { "Registration status",          "m3ua.registration_status",                   FT_UINT32, BASE_DEC,  VALS(registration_status_values),             0x0, NULL,                              HFILL } },
2099     { &hf_deregistration_status,            { "Deregistration status",        "m3ua.deregistration_status",                 FT_UINT32, BASE_DEC,  VALS(deregistration_status_values),           0x0, NULL,                              HFILL } },
2100     { &hf_registration_result_identifier,   { "Local RK-identifier value",    "m3ua.registration_result_identifier",        FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2101     { &hf_registration_result_status,       { "Registration status",          "m3ua.registration_results_status",           FT_UINT32, BASE_DEC,  VALS(registration_result_status_values),      0x0, NULL,                              HFILL } },
2102     { &hf_registration_result_context,      { "Routing context",              "m3ua.registration_result_routing_context",   FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2103     { &hf_v6_deregistration_result_status,  { "De-Registration status",       "m3ua.deregistration_results_status",         FT_UINT32, BASE_DEC,  VALS(v6_deregistration_result_status_values), 0x0, NULL,                              HFILL } },
2104     { &hf_v6_deregistration_result_context, { "Routing context",              "m3ua.deregistration_result_routing_context", FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2105     { &hf_heuristic_standard,               { "Heuristic standard",           "m3ua.heuristic_standard",                    FT_UINT32, BASE_DEC,  NULL,                                         0x0, NULL,                              HFILL } },
2106   };
2107 
2108   /* Setup protocol subtree array */
2109   static gint *ett[] = {
2110     &ett_m3ua,
2111     &ett_parameter,
2112     &ett_mtp3_equiv,
2113     &ett_q708_opc,
2114     &ett_q708_dpc,
2115   };
2116 
2117   static const enum_val_t options[] = {
2118     { "draft-5", "Internet Draft version 5",        M3UA_V5  },
2119     { "draft-6", "Internet Draft version 6",        M3UA_V6  },
2120     { "draft-7", "Internet Draft version 7",        M3UA_V7  },
2121     { "rfc4666", "RFC 4666",                        M3UA_RFC },
2122     { NULL, NULL, 0 }
2123   };
2124 
2125   /* Register the protocol name and description */
2126   proto_m3ua = proto_register_protocol("MTP 3 User Adaptation Layer", "M3UA",  "m3ua");
2127   m3ua_handle = register_dissector("m3ua", dissect_m3ua, proto_m3ua);
2128 
2129   m3ua_module = prefs_register_protocol(proto_m3ua, NULL);
2130   prefs_register_enum_preference(m3ua_module, "version", "M3UA Version", "Version used by Wireshark", &version, options, FALSE);
2131 
2132   /* Required function calls to register the header fields and subtrees used */
2133   proto_register_field_array(proto_m3ua, hf, array_length(hf));
2134   proto_register_subtree_array(ett, array_length(ett));
2135 
2136   m3ua_tap = register_tap("m3ua");
2137 
2138 }
2139 
2140 void
proto_reg_handoff_m3ua(void)2141 proto_reg_handoff_m3ua(void)
2142 {
2143 
2144   /*
2145    * Get a handle for the MTP3 dissector.
2146    */
2147   mtp3_handle = find_dissector_add_dependency("mtp3", proto_m3ua);
2148   dissector_add_uint("sctp.ppi",  M3UA_PAYLOAD_PROTOCOL_ID, m3ua_handle);
2149   dissector_add_uint("sctp.port", SCTP_PORT_M3UA, m3ua_handle);
2150 
2151   si_dissector_table = find_dissector_table("mtp3.service_indicator");
2152 
2153   ss7pc_address_type = address_type_get_by_name("AT_SS7PC");
2154 }
2155 
2156 /*
2157  * Editor modelines  -  https://www.wireshark.org/tools/modelines.html
2158  *
2159  * Local Variables:
2160  * c-basic-offset: 2
2161  * tab-width: 8
2162  * indent-tabs-mode: nil
2163  * End:
2164  *
2165  * ex: set shiftwidth=2 tabstop=8 expandtab:
2166  * :indentSize=2:tabSize=8:noTabs=true:
2167  */
2168