epan/gcp.h

   1 /* gcp.h
   2  * Gateway Control Protocol -- Context Tracking
   3  *
   4  * $Id$
   5  *
   6  * Wireshark - Network traffic analyzer
   7  * By Gerald Combs <gerald@wireshark.org>
   8  * Copyright 1998 Gerald Combs
   9  *
  10  * This program is free software; you can redistribute it and/or
  11  * modify it under the terms of the GNU General Public License
  12  * as published by the Free Software Foundation; either version 2
  13  * of the License, or (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  23  */
  24 #ifndef __GCP_H_
  25 #define __GCP_H_
  26
  27 #include <glib.h>
  28 #include <epan/packet.h>
  29 #include <epan/conversation.h>
  30 #include <epan/strutil.h>
  31 #include <epan/wmem/wmem.h>
  32 #include <epan/expert.h>
  33 #include <epan/prefs.h>
  34 #include <epan/to_str.h>
  35 #include <epan/asn1.h>
  36
  37 #include <stdio.h>
  38 #include <string.h>
  39
  40 #include <epan/dissectors/packet-ber.h>
  41 #include <epan/dissectors/packet-q931.h>
  42 #include <epan/dissectors/packet-mtp3.h>
  43 #include <epan/dissectors/packet-alcap.h>
  44 #include <epan/dissectors/packet-isup.h>
  45
  46 #include <epan/sctpppids.h>
  47 #include "ws_symbol_export.h"
  48
  49 typedef struct _gcp_hf_ett_t {
  50     struct {
  51         int ctx;
  52         int ctx_cmd;
  53         int ctx_term;
  54         int ctx_term_type;
  55         int ctx_term_bir;
  56         int ctx_term_nsap;
  57     } hf;
  58
  59     struct {
  60         gint ctx;
  61         gint ctx_cmds;
  62         gint ctx_terms;
  63         gint ctx_term;
  64     } ett;
  65 } gcp_hf_ett_t;
  66
  67 #define NULL_CONTEXT 0
  68 #define CHOOSE_CONTEXT 0xFFFFFFFE
  69 #define ALL_CONTEXTS 0xFFFFFFFF
  70
  71
  72 typedef enum {
  73     GCP_CMD_NONE,
  74     GCP_CMD_ADD_REQ,
  75     GCP_CMD_MOVE_REQ,
  76     GCP_CMD_MOD_REQ,
  77     GCP_CMD_SUB_REQ,
  78     GCP_CMD_AUDITCAP_REQ,
  79     GCP_CMD_AUDITVAL_REQ,
  80     GCP_CMD_NOTIFY_REQ,
  81     GCP_CMD_SVCCHG_REQ,
  82     GCP_CMD_TOPOLOGY_REQ,
  83     GCP_CMD_CTX_ATTR_AUDIT_REQ,
  84     GCP_CMD_OTHER_REQ,
  85     GCP_CMD_ADD_REPLY,
  86     GCP_CMD_MOVE_REPLY,
  87     GCP_CMD_MOD_REPLY,
  88     GCP_CMD_SUB_REPLY,
  89     GCP_CMD_AUDITCAP_REPLY,
  90     GCP_CMD_AUDITVAL_REPLY,
  91     GCP_CMD_NOTIFY_REPLY,
  92     GCP_CMD_SVCCHG_REPLY,
  93     GCP_CMD_TOPOLOGY_REPLY,
  94     GCP_CMD_REPLY
  95 } gcp_cmd_type_t;
  96
  97 typedef enum {
  98     GCP_TRX_NONE,
  99     GCP_TRX_REQUEST,
 100     GCP_TRX_PENDING,
 101     GCP_TRX_REPLY,
 102     GCP_TRX_ACK
 103 } gcp_trx_type_t;
 104
 105
 106 typedef struct _gcp_msg_t {
 107     guint32 lo_addr;
 108     guint32 hi_addr;
 109     guint32 framenum;
 110     nstime_t time;
 111     struct _gcp_trx_msg_t* trxs;
 112     gboolean commited;
 113 } gcp_msg_t;
 114
 115 typedef struct _gcp_trx_msg_t {
 116     struct _gcp_trx_t* trx;
 117     struct _gcp_trx_msg_t* next;
 118     struct _gcp_trx_msg_t* last;
 119 } gcp_trx_msg_t;
 120
 121 typedef struct _gcp_cmd_msg_t {
 122     struct _gcp_cmd_t* cmd;
 123     struct _gcp_cmd_msg_t* next;
 124     struct _gcp_cmd_msg_t* last;
 125 } gcp_cmd_msg_t;
 126
 127 typedef struct _gcp_trx_t {
 128     gcp_msg_t* initial;
 129     guint32 id;
 130     gcp_trx_type_t type;
 131     guint pendings;
 132     struct _gcp_cmd_msg_t* cmds;
 133     struct _gcp_trx_ctx_t* ctxs;
 134     guint error;
 135 } gcp_trx_t;
 136
 137 #define GCP_TERM_TYPE_UNKNOWN 0
 138 #define GCP_TERM_TYPE_AAL1 1
 139 #define GCP_TERM_TYPE_AAL2 2
 140 #define GCP_TERM_TYPE_AAL1_STRUCT 3
 141 #define GCP_TERM_TYPE_IP_RTP 4
 142 #define GCP_TERM_TYPE_TDM 5
 143
 144 typedef enum _gcp_wildcard_t {
 145     GCP_WILDCARD_NONE,
 146     GCP_WILDCARD_CHOOSE,
 147     GCP_WILDCARD_ALL
 148 } gcp_wildcard_t;
 149
 150 typedef struct _gcp_term_t {
 151     const gchar* str;
 152
 153     const guint8* buffer;
 154     guint len;
 155
 156     guint type;
 157     gchar* bir;
 158     gchar* nsap;
 159
 160     gcp_msg_t* start;
 161
 162 } gcp_term_t;
 163
 164 typedef struct _gcp_terms_t {
 165     gcp_term_t* term;
 166     struct _gcp_terms_t* next;
 167     struct _gcp_terms_t* last;
 168 } gcp_terms_t;
 169
 170 typedef struct _gcp_cmd_t {
 171     guint offset;
 172     const gchar* str;
 173     gcp_cmd_type_t type;
 174     gcp_terms_t terms;
 175     struct _gcp_msg_t* msg;
 176     struct _gcp_trx_t* trx;
 177     struct _gcp_ctx_t* ctx;
 178     guint error;
 179 } gcp_cmd_t;
 180
 181
 182 typedef struct _gcp_ctx_t {
 183     gcp_msg_t* initial;
 184     guint32 id;
 185     struct _gcp_cmd_msg_t* cmds;
 186     struct _gcp_ctx_t* prev;
 187     gcp_terms_t terms;
 188 } gcp_ctx_t;
 189
 190 WS_DLL_PUBLIC const value_string gcp_cmd_type[];
 191 WS_DLL_PUBLIC const value_string gcp_term_types[];
 192
 193 extern void gcp_init(void);
 194 extern gcp_msg_t* gcp_msg(packet_info* pinfo, int o, gboolean persistent);
 195 extern gcp_trx_t* gcp_trx(gcp_msg_t* m ,guint32 t_id , gcp_trx_type_t type, gboolean persistent);
 196 extern gcp_ctx_t* gcp_ctx(gcp_msg_t* m, gcp_trx_t* t, guint32 c_id, gboolean persistent);
 197 extern gcp_cmd_t* gcp_cmd(gcp_msg_t* m, gcp_trx_t* t, gcp_ctx_t* c, gcp_cmd_type_t type, guint offset, gboolean persistent);
 198 extern gcp_term_t* gcp_cmd_add_term(gcp_msg_t* m, gcp_trx_t* tr, gcp_cmd_t* c, gcp_term_t* t, gcp_wildcard_t wildcard, gboolean persistent);
 199 extern void gcp_analyze_msg(proto_tree* gcp_tree, packet_info* pinfo, tvbuff_t* gcp_tvb, gcp_msg_t* m, gcp_hf_ett_t* ids, expert_field* command_err);
 200
 201 extern const gchar* gcp_cmd_to_str(gcp_cmd_t* c, gboolean persistent);
 202 extern const gchar* gcp_msg_to_str(gcp_msg_t* m, gboolean persistent);
 203
 204 #define gcp_cmd_set_error(c,e) (c->error = e)
 205 #define gcp_trx_set_error(t,e) (t->error = e)
 206
 207 #define GCP_ETT_ARR_ELEMS(gi)     &(gi.ett.ctx),&(gi.ett.ctx_cmds),&(gi.ett.ctx_terms),&(gi.ett.ctx_term)
 208
 209 #define GCP_HF_ARR_ELEMS(n,gi) \
 210   { &(gi.hf.ctx), { "Context", n ".ctx", FT_UINT32, BASE_HEX, NULL, 0, NULL, HFILL }}, \
 211   { &(gi.hf.ctx_term), { "Termination", n ".ctx.term", FT_STRING, BASE_NONE, NULL, 0, NULL, HFILL }}, \
 212   { &(gi.hf.ctx_term_type), { "Type", n ".ctx.term.type", FT_UINT32, BASE_HEX, VALS(gcp_term_types), 0, NULL, HFILL }}, \
 213   { &(gi.hf.ctx_term_bir), { "BIR", n ".ctx.term.bir", FT_STRING, BASE_NONE, NULL, 0, NULL, HFILL }}, \
 214   { &(gi.hf.ctx_term_nsap), { "NSAP", n ".ctx.term.nsap", FT_STRING, BASE_NONE, NULL, 0, NULL, HFILL }}, \
 215   { &(gi.hf.ctx_cmd), { "Command in Frame", n ".ctx.cmd", FT_FRAMENUM, BASE_NONE, NULL, 0, NULL, HFILL }}
 216
 217 #endif