#include <glib.h>
#include "frame_data.h"
#include "column_info.h"
+#include "register.h"
typedef struct _epan_dissect_t epan_dissect_t;
#include "dfilter/dfilter.h"
-/* init the whole epan module, this is used to be called only once in a program */
-void epan_init(const char * plugindir, void (*register_all_protocols)(void),
- void (*register_all_handoffs)(void),
- void (*report_failure)(const char *, va_list),
- void (*report_open_failure)(const char *, int, gboolean),
- void (*report_read_failure)(const char *, int));
-/* cleanup the whole epan module, this is used to be called only once in a program */
+/**
+ @mainpage Wireshark EPAN the packet analyzing engine. Source code can be found in the epan directory
+
+ @section Introduction
+
+ XXX
+
+ @b Sections:
+ - \ref proto_pub
+*/
+/*
+Ref 1
+Epan
+Ethereal Packet ANalyzer (XXX - is this correct?) 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
+*/
+/** init the whole epan module, this is used to be called only once in a program */
+void epan_init(void (*register_all_protocols_func)(register_cb cb, gpointer client_data),
+ void (*register_all_handoffs_func)(register_cb cb, gpointer client_data),
+ register_cb cb,
+ void *client_data,
+ void (*report_failure_fcn_p)(const char *, va_list),
+ void (*report_open_failure_fcn_p)(const char *, int, gboolean),
+ void (*report_read_failure_fcn_p)(const char *, int),
+ void (*report_write_failure_fcn_p)(const char *, int));
+
+/** cleanup the whole epan module, this is used to be called only once in a program */
void epan_cleanup(void);
-/* Initialize the table of conversations. */
+
+/**
+ * Initialize the table of conversations. Conversations are identified by
+ * their endpoints; they are used for protocols such as IP, TCP, and UDP,
+ * where packets contain endpoint information but don't contain a single
+ * value indicating to which flow the packet belongs.
+ */
void epan_conversation_init(void);
-/* Initialize the table of circuits. */
-/* XXX - what is a circuit and should this better be combined with epan_conversation_init? */
+void epan_conversation_cleanup(void);
+
+/**
+ * Initialize the table of circuits. Circuits are identified by a
+ * circuit ID; they are used for protocols where packets *do* contain
+ * a circuit ID value indicating to which flow the packet belongs.
+ *
+ * We might want to make a superclass for both endpoint-specified
+ * conversations and circuit ID-specified circuits, so we can attach
+ * information either to a circuit or a conversation with common
+ * code.
+ */
void epan_circuit_init(void);
+void epan_circuit_cleanup(void);
-/* A client will create one epan_t for an entire dissection session.
+/** A client will create one epan_t for an entire dissection session.
* A single epan_t will be used to analyze the entire sequence of packets,
* sequentially, in a single session. A session corresponds to a single
* packet trace file. The reaons epan_t exists is that some packets in
void
epan_free(epan_t*);
+extern const gchar*
+epan_get_version(void);
-/* get a new single packet dissection */
-/* should be freed using epan_dissect_free() after packet dissection completed */
+/** initialize an existing single packet dissection */
epan_dissect_t*
-epan_dissect_new(gboolean create_proto_tree, gboolean proto_tree_visible);
+epan_dissect_init(epan_dissect_t *edt, const gboolean create_proto_tree, const gboolean proto_tree_visible);
-/* run a single packet dissection */
+/** get a new single packet dissection
+ * should be freed using epan_dissect_free() after packet dissection completed
+ */
+epan_dissect_t*
+epan_dissect_new(const gboolean create_proto_tree, const gboolean proto_tree_visible);
+
+/** Indicate whether we should fake protocols or not */
+void
+epan_dissect_fake_protocols(epan_dissect_t *edt, const gboolean fake_protocols);
+
+/** run a single packet dissection */
void
epan_dissect_run(epan_dissect_t *edt, void* pseudo_header,
const guint8* data, frame_data *fd, column_info *cinfo);
-/* Prime a proto_tree using the fields/protocols used in a dfilter. */
+/** Prime a proto_tree using the fields/protocols used in a dfilter. */
void
epan_dissect_prime_dfilter(epan_dissect_t *edt, const dfilter_t *dfcode);
-/* fill the dissect run output into the packet list columns */
+/** fill the dissect run output into the packet list columns */
void
-epan_dissect_fill_in_columns(epan_dissect_t *edt);
+epan_dissect_fill_in_columns(epan_dissect_t *edt, const gboolean fill_col_exprs, const gboolean fill_fd_colums);
-/* free a single packet dissection */
+/** releases resources attached to the packet dissection. DOES NOT free the actual pointer */
+void
+epan_dissect_cleanup(epan_dissect_t* edt);
+
+/** free a single packet dissection */
void
epan_dissect_free(epan_dissect_t* edt);
+/** Sets custom column */
+const gchar *
+epan_custom_set(epan_dissect_t *edt, int id, gint occurrence,
+ gchar *result, gchar *expr, const int size);
+
+/**
+ * Get compile-time information for libraries used by libwireshark.
+ */
+void
+epan_get_compiled_version_info(GString *str);
+
+/**
+ * Get runtime information for libraries used by libwireshark.
+ */
+void
+epan_get_runtime_version_info(GString *str);
+
#endif /* EPAN_H */