epan/dissectors/asn1/dsp/packet-dsp-template.c

   1 /* packet-dsp.c
   2  * Routines for X.518 (X.500 Distributed Operations)  packet dissection
   3  * Graeme Lunt 2005
   4  *
   5  * Wireshark - Network traffic analyzer
   6  * By Gerald Combs <gerald@wireshark.org>
   7  * Copyright 1998 Gerald Combs
   8  *
   9  * SPDX-License-Identifier: GPL-2.0-or-later
  10  */
  11
  12 #include "config.h"
  13
  14 #include <epan/packet.h>
  15 #include <epan/expert.h>
  16 #include <epan/prefs.h>
  17 #include <epan/oids.h>
  18 #include <epan/asn1.h>
  19 #include <wsutil/array.h>
  20
  21 #include "packet-ber.h"
  22 #include "packet-acse.h"
  23 #include "packet-ros.h"
  24
  25 #include "packet-x509if.h"
  26 #include "packet-x509af.h"
  27 #include "packet-x509sat.h"
  28
  29 #include "packet-dap.h"
  30 #include "packet-dsp.h"
  31
  32
  33 #define PNAME  "X.519 Directory System Protocol"
  34 #define PSNAME "DSP"
  35 #define PFNAME "dsp"
  36
  37 void proto_register_dsp(void);
  38 void proto_reg_handoff_dsp(void);
  39
  40 /* Initialize the protocol and registered fields */
  41 static int proto_dsp;
  42
  43 #include "packet-dsp-hf.c"
  44
  45 /* Initialize the subtree pointers */
  46 static int ett_dsp;
  47 #include "packet-dsp-ett.c"
  48
  49 static expert_field ei_dsp_unsupported_opcode;
  50 static expert_field ei_dsp_unsupported_errcode;
  51 static expert_field ei_dsp_unsupported_pdu;
  52 static expert_field ei_dsp_zero_pdu;
  53
  54 #include "packet-dsp-fn.c"
  55
  56 static dissector_handle_t dsp_handle;
  57
  58 /*
  59 * Dissect X518 PDUs inside a ROS PDUs
  60 */
  61 static int
  62 dissect_dsp(tvbuff_t *tvb, packet_info *pinfo, proto_tree *parent_tree, void* data)
  63 {
  64         int offset = 0;
  65         int old_offset;
  66         proto_item *item;
  67         proto_tree *tree;
  68         struct SESSION_DATA_STRUCTURE* session;
  69         int (*dsp_dissector)(bool implicit_tag _U_, tvbuff_t *tvb, int offset, asn1_ctx_t *actx, proto_tree *tree, int hf_index _U_) = NULL;
  70         const char *dsp_op_name;
  71         asn1_ctx_t asn1_ctx;
  72
  73         /* do we have operation information from the ROS dissector? */
  74         if (data == NULL)
  75                 return 0;
  76         session  = (struct SESSION_DATA_STRUCTURE*)data;
  77
  78         asn1_ctx_init(&asn1_ctx, ASN1_ENC_BER, true, pinfo);
  79
  80         item = proto_tree_add_item(parent_tree, proto_dsp, tvb, 0, -1, ENC_NA);
  81         tree = proto_item_add_subtree(item, ett_dsp);
  82
  83         col_set_str(pinfo->cinfo, COL_PROTOCOL, "DAP");
  84         col_clear(pinfo->cinfo, COL_INFO);
  85
  86         asn1_ctx.private_data = session;
  87
  88         switch(session->ros_op & ROS_OP_MASK) {
  89         case (ROS_OP_BIND | ROS_OP_ARGUMENT):   /*  BindInvoke */
  90           dsp_dissector = dissect_dsp_DSASystemBindArgument;
  91           dsp_op_name = "System-Bind-Argument";
  92           break;
  93         case (ROS_OP_BIND | ROS_OP_RESULT):     /*  BindResult */
  94           dsp_dissector = dissect_dsp_DSASystemBindResult;
  95           dsp_op_name = "System-Bind-Result";
  96           break;
  97         case (ROS_OP_BIND | ROS_OP_ERROR):      /*  BindError */
  98           dsp_dissector = dissect_dsp_DSASystemBindError;
  99           dsp_op_name = "System-Bind-Error";
 100           break;
 101         case (ROS_OP_INVOKE | ROS_OP_ARGUMENT): /*  Invoke Argument */
 102           switch(session->ros_op & ROS_OP_OPCODE_MASK) {
 103           case 1: /* read */
 104             dsp_dissector = dissect_dsp_ChainedReadArgument;
 105             dsp_op_name = "Chained-Read-Argument";
 106             break;
 107           case 2: /* compare */
 108             dsp_dissector = dissect_dsp_ChainedCompareArgument;
 109             dsp_op_name = "Chained-Compare-Argument";
 110             break;
 111           case 3: /* abandon */
 112             dsp_dissector = dissect_dsp_ChainedAbandonArgument;
 113             dsp_op_name = "Chained-Abandon-Argument";
 114             break;
 115           case 4: /* list */
 116             dsp_dissector = dissect_dsp_ChainedListArgument;
 117             dsp_op_name = "Chained-List-Argument";
 118             break;
 119           case 5: /* search */
 120             dsp_dissector = dissect_dsp_ChainedSearchArgument;
 121             dsp_op_name = "Chained-Search-Argument";
 122             break;
 123           case 6: /* addEntry */
 124             dsp_dissector = dissect_dsp_ChainedAddEntryArgument;
 125             dsp_op_name = "Chained-Add-Entry-Argument";
 126             break;
 127           case 7: /* removeEntry */
 128             dsp_dissector = dissect_dsp_ChainedRemoveEntryArgument;
 129             dsp_op_name = "Chained-Remove-Entry-Argument";
 130             break;
 131           case 8: /* modifyEntry */
 132             dsp_dissector = dissect_dsp_ChainedModifyEntryArgument;
 133             dsp_op_name = "ChainedModify-Entry-Argument";
 134             break;
 135           case 9: /* modifyDN */
 136             dsp_dissector = dissect_dsp_ChainedModifyDNArgument;
 137             dsp_op_name = "ChainedModify-DN-Argument";
 138             break;
 139           default:
 140             proto_tree_add_expert_format(tree, pinfo, &ei_dsp_unsupported_opcode, tvb, offset, -1,
 141                 "Unsupported DSP opcode (%d)", session->ros_op & ROS_OP_OPCODE_MASK);
 142             break;
 143           }
 144           break;
 145         case (ROS_OP_INVOKE | ROS_OP_RESULT):   /*  Return Result */
 146           switch(session->ros_op & ROS_OP_OPCODE_MASK) {
 147           case 1: /* read */
 148             dsp_dissector = dissect_dsp_ChainedReadResult;
 149             dsp_op_name = "Chained-Read-Result";
 150             break;
 151           case 2: /* compare */
 152             dsp_dissector = dissect_dsp_ChainedCompareResult;
 153             dsp_op_name = "Chained-Compare-Result";
 154             break;
 155           case 3: /* abandon */
 156             dsp_dissector = dissect_dsp_ChainedAbandonResult;
 157             dsp_op_name = "Chained-Abandon-Result";
 158             break;
 159           case 4: /* list */
 160             dsp_dissector = dissect_dsp_ChainedListResult;
 161             dsp_op_name = "Chained-List-Result";
 162             break;
 163           case 5: /* search */
 164             dsp_dissector = dissect_dsp_ChainedSearchResult;
 165             dsp_op_name = "Chained-Search-Result";
 166             break;
 167           case 6: /* addEntry */
 168             dsp_dissector = dissect_dsp_ChainedAddEntryResult;
 169             dsp_op_name = "Chained-Add-Entry-Result";
 170             break;
 171           case 7: /* removeEntry */
 172             dsp_dissector = dissect_dsp_ChainedRemoveEntryResult;
 173             dsp_op_name = "Chained-Remove-Entry-Result";
 174             break;
 175           case 8: /* modifyEntry */
 176             dsp_dissector = dissect_dsp_ChainedModifyEntryResult;
 177             dsp_op_name = "Chained-Modify-Entry-Result";
 178             break;
 179           case 9: /* modifyDN */
 180             dsp_dissector = dissect_dsp_ChainedModifyDNResult;
 181             dsp_op_name = "ChainedModify-DN-Result";
 182             break;
 183           default:
 184             proto_tree_add_expert(tree, pinfo, &ei_dsp_unsupported_opcode, tvb, offset, -1);
 185             break;
 186           }
 187           break;
 188         case (ROS_OP_INVOKE | ROS_OP_ERROR):    /*  Return Error */
 189           switch(session->ros_op & ROS_OP_OPCODE_MASK) {
 190           case 1: /* attributeError */
 191             dsp_dissector = dissect_dap_AttributeError;
 192             dsp_op_name = "Attribute-Error";
 193             break;
 194           case 2: /* nameError */
 195             dsp_dissector = dissect_dap_NameError;
 196             dsp_op_name = "Name-Error";
 197             break;
 198           case 3: /* serviceError */
 199             dsp_dissector = dissect_dap_ServiceError;
 200             dsp_op_name = "Service-Error";
 201             break;
 202           case 4: /* referral */
 203             dsp_dissector = dissect_dap_Referral;
 204             dsp_op_name = "Referral";
 205             break;
 206           case 5: /* abandoned */
 207             dsp_dissector = dissect_dap_Abandoned;
 208             dsp_op_name = "Abandoned";
 209             break;
 210           case 6: /* securityError */
 211             dsp_dissector = dissect_dap_SecurityError;
 212             dsp_op_name = "Security-Error";
 213             break;
 214           case 7: /* abandonFailed */
 215             dsp_dissector = dissect_dap_AbandonFailedError;
 216             dsp_op_name = "Abandon-Failed-Error";
 217             break;
 218           case 8: /* updateError */
 219             dsp_dissector = dissect_dap_UpdateError;
 220             dsp_op_name = "Update-Error";
 221             break;
 222           case 9: /* DSAReferral */
 223             dsp_dissector = dissect_dsp_DSAReferral;
 224             dsp_op_name = "DSA-Referral";
 225             break;
 226           default:
 227             proto_tree_add_expert(tree, pinfo, &ei_dsp_unsupported_errcode, tvb, offset, -1);
 228             break;
 229           }
 230           break;
 231         default:
 232           proto_tree_add_expert(tree, pinfo, &ei_dsp_unsupported_pdu, tvb, offset, -1);
 233           return tvb_captured_length(tvb);
 234         }
 235
 236         if(dsp_dissector) {
 237     col_set_str(pinfo->cinfo, COL_INFO, dsp_op_name);
 238
 239           while (tvb_reported_length_remaining(tvb, offset) > 0){
 240             old_offset=offset;
 241             offset=(*dsp_dissector)(false, tvb, offset, &asn1_ctx, tree, -1);
 242             if(offset == old_offset){
 243               proto_tree_add_expert(tree, pinfo, &ei_dsp_zero_pdu, tvb, offset, -1);
 244               break;
 245             }
 246           }
 247         }
 248
 249         return tvb_captured_length(tvb);
 250 }
 251
 252
 253 /*--- proto_register_dsp -------------------------------------------*/
 254 void proto_register_dsp(void) {
 255
 256   /* List of fields */
 257   static hf_register_info hf[] =
 258   {
 259 #include "packet-dsp-hfarr.c"
 260   };
 261
 262   /* List of subtrees */
 263   static int *ett[] = {
 264     &ett_dsp,
 265 #include "packet-dsp-ettarr.c"
 266   };
 267   static ei_register_info ei[] = {
 268     { &ei_dsp_unsupported_opcode, { "dsp.unsupported_opcode", PI_UNDECODED, PI_WARN, "Unsupported DSP opcode", EXPFILL }},
 269     { &ei_dsp_unsupported_errcode, { "dsp.unsupported_errcode", PI_UNDECODED, PI_WARN, "Unsupported DSP errcode", EXPFILL }},
 270     { &ei_dsp_unsupported_pdu, { "dsp.unsupported_pdu", PI_UNDECODED, PI_WARN, "Unsupported DSP PDU", EXPFILL }},
 271     { &ei_dsp_zero_pdu, { "dsp.zero_pdu", PI_PROTOCOL, PI_ERROR, "Internal error, zero-byte DSP PDU", EXPFILL }},
 272   };
 273
 274   module_t *dsp_module;
 275   expert_module_t* expert_dsp;
 276
 277   /* Register protocol */
 278   proto_dsp = proto_register_protocol(PNAME, PSNAME, PFNAME);
 279
 280   dsp_handle = register_dissector("dsp", dissect_dsp, proto_dsp);
 281
 282   /* Register fields and subtrees */
 283   proto_register_field_array(proto_dsp, hf, array_length(hf));
 284   proto_register_subtree_array(ett, array_length(ett));
 285   expert_dsp = expert_register_protocol(proto_dsp);
 286   expert_register_field_array(expert_dsp, ei, array_length(ei));
 287
 288   /* Register our configuration options for DSP, particularly our port */
 289
 290   dsp_module = prefs_register_protocol_subtree("OSI/X.500", proto_dsp, NULL);
 291
 292   prefs_register_obsolete_preference(dsp_module, "tcp.port");
 293
 294   prefs_register_static_text_preference(dsp_module, "tcp_port_info",
 295             "The TCP ports used by the DSP protocol should be added to the TPKT preference \"TPKT TCP ports\", or by selecting \"TPKT\" as the \"Transport\" protocol in the \"Decode As\" dialog.",
 296             "DSP TCP Port preference moved information");
 297
 298 }
 299
 300
 301 /*--- proto_reg_handoff_dsp --- */
 302 void proto_reg_handoff_dsp(void) {
 303 #include "packet-dsp-dis-tab.c"
 304
 305   /* APPLICATION CONTEXT */
 306
 307   oid_add_from_string("id-ac-directory-system","2.5.3.2");
 308
 309   /* ABSTRACT SYNTAXES */
 310
 311   /* Register DSP with ROS (with no use of RTSE) */
 312   register_ros_oid_dissector_handle("2.5.9.2", dsp_handle, 0, "id-as-directory-system", false);
 313
 314 }