/* packet.h
* Definitions for packet disassembly structures and routines
*
- * $Id: packet.h,v 1.60 2002/08/28 20:40:44 jmayer Exp $
+ * $Id$
*
- * Ethereal - Network traffic analyzer
- * By Gerald Combs <gerald@ethereal.com>
+ * Wireshark - Network traffic analyzer
+ * By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* This program is free software; you can redistribute it and/or
#ifndef __PACKET_H__
#define __PACKET_H__
+/*
+ * If <inttypes.h> defines formats to be used to print 64-bit integers,
+ * include it.
+ */
+#ifdef INTTYPES_H_DEFINES_FORMATS
+#include <inttypes.h>
+#endif
+
#include "wiretap/wtap.h"
#include "proto.h"
#include "tvbuff.h"
/* Check whether the "len" bytes of data starting at "offset" is
* entirely inside the captured data for this packet. */
#define BYTES_ARE_IN_FRAME(offset, captured_len, len) \
- ((offset) + (len) <= (captured_len))
+ ((guint)(offset) + (guint)(len) > (guint)(offset) && \
+ (guint)(offset) + (guint)(len) <= (guint)(captured_len))
/* To pass one of two strings, singular or plural */
#define plurality(d,s,p) ((d) == 1 ? (s) : (p))
gint vines;
gint other;
gint total;
+ gint arp;
} packet_counts;
+/** Number of packet counts. */
+#define PACKET_COUNTS_SIZE sizeof(packet_counts) / sizeof (gint)
+
/* Types of character encodings */
typedef enum {
CHAR_ASCII = 0, /* ASCII */
/* Struct for boolean enumerations */
typedef struct true_false_string {
- char *true_string;
- char *false_string;
+ const char *true_string;
+ const char *false_string;
} true_false_string;
+/**
+* A default set of true/false strings that dissectors can use for
+* FT_BOOLEAN header fields.
+**/
extern const true_false_string flags_set_truth;
extern void packet_init(void);
/*
* Dissector that returns:
*
- * the amount of data in the protocol's PDU, if it was able to
+ * The amount of data in the protocol's PDU, if it was able to
* dissect all the data;
*
* 0, if the tvbuff doesn't contain a PDU for that protocol;
*
- * the negative of the amount of additional data needed, if
+ * The negative of the amount of additional data needed, if
* we need more data (e.g., from subsequent TCP segments) to
* dissect the entire PDU.
*/
typedef int (*new_dissector_t)(tvbuff_t *, packet_info *, proto_tree *);
-typedef void (*DATFunc) (gchar *table_name, gpointer key, gpointer value, gpointer user_data);
-typedef void (*DATFunc_handle) (gchar *table_name, gpointer value, gpointer user_data);
+/** Type of a heuristic dissector, used in heur_dissector_add().
+ *
+ * @param tvb the tv_buff with the (remaining) packet data
+ * @param pinfo the packet info of this packet (additional info)
+ * @param tree the protocol tree to be build or NULL
+ * @return TRUE if the packet was recognized by the sub-dissector (stop dissection here)
+ */
+typedef gboolean (*heur_dissector_t)(tvbuff_t *tvb, packet_info *pinfo,
+ proto_tree *tree);
+
+typedef void (*DATFunc) (gchar *table_name, ftenum_t selector_type,
+ gpointer key, gpointer value, gpointer user_data);
+typedef void (*DATFunc_handle) (const gchar *table_name, gpointer value,
+ gpointer user_data);
+typedef void (*DATFunc_table) (gchar *table_name, const gchar *ui_name,
+ gpointer user_data);
/* Opaque structure - provides type checking but no access to components */
typedef struct dtbl_entry dtbl_entry_t;
gpointer user_data);
extern void dissector_all_tables_foreach_changed (DATFunc func,
gpointer user_data);
-extern void dissector_table_foreach_handle(char *name, DATFunc_handle func,
+extern void dissector_table_foreach_handle(const char *name, DATFunc_handle func,
+ gpointer user_data);
+extern void dissector_all_tables_foreach_table (DATFunc_table func,
gpointer user_data);
/* a protocol uses the function to register a sub-dissector table */
extern dissector_table_t register_dissector_table(const char *name,
- char *ui_name, ftenum_t type, int base);
+ const char *ui_name, ftenum_t type, int base);
+
+/* Find a dissector table by table name. */
+extern dissector_table_t find_dissector_table(const char *name);
/* Get the UI name for a sub-dissector table, given its internal name */
-extern char *get_dissector_table_ui_name(const char *name);
+extern const char *get_dissector_table_ui_name(const char *name);
-/* Get the field type to use when displaying values of the selector for a
- sub-dissector table, given the table's internal name */
-ftenum_t get_dissector_table_type(const char *name);
+/* Get the field type for values of the selector for a dissector table,
+ given the table's internal name */
+extern ftenum_t get_dissector_table_selector_type(const char *name);
/* Get the base to use when displaying values of the selector for a
sub-dissector table, given the table's internal name */
extern int get_dissector_table_base(const char *name);
-/* Add a sub-dissector to a dissector table. Called by the protocol routine */
-/* that wants to register a sub-dissector. */
+/* Add an entry to a uint dissector table. */
extern void dissector_add(const char *abbrev, guint32 pattern,
dissector_handle_t handle);
-/* Add a sub-dissector to a dissector table. Called by the protocol routine */
-/* that wants to de-register a sub-dissector. */
+/* Delete the entry for a dissector in a uint dissector table
+ with a particular pattern. */
extern void dissector_delete(const char *name, guint32 pattern,
dissector_handle_t handle);
+/* Change the entry for a dissector in a uint dissector table
+ with a particular pattern to use a new dissector handle. */
extern void dissector_change(const char *abbrev, guint32 pattern,
dissector_handle_t handle);
-/* Reset a dissector in a sub-dissector table to its initial value. */
+/* Reset an entry in a uint dissector table to its initial value. */
extern void dissector_reset(const char *name, guint32 pattern);
-/* Look for a given port in a given dissector table and, if found, call
- the dissector with the arguments supplied, and return TRUE, otherwise
- return FALSE. */
+/* Look for a given value in a given uint dissector table and, if found,
+ call the dissector with the arguments supplied, and return TRUE,
+ otherwise return FALSE. */
extern gboolean dissector_try_port(dissector_table_t sub_dissectors,
guint32 port, tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree);
-/* Look for a given port in a given dissector table and, if found, return
- the dissector handle for that port. */
+/* Look for a given value in a given uint dissector table and, if found,
+ return the dissector handle for that value. */
extern dissector_handle_t dissector_get_port_handle(
dissector_table_t sub_dissectors, guint32 port);
+/* Add an entry to a string dissector table. */
+extern void dissector_add_string(const char *name, const gchar *pattern,
+ dissector_handle_t handle);
+
+/* Delete the entry for a dissector in a string dissector table
+ with a particular pattern. */
+extern void dissector_delete_string(const char *name, const gchar *pattern,
+ dissector_handle_t handle);
+
+/* Change the entry for a dissector in a string dissector table
+ with a particular pattern to use a new dissector handle. */
+extern void dissector_change_string(const char *name, gchar *pattern,
+ dissector_handle_t handle);
+
+/* Reset an entry in a string sub-dissector table to its initial value. */
+extern void dissector_reset_string(const char *name, const gchar *pattern);
+
+/* Look for a given string in a given dissector table and, if found, call
+ the dissector with the arguments supplied, and return TRUE, otherwise
+ return FALSE. */
+extern gboolean dissector_try_string(dissector_table_t sub_dissectors,
+ const gchar *string, tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree);
+
+/* Look for a given value in a given string dissector table and, if found,
+ return the dissector handle for that value. */
+extern dissector_handle_t dissector_get_string_handle(
+ dissector_table_t sub_dissectors, const gchar *string);
+
/* Add a handle to the list of handles that *could* be used with this
table. That list is used by code in the UI. */
extern void dissector_add_handle(const char *name, dissector_handle_t handle);
by another dissector. */
typedef GSList *heur_dissector_list_t;
-/* Type of a heuristic dissector */
-typedef gboolean (*heur_dissector_t)(tvbuff_t *, packet_info *,
- proto_tree *);
-
-/* A protocol uses this function to register a heuristic dissector list */
+/** A protocol uses this function to register a heuristic sub-dissector list.
+ * Call this in the parent dissectors proto_register function.
+ *
+ * @param name the name of this protocol
+ * @param list the list of heuristic sub-dissectors to be registered
+ */
extern void register_heur_dissector_list(const char *name,
heur_dissector_list_t *list);
-/* Add a sub-dissector to a heuristic dissector list. Called by the
- protocol routine that wants to register a sub-dissector. */
-extern void heur_dissector_add(const char *name, heur_dissector_t dissector,
- int proto);
-
-/* Try all the dissectors in a given heuristic dissector list until
- we find one that recognizes the protocol, in which case we return
- TRUE, or we run out of dissectors, in which case we return FALSE. */
+/** Try all the dissectors in a given heuristic dissector list. This is done,
+ * until we find one that recognizes the protocol.
+ * Call this while the parent dissector running.
+ *
+ * @param sub_dissectors the sub-dissector list
+ * @param tvb the tv_buff with the (remaining) packet data
+ * @param pinfo the packet info of this packet (additional info)
+ * @param tree the protocol tree to be build or NULL
+ * @return TRUE if the packet was recognized by the sub-dissector (stop dissection here)
+ */
extern gboolean dissector_try_heuristic(heur_dissector_list_t sub_dissectors,
tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree);
+/** Add a sub-dissector to a heuristic dissector list.
+ * Call this in the proto_handoff function of the sub-dissector.
+ *
+ * @param name the name of the "parent" protocol, e.g. "tcp"
+ * @param dissector the sub-dissector to be registered
+ * @param proto the protocol id of the sub-dissector
+ */
+extern void heur_dissector_add(const char *name, heur_dissector_t dissector,
+ int proto);
+
/* Register a dissector. */
extern void register_dissector(const char *name, dissector_t dissector,
int proto);
int proto);
/* Get the short name of the protocol for a dissector handle. */
-extern char *dissector_handle_get_short_name(dissector_handle_t handle);
+extern const char *dissector_handle_get_short_name(dissector_handle_t handle);
+
+/* Get the index of the protocol for a dissector handle. */
+extern int dissector_handle_get_protocol_index(dissector_handle_t handle);
/* Find a dissector by name. */
extern dissector_handle_t find_dissector(const char *name);
extern dissector_handle_t new_create_dissector_handle(new_dissector_t dissector,
int proto);
-/* Call a dissector through a handle. */
+/* Call a dissector through a handle and if no dissector was found
+ * pass if over to the "data" dissector instead.
+ *
+ * @param handle The dissector to call.
+ * @param tvb The buffer to dissect.
+ * @param pinfo Packet Info.
+ * @param tree The protocol tree.
+ * @return If the protocol for that handle isn't enabled call the data
+ * dissector. Otherwise, if the handle refers to a new-style
+ * dissector, call the dissector and return its return value, otherwise call
+ * it and return the length of the tvbuff pointed to by the argument.
+ */
extern int call_dissector(dissector_handle_t handle, tvbuff_t *tvb,
packet_info *pinfo, proto_tree *tree);
+
+/* Call a dissector through a handle but if no dissector was found
+ * just return 0 and do not call the "data" dissector instead.
+ *
+ * @param handle The dissector to call.
+ * @param tvb The buffer to dissect.
+ * @param pinfo Packet Info.
+ * @param tree The protocol tree.
+ * @return If the protocol for that handle isn't enabled, return 0 without
+ * calling the dissector. Otherwise, if the handle refers to a new-style
+ * dissector, call the dissector and return its return value, otherwise call
+ * it and return the length of the tvbuff pointed to by the argument.
+ */
+extern int call_dissector_only(dissector_handle_t handle, tvbuff_t *tvb,
+ packet_info *pinfo, proto_tree *tree);
/* Do all one-time initialization. */
extern void dissect_init(void);
/* Initialize all data structures used for dissection. */
extern void init_dissection(void);
+/* Free data structures allocated for dissection. */
+extern void cleanup_dissection(void);
+
/* Allow protocols to register a "cleanup" routine to be
* run after the initial sequential run through the packets.
* Note that the file can still be open after this; this is not
* useful for dissector registration routines which need to compile
* display filters. dfilters can't initialize itself until all protocols
* have registereed themselvs. */
-void
+extern void
register_final_registration_routine(void (*func)(void));
/* Call all the registered "final_registration" routines. */
-void
+extern void
final_registration_all_protocols(void);
/*
* the tvbuff for the data source and its name.
*/
extern void add_new_data_source(packet_info *pinfo, tvbuff_t *tvb,
- char *name);
+ const char *name);
/*
* Free up a frame's list of data sources.
int len, packet_counts *ld);
extern void ethertype(guint16 etype, tvbuff_t *tvb, int offset_after_ethertype,
packet_info *pinfo, proto_tree *tree, proto_tree *fh_tree,
- int etype_id, int trailer_id);
+ int etype_id, int trailer_id, int fcs_len);
+
+/*
+ * Dump layer/selector/dissector records in a fashion similar to the
+ * proto_registrar_dump_* routines.
+ */
+extern void dissector_dump_decodes(void);
+
+/*
+ * post dissectors are to be called by packet-frame.c after every other
+ * dissector has been called.
+ */
+extern void register_postdissector(dissector_handle_t);
+extern void call_all_postdissectors(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree);
#endif /* packet.h */