epan.h

Go to the documentation of this file.

 
#ifndef __EPAN_H__
#define __EPAN_H__
 
#include <wireshark.h>
 
#include <wsutil/feature_list.h>
#include <epan/tvbuff.h>
#include <epan/prefs.h>
#include <epan/frame_data.h>
#include <epan/register.h>
#include <wiretap/wtap_opttypes.h>
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
extern gboolean wireshark_abort_on_dissector_bug;
extern gboolean wireshark_abort_on_too_many_items;
 
typedef struct epan_dissect epan_dissect_t;
 
struct epan_dfilter;
struct epan_column_info;
 
struct packet_provider_data;
 
struct packet_provider_funcs {
    const nstime_t *(*get_frame_ts)(struct packet_provider_data *prov, guint32 frame_num);
    const char *(*get_interface_name)(struct packet_provider_data *prov, guint32 interface_id, unsigned section_number);
    const char *(*get_interface_description)(struct packet_provider_data *prov, guint32 interface_id, unsigned section_number);
    wtap_block_t (*get_modified_block)(struct packet_provider_data *prov, const frame_data *fd);
};
 
/*
Ref 1
Epan
Enhanced Packet ANalyzer, aka the packet analyzing engine. Source code can be found in the epan directory.
 
Protocol-Tree - Keep data of the capture file protocol information.
 
Dissectors - The various protocol dissectors in epan/dissectors.
 
Plugins - Some of the protocol dissectors are implemented as plugins. Source code can be found at plugins.
 
Display-Filters - the display filter engine at epan/dfilter
 
 
 
Ref2 for further edits - delete when done
    \section Introduction
 
    This document describes the data structures and the functions exported by the CACE Technologies AirPcap library.
    The AirPcap library provides low-level access to the AirPcap driver including advanced capabilities such as channel setting,
    link type control and WEP configuration.<br>
    This manual includes the following sections:
 
    \note throughout this documentation, \e device refers to a physical USB AirPcap device, while \e adapter is an open API
    instance. Most of the AirPcap API operations are adapter-specific but some of them, like setting the channel, are
    per-device and will be reflected on all the open adapters. These functions will have "Device" in their name, e.g.
    AirpcapSetDeviceChannel().
 
    \b Sections:
 
    - \ref airpcapfuncs
    - \ref airpcapdefs
    - \ref radiotap
*/
 
WS_DLL_PUBLIC
gboolean epan_init(register_cb cb, void *client_data, gboolean load_plugins);
 
WS_DLL_PUBLIC
e_prefs *epan_load_settings(void);
 
WS_DLL_PUBLIC
void epan_cleanup(void);
 
typedef struct {
    void (*init)(void);     /* Called before proto_init() */
    void (*post_init)(void);    /* Called at the end of epan_init() */
    void (*dissect_init)(epan_dissect_t *);
    void (*dissect_cleanup)(epan_dissect_t *);
    void (*cleanup)(void);
    void (*register_all_protocols)(register_cb, gpointer);
    void (*register_all_handoffs)(register_cb, gpointer);
    void (*register_all_tap_listeners)(void);
} epan_plugin;
 
WS_DLL_PUBLIC void epan_register_plugin(const epan_plugin *plugin);
 
WS_DLL_PUBLIC int epan_plugins_supported(void);
 
void epan_conversation_init(void);
 
typedef struct epan_session epan_t;
 
WS_DLL_PUBLIC epan_t *epan_new(struct packet_provider_data *prov,
    const struct packet_provider_funcs *funcs);
 
WS_DLL_PUBLIC wtap_block_t epan_get_modified_block(const epan_t *session, const frame_data *fd);
 
WS_DLL_PUBLIC const char *epan_get_interface_name(const epan_t *session, guint32 interface_id, unsigned section_number);
 
WS_DLL_PUBLIC const char *epan_get_interface_description(const epan_t *session, guint32 interface_id, unsigned section_number);
 
const nstime_t *epan_get_frame_ts(const epan_t *session, guint32 frame_num);
 
WS_DLL_PUBLIC void epan_free(epan_t *session);
 
WS_DLL_PUBLIC const gchar*
epan_get_version(void);
 
WS_DLL_PUBLIC void epan_get_version_number(int *major, int *minor, int *micro);
 
WS_DLL_PUBLIC
void epan_set_always_visible(gboolean force);
 
WS_DLL_PUBLIC
void
epan_dissect_init(epan_dissect_t *edt, epan_t *session, const gboolean create_proto_tree, const gboolean proto_tree_visible);
 
WS_DLL_PUBLIC
epan_dissect_t*
epan_dissect_new(epan_t *session, const gboolean create_proto_tree, const gboolean proto_tree_visible);
 
WS_DLL_PUBLIC
void
epan_dissect_reset(epan_dissect_t *edt);
 
WS_DLL_PUBLIC
void
epan_dissect_fake_protocols(epan_dissect_t *edt, const gboolean fake_protocols);
 
WS_DLL_PUBLIC
void
epan_dissect_run(epan_dissect_t *edt, int file_type_subtype,
        wtap_rec *rec, tvbuff_t *tvb, frame_data *fd,
        struct epan_column_info *cinfo);
 
WS_DLL_PUBLIC
void
epan_dissect_run_with_taps(epan_dissect_t *edt, int file_type_subtype,
        wtap_rec *rec, tvbuff_t *tvb, frame_data *fd,
        struct epan_column_info *cinfo);
 
WS_DLL_PUBLIC
void
epan_dissect_file_run(epan_dissect_t *edt, wtap_rec *rec,
        tvbuff_t *tvb, frame_data *fd, struct epan_column_info *cinfo);
 
WS_DLL_PUBLIC
void
epan_dissect_file_run_with_taps(epan_dissect_t *edt, wtap_rec *rec,
        tvbuff_t *tvb, frame_data *fd, struct epan_column_info *cinfo);
 
WS_DLL_PUBLIC
void
epan_dissect_prime_with_dfilter(epan_dissect_t *edt, const struct epan_dfilter *dfcode);
 
WS_DLL_PUBLIC
void
epan_dissect_prime_with_hfid(epan_dissect_t *edt, int hfid);
 
WS_DLL_PUBLIC
void
epan_dissect_prime_with_hfid_array(epan_dissect_t *edt, GArray *hfids);
 
WS_DLL_PUBLIC
void
epan_dissect_fill_in_columns(epan_dissect_t *edt, const gboolean fill_col_exprs, const gboolean fill_fd_colums);
 
WS_DLL_PUBLIC
gboolean
epan_dissect_packet_contains_field(epan_dissect_t* edt,
                                   const char *field_name);
 
WS_DLL_PUBLIC
void
epan_dissect_cleanup(epan_dissect_t* edt);
 
WS_DLL_PUBLIC
void
epan_dissect_free(epan_dissect_t* edt);
 
const gchar *
epan_custom_set(epan_dissect_t *edt, GSList *ids, gint occurrence,
                gchar *result, gchar *expr, const int size);
 
WS_DLL_PUBLIC
void
epan_gather_compile_info(feature_list l);
 
WS_DLL_PUBLIC
void
epan_gather_runtime_info(feature_list l);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* __EPAN_H__ */