1999-12-09 20:43:38 +00:00
/* plugins.c
1999-12-09 20:55:49 +00:00
* plugin routines
*
2004-07-18 00:24:25 +00:00
* $ Id $
1999-12-09 20:43:38 +00:00
*
* Ethereal - Network traffic analyzer
2001-08-18 23:21:31 +00:00
* By Gerald Combs < gerald @ ethereal . com >
1999-12-09 20:55:49 +00:00
* Copyright 1999 Gerald Combs
2002-08-28 20:41:00 +00:00
*
1999-12-09 20:43:38 +00:00
* 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 .
2002-08-28 20:41:00 +00:00
*
1999-12-09 20:43:38 +00:00
* 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 .
2002-08-28 20:41:00 +00:00
*
1999-12-09 20:43:38 +00:00
* 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 .
*/
# ifdef HAVE_CONFIG_H
# include "config.h"
# endif
2000-01-15 00:23:13 +00:00
# include "plugins.h"
# ifdef HAVE_PLUGINS
1999-12-09 20:43:38 +00:00
# include <time.h>
2000-01-15 00:23:13 +00:00
# ifdef HAVE_DIRENT_H
2000-01-04 20:37:18 +00:00
# include <dirent.h>
2000-01-15 00:23:13 +00:00
# endif
# ifdef HAVE_DIRECT_H
# include <direct.h>
# endif
2000-01-04 20:37:18 +00:00
# include <string.h>
2000-01-15 00:23:13 +00:00
# include <stdlib.h>
2002-08-28 20:41:00 +00:00
# include <errno.h>
2000-08-11 13:37:21 +00:00
2000-01-15 00:23:13 +00:00
# ifdef HAVE_UNISTD_H
2000-01-04 21:29:43 +00:00
# include <unistd.h>
2000-01-15 00:23:13 +00:00
# endif
1999-12-09 20:43:38 +00:00
2000-09-28 03:16:29 +00:00
# include "filesystem.h"
2005-11-06 22:43:25 +00:00
# include "file_util.h"
2005-03-06 04:41:42 +00:00
# include "report_err.h"
1999-12-09 20:43:38 +00:00
/* linked list of all plugins */
plugin * plugin_list ;
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
2000-08-19 17:53:02 +00:00
# define PLUGINS_DIR_NAME "plugins"
1999-12-09 20:43:38 +00:00
/*
* add a new plugin to the list
* returns :
* - 0 : OK
* - ENOMEM : memory allocation problem
* - EEXIST : the same plugin ( i . e . name / version ) was already registered .
*/
2001-01-28 21:17:29 +00:00
static int
add_plugin ( void * handle , gchar * name , gchar * version ,
2005-03-07 02:44:41 +00:00
void ( * register_protoinfo ) ( void ) , void ( * reg_handoff ) ( void ) ,
void ( * register_tap_listener ) ( void ) )
1999-12-09 20:43:38 +00:00
{
plugin * new_plug , * pt_plug ;
pt_plug = plugin_list ;
if ( ! pt_plug ) /* the list is empty */
{
new_plug = ( plugin * ) g_malloc ( sizeof ( plugin ) ) ;
if ( new_plug = = NULL ) return ENOMEM ;
plugin_list = new_plug ;
}
else
{
while ( 1 )
{
/* check if the same name/version is already registered */
if ( ! strcmp ( pt_plug - > name , name ) & &
! strcmp ( pt_plug - > version , version ) )
{
return EEXIST ;
}
/* we found the last plugin in the list */
if ( pt_plug - > next = = NULL ) break ;
pt_plug = pt_plug - > next ;
}
new_plug = ( plugin * ) g_malloc ( sizeof ( plugin ) ) ;
if ( new_plug = = NULL ) return ENOMEM ;
pt_plug - > next = new_plug ;
}
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
new_plug - > handle = handle ;
new_plug - > name = name ;
new_plug - > version = version ;
2005-03-07 02:44:41 +00:00
new_plug - > register_protoinfo = register_protoinfo ;
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
new_plug - > reg_handoff = reg_handoff ;
2005-02-27 22:04:48 +00:00
new_plug - > register_tap_listener = register_tap_listener ;
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
new_plug - > next = NULL ;
return 0 ;
}
Clean up the dissector registration up a bit - arrange that all plugins
be loaded and their initialization routines called in right after we
call the initialization routines for built-in dissectors, but don't call
their handoff registration routines yet, and then call the handoff
registration routines right after calling the handoff registration
routines for built-in dissectors.
Do all that in "proto_init()", rather than "epan_init()".
That way, we call all dissector registration routines together, and then
call all dissector handoff registration routines together; all the
registration routines are called before any handoff registration
routines, as is required, and, as "proto_init()" is called by
"epan_init()" before "dfilter_init()" is called, all filterable fields
have been registered before "dfilter_init()" is called, and no plugins
have to call "dfilter_init()" themselves to get their fields registered.
Remove pointers to "dfilter_init()" and "dfilter_cleanup()" from the
plugin address table, as plugins shouldn't be calling them any more, and
remove calls to them from plugins.
svn path=/trunk/; revision=2940
2001-01-26 06:14:53 +00:00
/*
* XXX - when we remove support for old - style plugins ( which we should
* probably do eventually , as all plugins should be written as new - style
* ones ) , we may want to have " init_plugins() " merely save a pointer
* to the plugin ' s " init " routine , just as we save a pointer to its
* " reg_handoff " routine , and have a " register_all_plugins() " routine
* to go through the list of plugins and call all of them .
*
* Then we ' d have " epan_init() " , or perhaps even something higher up
* in the call tree , call " init_plugins() " , and have " proto_init() "
* call " register_all_plugins() " right after calling " register_all_protocols() " ;
* this might be a bit cleaner .
*/
2000-01-04 20:37:18 +00:00
static void
plugins_scan_dir ( const char * dirname )
{
2000-08-19 17:53:02 +00:00
# define FILENAME_LEN 1024
2005-11-06 22:43:25 +00:00
ETH_DIR * dir ; /* scanned directory */
ETH_DIRENT * file ; /* current file */
const char * name ;
2003-06-03 02:32:56 +00:00
# if GLIB_MAJOR_VERSION < 2
2000-11-29 09:10:03 +00:00
gchar * hack_path ; /* pathname used to construct lt_lib_ext */
gchar * lt_lib_ext ; /* extension for loadable modules */
2003-06-03 02:32:56 +00:00
# endif
2000-08-19 17:53:02 +00:00
gchar filename [ FILENAME_LEN ] ; /* current file name */
2000-01-15 00:23:13 +00:00
GModule * handle ; /* handle returned by dlopen */
2000-01-04 20:37:18 +00:00
gchar * version ;
2005-01-02 04:01:00 +00:00
gpointer gp ;
2005-03-07 02:44:41 +00:00
void ( * register_protoinfo ) ( void ) ;
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
void ( * reg_handoff ) ( void ) ;
2005-02-27 22:04:48 +00:00
void ( * register_tap_listener ) ( void ) ;
2000-01-04 20:37:18 +00:00
gchar * dot ;
int cr ;
2003-06-04 00:11:02 +00:00
# if GLIB_MAJOR_VERSION < 2
2000-11-29 09:10:03 +00:00
/*
* We find the extension used on this platform for loadable modules
* by the sneaky hack of calling " g_module_build_path " to build
* the pathname for a module with an empty directory name and
* empty module name , and then search for the last " . " and use
* everything from the last " . " on .
*/
hack_path = g_module_build_path ( " " , " " ) ;
lt_lib_ext = strrchr ( hack_path , ' . ' ) ;
if ( lt_lib_ext = = NULL )
{
/*
* Does this mean there * is * no extension ? Assume so .
*
* XXX - the code below assumes that all loadable modules have
* an extension . . . .
*/
lt_lib_ext = " " ;
}
2005-11-06 22:43:25 +00:00
# endif
2000-01-04 20:37:18 +00:00
2005-11-06 22:43:25 +00:00
if ( ( dir = g_dir_open ( dirname , 0 , NULL ) ) ! = NULL )
2000-01-04 20:37:18 +00:00
{
2005-11-06 22:43:25 +00:00
while ( ( file = eth_dir_read_name ( dir ) ) ! = NULL )
2000-01-04 20:37:18 +00:00
{
2005-11-06 22:43:25 +00:00
name = eth_dir_get_name ( file ) ;
# if GLIB_MAJOR_VERSION < 2
2000-01-04 20:37:18 +00:00
/* don't try to open "." and ".." */
2005-11-06 22:43:25 +00:00
if ( ! ( strcmp ( name , " .. " ) & &
strcmp ( name , " . " ) ) ) continue ;
2000-01-04 20:37:18 +00:00
2000-11-29 09:10:03 +00:00
/* skip anything but files with lt_lib_ext */
2005-11-06 22:43:25 +00:00
dot = strrchr ( name , ' . ' ) ;
2000-11-29 09:10:03 +00:00
if ( dot = = NULL | | strcmp ( dot , lt_lib_ext ) ! = 0 ) continue ;
2000-01-04 20:37:18 +00:00
2003-06-03 02:32:56 +00:00
# else /* GLIB 2 */
2003-06-04 00:11:02 +00:00
/*
* GLib 2. x defines G_MODULE_SUFFIX as the extension used on this
* platform for loadable modules .
*/
2003-06-03 02:32:56 +00:00
/* skip anything but files with G_MODULE_SUFFIX */
dot = strrchr ( name , ' . ' ) ;
if ( dot = = NULL | | strcmp ( dot + 1 , G_MODULE_SUFFIX ) ! = 0 ) continue ;
2005-11-06 22:43:25 +00:00
# endif
2005-08-08 18:50:39 +00:00
g_snprintf ( filename , FILENAME_LEN , " %s " G_DIR_SEPARATOR_S " %s " ,
2003-06-03 02:32:56 +00:00
dirname , name ) ;
if ( ( handle = g_module_open ( filename , 0 ) ) = = NULL )
{
2005-03-05 06:28:10 +00:00
report_failure ( " Couldn't load module %s: %s " , filename ,
2003-06-03 02:32:56 +00:00
g_module_error ( ) ) ;
continue ;
}
2005-01-02 04:01:00 +00:00
if ( ! g_module_symbol ( handle , " version " , & gp ) )
2000-01-04 20:37:18 +00:00
{
2005-03-05 06:28:10 +00:00
report_failure ( " The plugin %s has no version symbol " , name ) ;
2000-01-15 00:23:13 +00:00
g_module_close ( handle ) ;
2000-01-04 20:37:18 +00:00
continue ;
}
2005-01-02 04:01:00 +00:00
version = gp ;
2005-03-05 06:28:10 +00:00
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
/*
2005-03-07 02:44:41 +00:00
* Do we have a register routine ?
2005-02-27 22:04:48 +00:00
*/
2005-03-07 02:44:41 +00:00
if ( g_module_symbol ( handle , " plugin_register " , & gp ) )
2005-02-27 22:04:48 +00:00
{
2005-03-07 02:44:41 +00:00
/*
* Yes - this plugin includes one or more dissectors .
*/
register_protoinfo = gp ;
2005-03-06 04:41:42 +00:00
}
2005-03-07 02:44:41 +00:00
else
2005-03-05 06:28:10 +00:00
{
2005-03-07 02:44:41 +00:00
/*
* No - no dissectors .
*/
register_protoinfo = NULL ;
2005-02-27 22:04:48 +00:00
}
/*
* Do we have a reg_handoff routine ?
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
*/
2005-01-02 04:01:00 +00:00
if ( g_module_symbol ( handle , " plugin_reg_handoff " , & gp ) )
2000-01-04 20:37:18 +00:00
{
2005-02-27 22:04:48 +00:00
/*
2005-03-07 02:44:41 +00:00
* Yes .
2005-02-27 22:04:48 +00:00
*/
2005-01-02 04:01:00 +00:00
reg_handoff = gp ;
2005-02-27 22:04:48 +00:00
}
else
{
/*
2005-03-07 02:44:41 +00:00
* No - that ' s OK even if we have dissectors , as long
* as the plugin registers by name * and * there ' s
* a caller looking for that name .
2005-02-27 22:04:48 +00:00
*/
reg_handoff = NULL ;
}
2005-01-02 04:01:00 +00:00
2005-02-27 22:04:48 +00:00
/*
* Do we have a register_tap_listener routine ?
*/
if ( g_module_symbol ( handle , " plugin_register_tap_listener " , & gp ) )
{
/*
* Yes - this plugin includes one or more taps .
*/
register_tap_listener = gp ;
}
else
{
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
/*
2005-02-27 22:04:48 +00:00
* No - no taps here .
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
*/
2005-02-27 22:04:48 +00:00
register_tap_listener = NULL ;
}
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
2005-03-07 02:44:41 +00:00
/*
2005-03-16 23:07:08 +00:00
* Do we have an old - style init routine ?
2005-03-07 02:44:41 +00:00
*/
if ( g_module_symbol ( handle , " plugin_init " , & gp ) )
{
/*
* Yes - do we also have a register routine or a
* register_tap_listener routine ? If so , this is a bogus
* hybrid of an old - style and new - style plugin .
*/
if ( register_protoinfo ! = NULL | | register_tap_listener ! = NULL )
{
report_failure ( " The plugin %s has an old plugin init routine \n and a new register or register_tap_listener routine. " ,
name ) ;
g_module_close ( handle ) ;
continue ;
}
/*
2005-03-16 23:07:08 +00:00
* It ' s just an unsupported old - style plugin ;
2005-03-07 02:44:41 +00:00
*/
2005-03-16 23:07:08 +00:00
report_failure ( " The plugin %s has an old plugin init routine. Support has been dropped. \n Information on how to update your plugin is available at \n http://anonsvn.ethereal.com/ethereal/trunk/doc/README.plugins " ,
2005-03-07 02:44:41 +00:00
name ) ;
2005-03-16 23:07:08 +00:00
g_module_close ( handle ) ;
continue ;
2005-03-07 02:44:41 +00:00
}
2005-02-27 22:04:48 +00:00
/*
* Does this dissector do anything useful ?
*/
2005-03-16 23:07:08 +00:00
if ( register_protoinfo = = NULL & &
2005-03-07 02:44:41 +00:00
register_tap_listener = = NULL )
2005-02-27 22:04:48 +00:00
{
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
/*
2005-02-27 22:04:48 +00:00
* No .
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
*/
2005-03-16 23:07:08 +00:00
report_failure ( " The plugin %s has neither a register routine, or a register_tap_listener routine " ,
2005-03-07 02:44:41 +00:00
name ) ;
2005-02-27 22:04:48 +00:00
g_module_close ( handle ) ;
continue ;
}
/*
* OK , attempt to add it to the list of plugins .
*/
if ( ( cr = add_plugin ( handle , g_strdup ( name ) , version ,
2005-03-07 02:44:41 +00:00
register_protoinfo , reg_handoff ,
register_tap_listener ) ) )
2005-02-27 22:04:48 +00:00
{
if ( cr = = EEXIST )
fprintf ( stderr , " The plugin %s, version %s \n "
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
" was found in multiple directories \n " , name , version ) ;
2005-02-27 22:04:48 +00:00
else
fprintf ( stderr , " Memory allocation problem \n "
2001-01-28 21:17:29 +00:00
" when processing plugin %s, version %s \n " ,
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
name , version ) ;
2005-02-27 22:04:48 +00:00
g_module_close ( handle ) ;
continue ;
}
Allow plugins to have, instead of "protocol" and "filter_string"
variables and a "dissector" routine, a "plugin_reg_handoff()" routine,
which will act just like the "reg_handoff()" routine of a non-plugin
dissector, registering the dissector with handoff tables.
This lets them plug into both TCP and UDP, or plug into protocols other
than TCP or UDP.
Those new-style plugin are enabled and disabled using the standard
"Edit->Protocols" mechanism (and thus should use
"OLD_CHECK_DISPLAY_AS_DATA()" or "CHECK_DISPLAY_AS_DATA()"); they don't
show up in the list of plugins, aren't enabled or disabled from that
list, and, as they don't have a filter, can't have the filter changed
from that list - instead, they should register preferences for port
numbers and the like if they should be configurable to use different
ports.
Make the Gryphon protocol a new-style plugin.
svn path=/trunk/; revision=2565
2000-11-05 09:05:00 +00:00
2005-02-27 22:04:48 +00:00
/*
2005-03-07 02:44:41 +00:00
* Call its register routine if it has one .
* XXX - just save this and call it with the built - in
* dissector register routines ?
2005-02-27 22:04:48 +00:00
*/
2005-03-07 02:44:41 +00:00
if ( register_protoinfo ! = NULL )
register_protoinfo ( ) ;
2000-01-04 20:37:18 +00:00
}
2005-11-06 22:43:25 +00:00
eth_dir_close ( dir ) ;
}
2003-06-03 02:32:56 +00:00
# if GLIB_MAJOR_VERSION < 2
2000-11-29 09:10:03 +00:00
g_free ( hack_path ) ;
2003-06-03 02:32:56 +00:00
# endif
2000-01-04 20:37:18 +00:00
}
2004-05-20 13:48:25 +00:00
/* get the global plugin dir */
/* Return value is malloced so the caller should g_free() it. */
2004-12-31 00:32:00 +00:00
char * get_plugins_global_dir ( const char * plugin_dir )
2000-01-04 20:37:18 +00:00
{
2004-09-11 23:03:36 +00:00
# ifdef _WIN32
2004-05-20 22:37:45 +00:00
char * install_plugin_dir ;
2004-05-20 13:48:25 +00:00
2001-08-18 23:21:31 +00:00
/*
On Windows, use the directory in which the binary resides as the
directory in which global data files are stored. If an installed binary
is being run, that's the correct directory for them; if a build-tree
binary is being run, the "manuf" file will be there, and you can put
other data files there as well, if necessary.
Do the same with plugins, except that, if there's no
"plugins\\{version}" subdirectory of that directory, fall back on the
default installation directory, so you at least have a place where you
can put plugins for use by build-tree binaries. (Should we, instead,
have the Windows build procedure create a subdirectory of the "plugins"
source directory, with the plugin version number as its name, and copy
the plugins there, so you'd use the build-tree plugin binaries?)
Move "test_for_directory()" out of "util.c" and into
"epan/filesystem.c", with the other file system access portability
wrappers and convenience routines. Fix "util.h" not to declare it - or
other routines moved to "epan/filesystem.c" a while ago.
svn path=/trunk/; revision=3858
2001-08-21 06:39:18 +00:00
* On Windows , the data file directory is the installation
* directory ; the plugins are stored under it .
2001-08-18 23:21:31 +00:00
*
On Windows, use the directory in which the binary resides as the
directory in which global data files are stored. If an installed binary
is being run, that's the correct directory for them; if a build-tree
binary is being run, the "manuf" file will be there, and you can put
other data files there as well, if necessary.
Do the same with plugins, except that, if there's no
"plugins\\{version}" subdirectory of that directory, fall back on the
default installation directory, so you at least have a place where you
can put plugins for use by build-tree binaries. (Should we, instead,
have the Windows build procedure create a subdirectory of the "plugins"
source directory, with the plugin version number as its name, and copy
the plugins there, so you'd use the build-tree plugin binaries?)
Move "test_for_directory()" out of "util.c" and into
"epan/filesystem.c", with the other file system access portability
wrappers and convenience routines. Fix "util.h" not to declare it - or
other routines moved to "epan/filesystem.c" a while ago.
svn path=/trunk/; revision=3858
2001-08-21 06:39:18 +00:00
* Assume we ' re running the installed version of Ethereal ;
* on Windows , the data file directory is the directory
* in which the Ethereal binary resides .
2001-08-18 23:21:31 +00:00
*/
2004-05-20 13:48:25 +00:00
install_plugin_dir = g_strdup_printf ( " %s \\ plugins \\ %s " , get_datafile_dir ( ) , VERSION ) ;
2001-08-18 23:21:31 +00:00
/*
On Windows, use the directory in which the binary resides as the
directory in which global data files are stored. If an installed binary
is being run, that's the correct directory for them; if a build-tree
binary is being run, the "manuf" file will be there, and you can put
other data files there as well, if necessary.
Do the same with plugins, except that, if there's no
"plugins\\{version}" subdirectory of that directory, fall back on the
default installation directory, so you at least have a place where you
can put plugins for use by build-tree binaries. (Should we, instead,
have the Windows build procedure create a subdirectory of the "plugins"
source directory, with the plugin version number as its name, and copy
the plugins there, so you'd use the build-tree plugin binaries?)
Move "test_for_directory()" out of "util.c" and into
"epan/filesystem.c", with the other file system access portability
wrappers and convenience routines. Fix "util.h" not to declare it - or
other routines moved to "epan/filesystem.c" a while ago.
svn path=/trunk/; revision=3858
2001-08-21 06:39:18 +00:00
* Make sure that pathname refers to a directory .
2001-08-18 23:21:31 +00:00
*/
2001-09-14 09:27:35 +00:00
if ( test_for_directory ( install_plugin_dir ) ! = EISDIR ) {
2001-08-18 23:21:31 +00:00
/*
On Windows, use the directory in which the binary resides as the
directory in which global data files are stored. If an installed binary
is being run, that's the correct directory for them; if a build-tree
binary is being run, the "manuf" file will be there, and you can put
other data files there as well, if necessary.
Do the same with plugins, except that, if there's no
"plugins\\{version}" subdirectory of that directory, fall back on the
default installation directory, so you at least have a place where you
can put plugins for use by build-tree binaries. (Should we, instead,
have the Windows build procedure create a subdirectory of the "plugins"
source directory, with the plugin version number as its name, and copy
the plugins there, so you'd use the build-tree plugin binaries?)
Move "test_for_directory()" out of "util.c" and into
"epan/filesystem.c", with the other file system access portability
wrappers and convenience routines. Fix "util.h" not to declare it - or
other routines moved to "epan/filesystem.c" a while ago.
svn path=/trunk/; revision=3858
2001-08-21 06:39:18 +00:00
* Either it doesn ' t refer to a directory or it
* refers to something that doesn ' t exist .
*
* Assume that means we ' re running , for example ,
* a version of Ethereal we ' ve built in a source
* directory , and fall back on the default
* installation directory , so you can put the plugins
* somewhere so they can be used with this version
* of Ethereal .
2001-08-18 23:21:31 +00:00
*
On Windows, use the directory in which the binary resides as the
directory in which global data files are stored. If an installed binary
is being run, that's the correct directory for them; if a build-tree
binary is being run, the "manuf" file will be there, and you can put
other data files there as well, if necessary.
Do the same with plugins, except that, if there's no
"plugins\\{version}" subdirectory of that directory, fall back on the
default installation directory, so you at least have a place where you
can put plugins for use by build-tree binaries. (Should we, instead,
have the Windows build procedure create a subdirectory of the "plugins"
source directory, with the plugin version number as its name, and copy
the plugins there, so you'd use the build-tree plugin binaries?)
Move "test_for_directory()" out of "util.c" and into
"epan/filesystem.c", with the other file system access portability
wrappers and convenience routines. Fix "util.h" not to declare it - or
other routines moved to "epan/filesystem.c" a while ago.
svn path=/trunk/; revision=3858
2001-08-21 06:39:18 +00:00
* XXX - should we , instead , have the Windows build
* procedure create a subdirectory of the " plugins "
* source directory , and copy the plugin DLLs there ,
* so that you use the plugins from the build tree ?
2001-08-18 23:21:31 +00:00
*/
2004-05-20 22:37:45 +00:00
g_free ( install_plugin_dir ) ;
2001-08-21 08:16:54 +00:00
install_plugin_dir =
2001-08-21 09:11:59 +00:00
g_strdup ( " C: \\ Program Files \\ Ethereal \\ plugins \\ " VERSION ) ;
2001-08-18 23:21:31 +00:00
}
On Windows, use the directory in which the binary resides as the
directory in which global data files are stored. If an installed binary
is being run, that's the correct directory for them; if a build-tree
binary is being run, the "manuf" file will be there, and you can put
other data files there as well, if necessary.
Do the same with plugins, except that, if there's no
"plugins\\{version}" subdirectory of that directory, fall back on the
default installation directory, so you at least have a place where you
can put plugins for use by build-tree binaries. (Should we, instead,
have the Windows build procedure create a subdirectory of the "plugins"
source directory, with the plugin version number as its name, and copy
the plugins there, so you'd use the build-tree plugin binaries?)
Move "test_for_directory()" out of "util.c" and into
"epan/filesystem.c", with the other file system access portability
wrappers and convenience routines. Fix "util.h" not to declare it - or
other routines moved to "epan/filesystem.c" a while ago.
svn path=/trunk/; revision=3858
2001-08-21 06:39:18 +00:00
2004-05-20 22:37:45 +00:00
return install_plugin_dir ;
2001-08-18 23:21:31 +00:00
# else
/*
2002-12-08 22:22:03 +00:00
* Scan the plugin directory .
2001-08-18 23:21:31 +00:00
*/
2005-08-18 19:31:15 +00:00
return g_strdup ( plugin_dir ) ;
2001-08-18 23:21:31 +00:00
# endif
2004-05-20 13:48:25 +00:00
}
/* get the personal plugin dir */
/* Return value is malloced so the caller should g_free() it. */
2004-12-31 00:32:00 +00:00
char * get_plugins_pers_dir ( void )
2004-05-20 13:48:25 +00:00
{
return get_persconffile_path ( PLUGINS_DIR_NAME , FALSE ) ;
}
/*
* init plugins
*/
void
init_plugins ( const char * plugin_dir )
{
2004-12-31 00:32:00 +00:00
char * datafile_dir ;
2004-05-20 13:48:25 +00:00
if ( plugin_list = = NULL ) /* ensure init_plugins is only run once */
{
/*
* Scan the global plugin directory .
*/
2004-05-20 22:37:45 +00:00
datafile_dir = get_plugins_global_dir ( plugin_dir ) ;
2004-05-20 13:48:25 +00:00
plugins_scan_dir ( datafile_dir ) ;
2004-12-31 00:32:00 +00:00
g_free ( datafile_dir ) ;
2004-05-20 13:48:25 +00:00
/*
* Scan the users plugin directory .
*/
2004-05-20 22:37:45 +00:00
datafile_dir = get_plugins_pers_dir ( ) ;
2004-05-20 13:48:25 +00:00
plugins_scan_dir ( datafile_dir ) ;
2004-12-31 00:32:00 +00:00
g_free ( datafile_dir ) ;
2000-01-04 20:37:18 +00:00
}
}
Clean up the dissector registration up a bit - arrange that all plugins
be loaded and their initialization routines called in right after we
call the initialization routines for built-in dissectors, but don't call
their handoff registration routines yet, and then call the handoff
registration routines right after calling the handoff registration
routines for built-in dissectors.
Do all that in "proto_init()", rather than "epan_init()".
That way, we call all dissector registration routines together, and then
call all dissector handoff registration routines together; all the
registration routines are called before any handoff registration
routines, as is required, and, as "proto_init()" is called by
"epan_init()" before "dfilter_init()" is called, all filterable fields
have been registered before "dfilter_init()" is called, and no plugins
have to call "dfilter_init()" themselves to get their fields registered.
Remove pointers to "dfilter_init()" and "dfilter_cleanup()" from the
plugin address table, as plugins shouldn't be calling them any more, and
remove calls to them from plugins.
svn path=/trunk/; revision=2940
2001-01-26 06:14:53 +00:00
void
register_all_plugin_handoffs ( void )
{
2005-02-27 22:04:48 +00:00
plugin * pt_plug ;
/*
* For all plugins with register - handoff routines , call the routines .
* This is called from " proto_init() " ; it must be called after
* " register_all_protocols() " and " init_plugins() " are called ,
* in case one plugin registers itself either with a built - in
* dissector or with another plugin ; we must first register all
* dissectors , whether built - in or plugin , so their dissector tables
* are initialized , and only then register all handoffs .
*/
for ( pt_plug = plugin_list ; pt_plug ! = NULL ; pt_plug = pt_plug - > next )
{
if ( pt_plug - > reg_handoff )
( pt_plug - > reg_handoff ) ( ) ;
}
}
void
register_all_plugin_tap_listeners ( void )
{
plugin * pt_plug ;
/*
* For all plugins with register - tap - listener routines , call the
* routines .
*/
for ( pt_plug = plugin_list ; pt_plug ! = NULL ; pt_plug = pt_plug - > next )
{
if ( pt_plug - > register_tap_listener )
( pt_plug - > register_tap_listener ) ( ) ;
}
Clean up the dissector registration up a bit - arrange that all plugins
be loaded and their initialization routines called in right after we
call the initialization routines for built-in dissectors, but don't call
their handoff registration routines yet, and then call the handoff
registration routines right after calling the handoff registration
routines for built-in dissectors.
Do all that in "proto_init()", rather than "epan_init()".
That way, we call all dissector registration routines together, and then
call all dissector handoff registration routines together; all the
registration routines are called before any handoff registration
routines, as is required, and, as "proto_init()" is called by
"epan_init()" before "dfilter_init()" is called, all filterable fields
have been registered before "dfilter_init()" is called, and no plugins
have to call "dfilter_init()" themselves to get their fields registered.
Remove pointers to "dfilter_init()" and "dfilter_cleanup()" from the
plugin address table, as plugins shouldn't be calling them any more, and
remove calls to them from plugins.
svn path=/trunk/; revision=2940
2001-01-26 06:14:53 +00:00
}
1999-12-09 20:43:38 +00:00
# endif