epan/epan.c

   1 /* epan.c
   2  *
   3  * $Id$
   4  *
   5  * Wireshark Protocol Analyzer Library
   6  *
   7  * Copyright (c) 2001 by Gerald Combs <gerald@wireshark.org>
   8  *
   9  * This program is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU General Public License
  11  * as published by the Free Software Foundation; either version 2
  12  * of the License, or (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  22  */
  23
  24 #include "config.h"
  25
  26 #ifdef HAVE_PYTHON
  27 #include <Python.h> /* to get the Python version number (PY_VERSION) */
  28 #endif
  29
  30 #ifdef HAVE_LIBGCRYPT
  31 #include <wsutil/wsgcrypt.h>
  32 #endif /* HAVE_LIBGCRYPT */
  33
  34 #ifdef HAVE_LIBGNUTLS
  35 #include <gnutls/gnutls.h>
  36 #endif /* HAVE_LIBGNUTLS */
  37
  38 #include <glib.h>
  39 #include "epan-int.h"
  40 #include "epan.h"
  41 #include "epan_dissect.h"
  42 #include "wsutil/report_err.h"
  43
  44 #include "conversation.h"
  45 #include "circuit.h"
  46 #include "except.h"
  47 #include "packet.h"
  48 #include "prefs.h"
  49 #include "column-utils.h"
  50 #include "tap.h"
  51 #include "addr_resolv.h"
  52 #include "oids.h"
  53 #include "emem.h"
  54 #include "wmem/wmem.h"
  55 #include "expert.h"
  56
  57 #ifdef HAVE_LUA
  58 #include <lua.h>
  59 #include <wslua/wslua.h>
  60 #endif
  61
  62 #ifdef HAVE_LIBSMI
  63 #include <smi.h>
  64 #endif
  65
  66 #ifdef HAVE_C_ARES
  67 #include <ares_version.h>
  68 #endif
  69
  70 const gchar*
  71 epan_get_version(void) {
  72         return VERSION;
  73 }
  74
  75 void
  76 epan_init(void (*register_all_protocols_func)(register_cb cb, gpointer client_data),
  77           void (*register_all_handoffs_func)(register_cb cb, gpointer client_data),
  78           register_cb cb,
  79           gpointer client_data,
  80           void (*report_failure_fcn_p)(const char *, va_list),
  81           void (*report_open_failure_fcn_p)(const char *, int, gboolean),
  82           void (*report_read_failure_fcn_p)(const char *, int),
  83           void (*report_write_failure_fcn_p)(const char *, int))
  84 {
  85         init_report_err(report_failure_fcn_p, report_open_failure_fcn_p,
  86             report_read_failure_fcn_p, report_write_failure_fcn_p);
  87
  88         /* initialize memory allocation subsystems */
  89         emem_init();
  90         wmem_init();
  91
  92         /* initialize the GUID to name mapping table */
  93         guids_init();
  94
  95         /* initialize name resolution (addr_resolv.c) */
  96         addr_resolv_init();
  97
  98         except_init();
  99 #ifdef HAVE_LIBGCRYPT
 100         /* initialize libgcrypt (beware, it won't be thread-safe) */
 101         gcry_check_version(NULL);
 102         gcry_control (GCRYCTL_DISABLE_SECMEM, 0);
 103         gcry_control (GCRYCTL_INITIALIZATION_FINISHED, 0);
 104 #endif
 105 #ifdef HAVE_LIBGNUTLS
 106         gnutls_global_init();
 107 #endif
 108         tap_init();
 109         prefs_init();
 110         expert_init();
 111         proto_init(register_all_protocols_func, register_all_handoffs_func,
 112             cb, client_data);
 113         packet_init();
 114         dfilter_init();
 115         final_registration_all_protocols();
 116         expert_packet_init();
 117 #ifdef HAVE_LUA
 118         wslua_init(cb, client_data);
 119 #endif
 120 }
 121
 122 void
 123 epan_cleanup(void)
 124 {
 125         cleanup_dissection();
 126         dfilter_cleanup();
 127         proto_cleanup();
 128         prefs_cleanup();
 129         packet_cleanup();
 130         expert_cleanup();
 131         oid_resolv_cleanup();
 132 #ifdef HAVE_LIBGNUTLS
 133         gnutls_global_deinit();
 134 #endif
 135         except_deinit();
 136         addr_resolv_cleanup();
 137         wmem_cleanup();
 138 }
 139
 140 epan_t *
 141 epan_new(void)
 142 {
 143         epan_t *session = g_slice_new(epan_t);
 144
 145         /* XXX, it should take session as param */
 146         init_dissection();
 147
 148         return session;
 149 }
 150
 151 const char *
 152 epan_get_user_comment(const epan_t *session, const frame_data *fd)
 153 {
 154         if (session->get_user_comment)
 155                 return session->get_user_comment(session->data, fd);
 156
 157         return NULL;
 158 }
 159
 160 const char *
 161 epan_get_interface_name(const epan_t *session, guint32 interface_id)
 162 {
 163         if (session->get_interface_name)
 164                 return session->get_interface_name(session->data, interface_id);
 165
 166         return NULL;
 167 }
 168
 169 const nstime_t *
 170 epan_get_frame_ts(const epan_t *session, guint32 frame_num)
 171 {
 172         const nstime_t *abs_ts = NULL;
 173
 174         if (session->get_frame_ts)
 175                 abs_ts = session->get_frame_ts(session->data, frame_num);
 176
 177         if (!abs_ts)
 178                 g_warning("!!! couldn't get frame ts for %u !!!\n", frame_num);
 179
 180         return abs_ts;
 181 }
 182
 183 void
 184 epan_free(epan_t *session)
 185 {
 186         /* XXX, it should take session as param */
 187         cleanup_dissection();
 188
 189         g_slice_free(epan_t, session);
 190 }
 191
 192 void
 193 epan_conversation_init(void)
 194 {
 195         conversation_init();
 196 }
 197
 198 void
 199 epan_conversation_cleanup(void)
 200 {
 201         conversation_cleanup();
 202 }
 203
 204 void
 205 epan_circuit_init(void)
 206 {
 207         circuit_init();
 208 }
 209
 210 void
 211 epan_circuit_cleanup(void)
 212 {
 213         circuit_cleanup();
 214 }
 215
 216 epan_dissect_t*
 217 epan_dissect_init(epan_dissect_t *edt, epan_t *session, const gboolean create_proto_tree, const gboolean proto_tree_visible)
 218 {
 219         g_assert(edt);
 220
 221         edt->session = session;
 222         edt->pi.pool = wmem_allocator_new(WMEM_ALLOCATOR_SIMPLE);
 223
 224         if (create_proto_tree) {
 225                 edt->tree = proto_tree_create_root(&edt->pi);
 226                 proto_tree_set_visible(edt->tree, proto_tree_visible);
 227         }
 228         else {
 229                 edt->tree = NULL;
 230         }
 231
 232         edt->pi.dependent_frames = NULL;
 233
 234         return edt;
 235 }
 236
 237 epan_dissect_t*
 238 epan_dissect_new(epan_t *session, const gboolean create_proto_tree, const gboolean proto_tree_visible)
 239 {
 240         epan_dissect_t *edt;
 241
 242         edt = g_new0(epan_dissect_t, 1);
 243
 244         return epan_dissect_init(edt, session, create_proto_tree, proto_tree_visible);
 245 }
 246
 247 void
 248 epan_dissect_fake_protocols(epan_dissect_t *edt, const gboolean fake_protocols)
 249 {
 250         if (edt)
 251                 proto_tree_set_fake_protocols(edt->tree, fake_protocols);
 252 }
 253
 254 void
 255 epan_dissect_run(epan_dissect_t *edt, struct wtap_pkthdr *phdr,
 256         tvbuff_t *tvb, frame_data *fd, column_info *cinfo)
 257 {
 258 #ifdef HAVE_LUA
 259         wslua_prime_dfilter(edt); /* done before entering wmem scope */
 260 #endif
 261         wmem_enter_packet_scope();
 262         dissect_packet(edt, phdr, tvb, fd, cinfo);
 263
 264         /* free all memory allocated */
 265         ep_free_all();
 266         wmem_leave_packet_scope();
 267 }
 268
 269 void
 270 epan_dissect_run_with_taps(epan_dissect_t *edt, struct wtap_pkthdr *phdr,
 271         tvbuff_t *tvb, frame_data *fd, column_info *cinfo)
 272 {
 273         wmem_enter_packet_scope();
 274         tap_queue_init(edt);
 275         dissect_packet(edt, phdr, tvb, fd, cinfo);
 276         tap_push_tapped_queue(edt);
 277
 278         /* free all memory allocated */
 279         ep_free_all();
 280         wmem_leave_packet_scope();
 281 }
 282
 283 void
 284 epan_dissect_cleanup(epan_dissect_t* edt)
 285 {
 286         g_assert(edt);
 287
 288         g_slist_free(edt->pi.dependent_frames);
 289
 290         /* Free the data sources list. */
 291         free_data_sources(&edt->pi);
 292
 293         /* Free all tvb's chained from this tvb */
 294         tvb_free_chain(edt->tvb);
 295
 296         if (edt->tree) {
 297                 proto_tree_free(edt->tree);
 298         }
 299
 300         wmem_destroy_allocator(edt->pi.pool);
 301 }
 302
 303 void
 304 epan_dissect_free(epan_dissect_t* edt)
 305 {
 306         epan_dissect_cleanup(edt);
 307         g_free(edt);
 308 }
 309
 310 void
 311 epan_dissect_prime_dfilter(epan_dissect_t *edt, const dfilter_t* dfcode)
 312 {
 313     dfilter_prime_proto_tree(dfcode, edt->tree);
 314 }
 315
 316 /* ----------------------- */
 317 const gchar *
 318 epan_custom_set(epan_dissect_t *edt, int field_id,
 319                              gint occurrence,
 320                              gchar *result,
 321                              gchar *expr, const int size )
 322 {
 323     return proto_custom_set(edt->tree, field_id, occurrence, result, expr, size);
 324 }
 325
 326 void
 327 epan_dissect_fill_in_columns(epan_dissect_t *edt, const gboolean fill_col_exprs, const gboolean fill_fd_colums)
 328 {
 329     col_custom_set_edt(edt, edt->pi.cinfo);
 330     col_fill_in(&edt->pi, fill_col_exprs, fill_fd_colums);
 331 }
 332
 333 gboolean
 334 epan_dissect_packet_contains_field(epan_dissect_t* edt,
 335                                    const char *field_name)
 336 {
 337     GPtrArray* array;
 338     int        field_id;
 339     gboolean   contains_field;
 340
 341     if (!edt || !edt->tree)
 342         return FALSE;
 343     field_id = proto_get_id_by_filter_name(field_name);
 344     if (field_id < 0)
 345         return FALSE;
 346     array = proto_find_finfo(edt->tree, field_id);
 347     contains_field = (array->len > 0) ? TRUE : FALSE;
 348     g_ptr_array_free(array, TRUE);
 349     return contains_field;
 350 }
 351
 352 /*
 353  * Get compile-time information for libraries used by libwireshark.
 354  */
 355 void
 356 epan_get_compiled_version_info(GString *str)
 357 {
 358         /* SNMP */
 359         g_string_append(str, ", ");
 360 #ifdef HAVE_LIBSMI
 361         g_string_append(str, "with SMI " SMI_VERSION_STRING);
 362 #else /* no SNMP library */
 363         g_string_append(str, "without SMI");
 364 #endif /* _SMI_H */
 365
 366         /* c-ares */
 367         g_string_append(str, ", ");
 368 #ifdef HAVE_C_ARES
 369         g_string_append(str, "with c-ares " ARES_VERSION_STR);
 370 #else
 371         g_string_append(str, "without c-ares");
 372
 373         /* ADNS - only add if no c-ares */
 374         g_string_append(str, ", ");
 375 #ifdef HAVE_GNU_ADNS
 376         g_string_append(str, "with ADNS");
 377 #else
 378         g_string_append(str, "without ADNS");
 379 #endif /* HAVE_GNU_ADNS */
 380 #endif /* HAVE_C_ARES */
 381
 382         /* LUA */
 383         g_string_append(str, ", ");
 384 #ifdef HAVE_LUA
 385         g_string_append(str, "with ");
 386         g_string_append(str, LUA_VERSION);
 387 #else
 388         g_string_append(str, "without Lua");
 389 #endif /* HAVE_LUA */
 390
 391         g_string_append(str, ", ");
 392 #ifdef HAVE_PYTHON
 393         g_string_append(str, "with Python");
 394 #ifdef PY_VERSION
 395         g_string_append(str, " " PY_VERSION);
 396 #endif /* PY_VERSION */
 397 #else
 398         g_string_append(str, "without Python");
 399 #endif /* HAVE_PYTHON */
 400
 401         /* GnuTLS */
 402         g_string_append(str, ", ");
 403 #ifdef HAVE_LIBGNUTLS
 404         g_string_append(str, "with GnuTLS " LIBGNUTLS_VERSION);
 405 #else
 406         g_string_append(str, "without GnuTLS");
 407 #endif /* HAVE_LIBGNUTLS */
 408
 409         /* Gcrypt */
 410         g_string_append(str, ", ");
 411 #ifdef HAVE_LIBGCRYPT
 412         g_string_append(str, "with Gcrypt " GCRYPT_VERSION);
 413 #else
 414         g_string_append(str, "without Gcrypt");
 415 #endif /* HAVE_LIBGCRYPT */
 416
 417         /* Kerberos */
 418         /* XXX - I don't see how to get the version number, at least for KfW */
 419         g_string_append(str, ", ");
 420 #ifdef HAVE_KERBEROS
 421 #ifdef HAVE_MIT_KERBEROS
 422         g_string_append(str, "with MIT Kerberos");
 423 #else
 424         /* HAVE_HEIMDAL_KERBEROS */
 425         g_string_append(str, "with Heimdal Kerberos");
 426 #endif
 427 #else
 428         g_string_append(str, "without Kerberos");
 429 #endif /* HAVE_KERBEROS */
 430
 431         /* GeoIP */
 432         g_string_append(str, ", ");
 433 #ifdef HAVE_GEOIP
 434         g_string_append(str, "with GeoIP");
 435 #else
 436         g_string_append(str, "without GeoIP");
 437 #endif /* HAVE_GEOIP */
 438
 439 }
 440
 441 /*
 442  * Get runtime information for libraries used by libwireshark.
 443  */
 444 void
 445 epan_get_runtime_version_info(GString *str
 446 #if !defined(HAVE_LIBGNUTLS) && !defined(HAVE_LIBGCRYPT)
 447 _U_
 448 #endif
 449 )
 450 {
 451         /* GnuTLS */
 452 #ifdef HAVE_LIBGNUTLS
 453         g_string_append_printf(str, ", GnuTLS %s", gnutls_check_version(NULL));
 454 #endif /* HAVE_LIBGNUTLS */
 455
 456         /* Gcrypt */
 457 #ifdef HAVE_LIBGCRYPT
 458         g_string_append_printf(str, ", Gcrypt %s", gcry_check_version(NULL));
 459 #endif /* HAVE_LIBGCRYPT */
 460 }
 461
 462 /*
 463  * Editor modelines  -  http://www.wireshark.org/tools/modelines.html
 464  *
 465  * Local variables:
 466  * c-basic-offset: 8
 467  * tab-width: 8
 468  * indent-tabs-mode: t
 469  * End:
 470  *
 471  * vi: set shiftwidth=8 tabstop=8 noexpandtab:
 472  * :indentSize=8:tabSize=8:noTabs=false:
 473  */