2000-02-07 17:08:27 +00:00
|
|
|
/* plugin_api.h
|
2000-02-07 17:23:53 +00:00
|
|
|
* Routines for Ethereal plugins.
|
|
|
|
*
|
2000-11-13 08:00:12 +00:00
|
|
|
* $Id: plugin_api.h,v 1.9 2000/11/13 08:00:11 guy Exp $
|
2000-02-07 17:23:53 +00:00
|
|
|
*
|
|
|
|
* Ethereal - Network traffic analyzer
|
|
|
|
* Copyright 2000 by Gilbert Ramirez <gram@xiexie.org>
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU General Public License
|
|
|
|
* as published by the Free Software Foundation; either version 2
|
|
|
|
* of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
*
|
2000-02-07 17:08:27 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifdef PLUGINS_NEED_ADDRESS_TABLE
|
2000-05-31 18:32:15 +00:00
|
|
|
|
|
|
|
#ifdef _WIN32
|
2000-02-07 17:08:27 +00:00
|
|
|
#define DLLEXPORT __declspec(dllexport)
|
2000-05-31 18:32:15 +00:00
|
|
|
#endif
|
2000-02-07 17:08:27 +00:00
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
/* Some OSes (Win32) have DLLs that cannot reference symbols in the parent
|
|
|
|
executable, so the executable needs to provide a collection of pointers
|
|
|
|
to those functions for the DLL plugin to use. */
|
|
|
|
|
|
|
|
/* #defines for those functions that call through pointers.
|
|
|
|
#defined in this fashion so that the declaration of the functions,
|
|
|
|
from the system header files, turn into declarations of pointers
|
|
|
|
to functions, and the calls to it in plugins, in the plugins, turn
|
|
|
|
into calls through the pointers. */
|
|
|
|
#define check_col (*p_check_col)
|
|
|
|
#define col_add_fstr (*p_col_add_fstr)
|
|
|
|
#define col_append_fstr (*p_col_append_fstr)
|
|
|
|
#define col_add_str (*p_col_add_str)
|
|
|
|
#define col_append_str (*p_col_append_str)
|
|
|
|
|
|
|
|
#define dfilter_init (*p_dfilter_init)
|
|
|
|
#define dfilter_cleanup (*p_dfilter_cleanup)
|
|
|
|
|
|
|
|
#define proto_register_protocol (*p_proto_register_protocol)
|
|
|
|
#define proto_register_field_array (*p_proto_register_field_array)
|
|
|
|
#define proto_register_subtree_array (*p_proto_register_subtree_array)
|
|
|
|
|
2000-04-04 21:46:29 +00:00
|
|
|
#define dissector_add (*p_dissector_add)
|
Add a Makefile.nmake for the MGCP plugin, and update
"plugins/Makefile.nmake" to build that plugin.
Add to the table of routines callable from plugins
"old_dissector_add()", "old_dissect_data()", and
"proto_is_protocol_enabled()", so that the Gryphon dissector can build
on Windows.
Move the includes of "plugins/plugin_api.h" and "moduleinfo.h" before
all the other includes, except for "config.h", in "plugin-mgcp.c", to
match what the Gryphon dissector does; "plugins_api.h" must be included
before any of the routines whose names it #defines in order for the
plugin to build on Windows. (It still doesn't build on Windows, as
still more routines need to be added to the table of routines callable
from plugins, but tomorrow is another day. Making libethereal a DLL may
obviate the need for that table, *if* all the routines called from a
plugin are in libethereal, as I think routines in a DLL, even a
run-time-loaded DLL, can call routines from another DLL as long as those
routines are exported from the other DLL.)
svn path=/trunk/; revision=2622
2000-11-12 11:08:46 +00:00
|
|
|
#define old_dissector_add (*p_old_dissector_add)
|
2000-04-04 21:46:29 +00:00
|
|
|
|
Add routines to:
register lists of "heuristic" dissectors, which are handed a
frame that may or may contain a payload for the protocol they
dissect, and that return FALSE if it's not or dissect the packet
and return TRUE if it is;
add a dissector to such a list;
go through such a list, calling each dissector until either a
dissector returns TRUE, in which case the routine returns TRUE,
or it runs out of entries in the list, in which case the routine
returns FALSE.
Have lists of heuristic dissectors for TCP and for COTP when used with
the Inactive Subset of CLNP, and add the GIOP and Yahoo Messenger
dissectors to the first list and the Sinec H1 dissector to the second
list.
Make the dissector name argument to "dissector_add()" and
"dissector_delete()" a "const char *" rarther than just a "char *".
Add "heur_dissector_add()", the routine to add a heuristic dissector to
a list of heuristic dissectors, to the set of routines we can export to
plugins through a table on platforms where dynamically-loaded code can't
call stuff in the main program, and initialize the element in the table
in question for "dissector_add()" (which we'd forgotten to do).
svn path=/trunk/; revision=1909
2000-05-05 09:32:36 +00:00
|
|
|
#define heur_dissector_add (*p_heur_dissector_add)
|
|
|
|
|
Add a Makefile.nmake for the MGCP plugin, and update
"plugins/Makefile.nmake" to build that plugin.
Add to the table of routines callable from plugins
"old_dissector_add()", "old_dissect_data()", and
"proto_is_protocol_enabled()", so that the Gryphon dissector can build
on Windows.
Move the includes of "plugins/plugin_api.h" and "moduleinfo.h" before
all the other includes, except for "config.h", in "plugin-mgcp.c", to
match what the Gryphon dissector does; "plugins_api.h" must be included
before any of the routines whose names it #defines in order for the
plugin to build on Windows. (It still doesn't build on Windows, as
still more routines need to be added to the table of routines callable
from plugins, but tomorrow is another day. Making libethereal a DLL may
obviate the need for that table, *if* all the routines called from a
plugin are in libethereal, as I think routines in a DLL, even a
run-time-loaded DLL, can call routines from another DLL as long as those
routines are exported from the other DLL.)
svn path=/trunk/; revision=2622
2000-11-12 11:08:46 +00:00
|
|
|
#define old_dissect_data (*p_old_dissect_data)
|
|
|
|
|
|
|
|
#define proto_is_protocol_enabled (*p_proto_is_protocol_enabled)
|
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_item_add_subtree (*p_proto_item_add_subtree)
|
|
|
|
#define proto_tree_add_item (*p_proto_tree_add_item)
|
|
|
|
#define proto_tree_add_item_hidden (*p_proto_tree_add_item_hidden)
|
|
|
|
#define proto_tree_add_protocol_format (*p_proto_tree_add_protocol_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_bytes (*p_proto_tree_add_bytes)
|
|
|
|
#define proto_tree_add_bytes_hidden (*p_proto_tree_add_bytes_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_bytes_format (*p_proto_tree_add_bytes_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_time (*p_proto_tree_add_time)
|
|
|
|
#define proto_tree_add_time_hidden (*p_proto_tree_add_time_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_time_format (*p_proto_tree_add_time_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_ipxnet (*p_proto_tree_add_ipxnet)
|
|
|
|
#define proto_tree_add_ipxnet_hidden (*p_proto_tree_add_ipxnet_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_ipxnet_format (*p_proto_tree_add_ipxnet_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_ipv4 (*p_proto_tree_add_ipv4)
|
|
|
|
#define proto_tree_add_ipv4_hidden (*p_proto_tree_add_ipv4_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_ipv4_format (*p_proto_tree_add_ipv4_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_ipv6 (*p_proto_tree_add_ipv6)
|
|
|
|
#define proto_tree_add_ipv6_hidden (*p_proto_tree_add_ipv6_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_ipv6_format (*p_proto_tree_add_ipv6_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_ether (*p_proto_tree_add_ether)
|
|
|
|
#define proto_tree_add_ether_hidden (*p_proto_tree_add_ether_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_ether_format (*p_proto_tree_add_ether_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_string (*p_proto_tree_add_string)
|
|
|
|
#define proto_tree_add_string_hidden (*p_proto_tree_add_string_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_string_format (*p_proto_tree_add_string_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_boolean (*p_proto_tree_add_boolean)
|
|
|
|
#define proto_tree_add_boolean_hidden (*p_proto_tree_add_boolean_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_boolean_format (*p_proto_tree_add_boolean_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_double (*p_proto_tree_add_double)
|
|
|
|
#define proto_tree_add_double_hidden (*p_proto_tree_add_double_hidden)
|
|
|
|
#define proto_tree_add_double_format (*p_proto_tree_add_double_format)
|
|
|
|
#define proto_tree_add_uint (*p_proto_tree_add_uint)
|
|
|
|
#define proto_tree_add_uint_hidden (*p_proto_tree_add_uint_hidden)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_uint_format (*p_proto_tree_add_uint_format)
|
2000-05-31 18:32:15 +00:00
|
|
|
#define proto_tree_add_int (*p_proto_tree_add_int)
|
|
|
|
#define proto_tree_add_int_hidden (*p_proto_tree_add_int_hidden)
|
|
|
|
#define proto_tree_add_int_format (*p_proto_tree_add_int_format)
|
2000-03-15 19:09:52 +00:00
|
|
|
#define proto_tree_add_text (*p_proto_tree_add_text)
|
|
|
|
#define proto_tree_add_notext (*p_proto_tree_add_notext)
|
2000-02-07 17:08:27 +00:00
|
|
|
|
2000-11-13 08:00:12 +00:00
|
|
|
#define tvb_new_subset (*p_tvb_new_subset)
|
|
|
|
|
|
|
|
#define tvb_length (*p_tvb_length)
|
|
|
|
#define tvb_length_remaining (*p_tvb_length_remaining)
|
|
|
|
#define tvb_bytes_exist (*p_tvb_bytes_exist)
|
|
|
|
#define tvb_offset_exists (*p_tvb_offset_exists)
|
|
|
|
#define tvb_reported_length (*p_tvb_reported_length)
|
|
|
|
|
|
|
|
#define tvb_get_guint8 (*p_tvb_get_guint8)
|
|
|
|
|
|
|
|
#define tvb_get_ntohs (*p_tvb_get_ntohs)
|
|
|
|
#define tvb_get_ntoh24 (*p_tvb_get_ntoh24)
|
|
|
|
#define tvb_get_ntohl (*p_tvb_get_ntohl)
|
|
|
|
#ifdef G_HAVE_GINT64
|
|
|
|
#define tvb_get_ntohll (*p_tvb_get_ntohll)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#define tvb_get_letohs (*p_tvb_get_letohs)
|
|
|
|
#define tvb_get_letoh24 (*p_tvb_get_letoh24)
|
|
|
|
#define tvb_get_letohl (*p_tvb_get_letohl)
|
|
|
|
#ifdef G_HAVE_GINT64
|
|
|
|
#define tvb_get_letohll (*p_tvb_get_letohll)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#define tvb_memcpy (*p_tvb_memcpy)
|
|
|
|
#define tvb_memdup (*p_tvb_memdup)
|
|
|
|
|
|
|
|
#define tvb_get_ptr (*p_tvb_get_ptr)
|
|
|
|
|
|
|
|
#define tvb_find_guint8 (*p_tvb_find_guint8)
|
|
|
|
#define tvb_pbrk_guint8 (*p_tvb_pbrk_guint8)
|
|
|
|
|
|
|
|
#define tvb_strnlen (*p_tvb_strnlen)
|
|
|
|
|
|
|
|
#define tvb_format_text (*p_tvb_format_text)
|
|
|
|
|
|
|
|
#define tvb_get_nstringz (*p_tvb_get_nstringz)
|
|
|
|
#define tvb_get_nstringz0 (*p_tvb_get_nstringz0)
|
|
|
|
|
|
|
|
#define tvb_find_line_end (*p_tvb_find_line_end)
|
|
|
|
#define tvb_find_line_end_unquoted (*p_tvb_find_line_end_unquoted)
|
|
|
|
|
|
|
|
#define tvb_strneql (*p_tvb_strneql)
|
|
|
|
#define tvb_strncaseeql (*p_tvb_strncaseeql)
|
|
|
|
|
|
|
|
#define tvb_bytes_to_str (*p_tvb_bytes_to_str)
|
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
#define pi (*p_pi)
|
2000-02-07 17:08:27 +00:00
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
#else
|
2000-02-07 17:08:27 +00:00
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
/* ! PLUGINS_NEED_ADDRESS_TABLE */
|
|
|
|
#define DLLEXPORT
|
2000-02-07 17:08:27 +00:00
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
#endif
|
2000-02-07 17:08:27 +00:00
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
#include "packet.h"
|
|
|
|
#include "dfilter.h"
|
2000-02-07 17:08:27 +00:00
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
#include "plugin_table.h"
|
2000-02-07 17:08:27 +00:00
|
|
|
|
2000-03-15 19:09:52 +00:00
|
|
|
#ifdef PLUGINS_NEED_ADDRESS_TABLE
|
2000-02-07 17:08:27 +00:00
|
|
|
/* The parent executable will send us the pointer to a filled in
|
2000-03-15 19:09:52 +00:00
|
|
|
plugin_address_table_t struct, and we copy the pointers from
|
|
|
|
that table so that we can use functions from the parent executable. */
|
2000-02-07 17:08:27 +00:00
|
|
|
void plugin_address_table_init(plugin_address_table_t*);
|
|
|
|
#else
|
2000-03-15 19:09:52 +00:00
|
|
|
#define plugin_address_table_init(x) ;
|
2000-02-07 17:08:27 +00:00
|
|
|
#endif
|