/*****************************************************************************
- * modules.c : Built-in and plugin modules management functions
+ * modules.c : Builtin and plugin modules management functions
*****************************************************************************
- * Copyright (C) 2001 VideoLAN
- * $Id: modules.c,v 1.57 2002/04/01 21:54:26 gbazin Exp $
+ * Copyright (C) 2001-2004 VideoLAN
+ * $Id: modules.c,v 1.144 2004/01/25 17:16:06 zorglub Exp $
*
- * Authors: Samuel Hocevar <sam@zoy.org>
+ * Authors: Sam Hocevar <sam@zoy.org>
* Ethan C. Baldridge <BaldridgeE@cadmus.com>
* Hans-Peter Jansen <hpj@urpla.net>
*
#include <stdio.h> /* sprintf() */
#include <string.h> /* strdup() */
-#include <videolan/vlc.h>
+#include <vlc/vlc.h>
-#if !defined( _MSC_VER )
-#include <dirent.h>
+#ifdef HAVE_DIRENT_H
+# include <dirent.h>
+#elif defined( UNDER_CE )
+# include <windows.h> /* GetFileAttributes() */
+#else
+# include "../extras/dirent.h"
#endif
-#if defined(HAVE_DLFCN_H) /* Linux, BSD, Hurd */
-# include <dlfcn.h> /* dlopen(), dlsym(), dlclose() */
-# define HAVE_DYNAMIC_PLUGINS
-#elif defined(HAVE_IMAGE_H) /* BeOS */
-# include <image.h>
-# define HAVE_DYNAMIC_PLUGINS
-#elif defined(WIN32) && defined( __MINGW32__ )
-# define HAVE_DYNAMIC_PLUGINS
+#ifdef HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+#ifdef HAVE_SYS_STAT_H
+# include <sys/stat.h>
+#endif
+#ifdef HAVE_UNISTD_H
+# include <unistd.h>
+#endif
+
+#define HAVE_DYNAMIC_PLUGINS
+#if defined(HAVE_DL_DYLD)
+# if defined(HAVE_MACH_O_DYLD_H)
+# include <mach-o/dyld.h>
+# endif
+#elif defined(HAVE_DL_BEOS)
+# if defined(HAVE_IMAGE_H)
+# include <image.h>
+# endif
+#elif defined(HAVE_DL_WINDOWS)
+# include <windows.h>
+#elif defined(HAVE_DL_DLOPEN)
+# if defined(HAVE_DLFCN_H) /* Linux, BSD, Hurd */
+# include <dlfcn.h>
+# endif
+# if defined(HAVE_SYS_DL_H)
+# include <sys/dl.h>
+# endif
+#elif defined(HAVE_DL_SHL_LOAD)
+# if defined(HAVE_DL_H)
+# include <dl.h>
+# endif
#else
# undef HAVE_DYNAMIC_PLUGINS
#endif
+#include "vlc_error.h"
-#include "netutils.h"
-
-#include "interface.h"
-#include "intf_playlist.h"
+#include "vlc_interface.h"
+#include "vlc_playlist.h"
#include "intf_eject.h"
#include "stream_control.h"
#include "input_ext-intf.h"
#include "input_ext-dec.h"
#include "input_ext-plugins.h"
+#include "ninput.h"
-#include "video.h"
+#include "vlc_video.h"
#include "video_output.h"
+#include "vout_synchro.h"
#include "audio_output.h"
+#include "aout_internal.h"
+
+#include "stream_output.h"
+#include "osd.h"
#include "iso_lang.h"
+#include "charset.h"
+
+#include "vlc_block.h"
+
+#if defined( UNDER_CE )
+# define MYCHAR wchar_t
+#else
+# define MYCHAR char
+#endif
#ifdef HAVE_DYNAMIC_PLUGINS
# include "modules_plugin.h"
#endif
-#if !defined( _MSC_VER )
-# include "modules_builtin.h"
-#else
+#if defined( UNDER_CE )
+# include "modules_builtin_evc.h"
+#elif defined( _MSC_VER )
# include "modules_builtin_msvc.h"
+#else
+# include "modules_builtin.h"
#endif
+#include "network.h"
/*****************************************************************************
* Local prototypes
*****************************************************************************/
#ifdef HAVE_DYNAMIC_PLUGINS
-static void AllocateAllPlugins ( void );
-static int AllocatePluginModule ( char * );
+static void AllocateAllPlugins ( vlc_object_t * );
+static void AllocatePluginDir ( vlc_object_t *, const MYCHAR *, int );
+static int AllocatePluginFile ( vlc_object_t *, MYCHAR * );
#endif
-static int AllocateBuiltinModule( int ( * ) ( module_t * ),
- int ( * ) ( module_t * ),
- int ( * ) ( module_t * ) );
+static int AllocateBuiltinModule( vlc_object_t *, int ( * ) ( module_t * ) );
static int DeleteModule ( module_t * );
-static int LockModule ( module_t * );
-static int UnlockModule ( module_t * );
#ifdef HAVE_DYNAMIC_PLUGINS
-static int HideModule ( module_t * );
-static int CallSymbol ( module_t *, char * );
+static void DupModule ( module_t * );
+static void UndupModule ( module_t * );
+static int CallEntry ( module_t * );
+static void CloseModule ( module_handle_t );
+static void * GetSymbol ( module_handle_t, const char * );
+#if defined(HAVE_DL_WINDOWS)
+static char * GetWindowsError ( void );
#endif
-
-#ifdef HAVE_DYNAMIC_PLUGINS
-static module_symbols_t symbols;
#endif
/*****************************************************************************
* This function creates a module bank structure which will be filled later
* on with all the modules found.
*****************************************************************************/
-void module_InitBank( void )
+void __module_InitBank( vlc_object_t *p_this )
{
- p_module_bank->first = NULL;
- p_module_bank->i_count = 0;
- vlc_mutex_init( &p_module_bank->lock );
+ module_bank_t *p_bank;
+
+ p_bank = vlc_object_create( p_this, sizeof(module_bank_t) );
+ p_bank->psz_object_name = "module bank";
/*
* Store the symbols to be exported
*/
#ifdef HAVE_DYNAMIC_PLUGINS
- STORE_SYMBOLS( &symbols );
+ STORE_SYMBOLS( &p_bank->symbols );
#endif
- return;
-}
-
-/*****************************************************************************
- * module_LoadMain: load the main program info into the module bank.
- *****************************************************************************
- * This function fills the module bank structure with the main module infos.
- * This is very useful as it will allow us to consider the main program just
- * as another module, and for instance the configuration options of main will
- * be available in the module bank structure just as for every other module.
- *****************************************************************************/
-void module_LoadMain( void )
-{
- AllocateBuiltinModule( InitModule__MODULE_main,
- ActivateModule__MODULE_main,
- DeactivateModule__MODULE_main );
-}
+ /* Everything worked, attach the object */
+ p_this->p_libvlc->p_module_bank = p_bank;
+ vlc_object_attach( p_bank, p_this->p_libvlc );
-/*****************************************************************************
- * module_LoadBuiltins: load all modules which we built with.
- *****************************************************************************
- * This function fills the module bank structure with the built-in modules.
- *****************************************************************************/
-void module_LoadBuiltins( void )
-{
- intf_WarnMsg( 2, "module: checking built-in modules" );
- ALLOCATE_ALL_BUILTINS();
+ return;
}
/*****************************************************************************
- * module_LoadPlugins: load all plugin modules we can find.
+ * module_ResetBank: reset the module bank.
*****************************************************************************
- * This function fills the module bank structure with the plugin modules.
+ * This function resets the module bank by unloading all unused plugin
+ * modules.
*****************************************************************************/
-void module_LoadPlugins( void )
+void __module_ResetBank( vlc_object_t *p_this )
{
-#ifdef HAVE_DYNAMIC_PLUGINS
- intf_WarnMsg( 2, "module: checking plugin modules" );
- AllocateAllPlugins();
-#endif
+ msg_Err( p_this, "FIXME: module_ResetBank unimplemented" );
+ return;
}
/*****************************************************************************
* This function unloads all unused plugin modules and empties the module
* bank in case of success.
*****************************************************************************/
-void module_EndBank( void )
+void __module_EndBank( vlc_object_t *p_this )
{
module_t * p_next;
- while( p_module_bank->first != NULL )
+ vlc_object_detach( p_this->p_libvlc->p_module_bank );
+
+ while( p_this->p_libvlc->p_module_bank->i_children )
{
- if( DeleteModule( p_module_bank->first ) )
+ p_next = (module_t *)p_this->p_libvlc->p_module_bank->pp_children[0];
+
+ if( DeleteModule( p_next ) )
{
/* Module deletion failed */
- intf_ErrMsg( "module error: `%s' can't be removed, trying harder",
- p_module_bank->first->psz_name );
+ msg_Err( p_this, "module \"%s\" can't be removed, trying harder",
+ p_next->psz_object_name );
/* We just free the module by hand. Niahahahahaha. */
- p_next = p_module_bank->first->next;
- free(p_module_bank->first);
- p_module_bank->first = p_next;
+ vlc_object_detach( p_next );
+ vlc_object_destroy( p_next );
}
}
- /* Destroy the lock */
- vlc_mutex_destroy( &p_module_bank->lock );
+ vlc_object_destroy( p_this->p_libvlc->p_module_bank );
return;
}
/*****************************************************************************
- * module_ResetBank: reset the module bank.
+ * module_LoadMain: load the main program info into the module bank.
*****************************************************************************
- * This function resets the module bank by unloading all unused plugin
- * modules.
+ * This function fills the module bank structure with the main module infos.
+ * This is very useful as it will allow us to consider the main program just
+ * as another module, and for instance the configuration options of main will
+ * be available in the module bank structure just as for every other module.
*****************************************************************************/
-void module_ResetBank( void )
+void __module_LoadMain( vlc_object_t *p_this )
{
- intf_ErrMsg( "FIXME: module_ResetBank unimplemented" );
- return;
+ AllocateBuiltinModule( p_this, vlc_entry__main );
}
/*****************************************************************************
- * module_ManageBank: manage the module bank.
+ * module_LoadBuiltins: load all modules which we built with.
*****************************************************************************
- * This function parses the module bank and hides modules that have been
- * unused for a while.
+ * This function fills the module bank structure with the builtin modules.
*****************************************************************************/
-void module_ManageBank( void )
+void __module_LoadBuiltins( vlc_object_t * p_this )
{
-#ifdef HAVE_DYNAMIC_PLUGINS
- module_t * p_module;
-
- /* We take the global lock */
- vlc_mutex_lock( &p_module_bank->lock );
-
- /* Parse the module list to see if any modules need to be unloaded */
- for( p_module = p_module_bank->first ;
- p_module != NULL ;
- p_module = p_module->next )
- {
- /* If the module is unused and if it is a plugin module... */
- if( p_module->i_usage == 0 && !p_module->b_builtin )
- {
- if( p_module->i_unused_delay < MODULE_HIDE_DELAY )
- {
- p_module->i_unused_delay++;
- }
- else
- {
- intf_WarnMsg( 3, "module: hiding unused plugin module `%s'",
- p_module->psz_name );
- HideModule( p_module );
-
- /* Break here, so that we only hide one module at a time */
- break;
- }
- }
- }
-
- /* We release the global lock */
- vlc_mutex_unlock( &p_module_bank->lock );
-#endif /* HAVE_DYNAMIC_PLUGINS */
+ msg_Dbg( p_this, "checking builtin modules" );
+ ALLOCATE_ALL_BUILTINS();
+}
- return;
+/*****************************************************************************
+ * module_LoadPlugins: load all plugin modules we can find.
+ *****************************************************************************
+ * This function fills the module bank structure with the plugin modules.
+ *****************************************************************************/
+void __module_LoadPlugins( vlc_object_t * p_this )
+{
+#ifdef HAVE_DYNAMIC_PLUGINS
+ msg_Dbg( p_this, "checking plugin modules" );
+ AllocateAllPlugins( p_this );
+#endif
}
/*****************************************************************************
*****************************************************************************
* This function returns the module that best fits the asked capabilities.
*****************************************************************************/
-module_t * module_Need( int i_capability, char *psz_name, void *p_data )
+module_t * __module_Need( vlc_object_t *p_this, const char *psz_capability,
+ const char *psz_name )
{
- typedef struct module_list_s
+ typedef struct module_list_t module_list_t;
+
+ struct module_list_t
{
- struct module_s *p_module;
- struct module_list_s* p_next;
- } module_list_t;
- struct module_list_s *p_list, *p_first, *p_tolock;
+ module_t *p_module;
+ int i_score;
+ module_list_t *p_next;
+ };
+
+ module_list_t *p_list, *p_first, *p_tmp;
+ vlc_list_t *p_all;
- int i_ret, i_index = 0;
- boolean_t b_intf = 0;
+ int i_which_module, i_index = 0;
+ vlc_bool_t b_intf = VLC_FALSE;
module_t *p_module;
- char *psz_realname = NULL;
- /* We take the global lock */
- vlc_mutex_lock( &p_module_bank->lock );
+ int i_shortcuts = 0;
+ char *psz_shortcuts = NULL, *psz_var = NULL;
+
+ msg_Dbg( p_this, "looking for %s module", psz_capability );
+
+ /* Deal with variables */
+ if( psz_name && psz_name[0] == '$' )
+ {
+ vlc_value_t val;
+ var_Create( p_this, psz_name + 1, VLC_VAR_MODULE | VLC_VAR_DOINHERIT );
+ var_Get( p_this, psz_name + 1, &val );
+ psz_var = val.psz_string;
+ psz_name = psz_var;
+ }
- if( psz_name != NULL && *psz_name )
+ /* Count how many different shortcuts were asked for */
+ if( psz_name && *psz_name )
{
- /* A module name was requested. */
- psz_realname = strdup( psz_name );
- if( psz_realname )
+ char *psz_parser;
+
+ /* If the user wants none, give him none. */
+ if( !strcmp( psz_name, "none" ) )
{
- char *p;
- p = strchr( psz_realname, ':' );
- if( p )
+ if( psz_var ) free( psz_var );
+ return NULL;
+ }
+
+ i_shortcuts++;
+ psz_shortcuts = strdup( psz_name );
+
+ for( psz_parser = psz_shortcuts; *psz_parser; psz_parser++ )
+ {
+ if( *psz_parser == ',' )
{
- *p = '\0';
+ *psz_parser = '\0';
+ i_shortcuts++;
}
- psz_name = psz_realname;
}
}
/* Sort the modules and test them */
- p_list = malloc( p_module_bank->i_count * sizeof( module_list_t ) );
+ p_all = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
+ p_list = malloc( p_all->i_count * sizeof( module_list_t ) );
p_first = NULL;
/* Parse the module list for capabilities and probe each of them */
- for( p_module = p_module_bank->first ;
- p_module != NULL ;
- p_module = p_module->next )
+ for( i_which_module = 0; i_which_module < p_all->i_count; i_which_module++ )
{
- /* Test that this module can do everything we need */
- if( !(p_module->i_capabilities & ( 1 << i_capability )) )
+ module_t * p_submodule = NULL;
+ int i_shortcut_bonus = 0, i_submodule;
+
+ p_module = (module_t *)p_all->p_values[i_which_module].p_object;
+
+ /* Test that this module can do what we need */
+ if( strcmp( p_module->psz_capability, psz_capability ) )
{
- continue;
+ for( i_submodule = 0;
+ i_submodule < p_module->i_children;
+ i_submodule++ )
+ {
+ if( !strcmp( ((module_t*)p_module->pp_children[ i_submodule ])
+ ->psz_capability, psz_capability ) )
+ {
+ p_submodule =
+ (module_t*)p_module->pp_children[ i_submodule ];
+ break;
+ }
+ }
+
+ if( p_submodule == NULL )
+ {
+ continue;
+ }
+
+ p_module = p_submodule;
}
/* Test if we have the required CPU */
- if( (p_module->i_cpu_capabilities & p_main->i_cpu_capabilities)
- != p_module->i_cpu_capabilities )
+ if( (p_module->i_cpu & p_this->p_libvlc->i_cpu) != p_module->i_cpu )
{
continue;
}
- /* Test if this plugin exports the required shortcut */
- if( psz_name != NULL && *psz_name )
+ /* If we required a shortcut, check this plugin provides it. */
+ if( i_shortcuts )
{
- boolean_t b_ok = 0;
- int i_dummy;
+ vlc_bool_t b_trash;
+ int i_dummy, i_short = i_shortcuts;
+ char *psz_name = psz_shortcuts;
- for( i_dummy = 0;
- !b_ok && p_module->pp_shortcuts[i_dummy];
- i_dummy++ )
+ /* Let's drop modules with a 0 score (unless they are
+ * explicitly requested) */
+ b_trash = !p_module->i_score;
+
+ while( i_short )
{
- b_ok = !strcmp( psz_name, p_module->pp_shortcuts[i_dummy] );
+ /* If the last given shortcut is "none" and we couldn't
+ * find the module in the list of provided shortcuts,
+ * then kick the bastard out of here!!! */
+ if( (i_short == 1) && !strcmp(psz_name, "none") )
+ {
+ b_trash = VLC_TRUE;
+ break;
+ }
+
+ for( i_dummy = 0; p_module->pp_shortcuts[i_dummy]; i_dummy++ )
+ {
+ if( !strcasecmp( psz_name,
+ p_module->pp_shortcuts[i_dummy] ) )
+ {
+ /* Found it */
+ b_trash = VLC_FALSE;
+ i_shortcut_bonus = i_short * 10000;
+ break;
+ }
+ }
+
+ if( i_shortcut_bonus )
+ {
+ /* We found it... remember ? */
+ break;
+ }
+
+ /* Go to the next shortcut... This is so lame! */
+ while( *psz_name )
+ {
+ psz_name++;
+ }
+ psz_name++;
+ i_short--;
}
- if( !b_ok )
+ if( b_trash )
{
continue;
}
}
+ /* If we didn't require a shortcut, trash zero-scored plugins */
+ else if( !p_module->i_score )
+ {
+ continue;
+ }
/* Special case: test if we requested a particular intf plugin */
- if( i_capability == MODULE_CAPABILITY_INTF )
+ if( !i_shortcuts && p_module->psz_program
+ && !strcmp( p_module->psz_program,
+ p_this->p_vlc->psz_object_name ) )
{
- if( p_module->psz_program != NULL
- && !strcmp( p_module->psz_program, p_main->psz_arg0 ) )
- {
- if( !b_intf )
- {
- /* Remove previous non-matching plugins */
- i_index = 0;
- b_intf = 1;
- }
- }
- else
+ if( !b_intf )
{
- if( b_intf )
- {
- /* This one doesn't match */
- continue;
- }
+ /* Remove previous non-matching plugins */
+ i_index = 0;
+ b_intf = VLC_TRUE;
}
}
+ else if( b_intf )
+ {
+ /* This one doesn't match */
+ continue;
+ }
/* Store this new module */
p_list[ i_index ].p_module = p_module;
+ p_list[ i_index ].i_score = p_module->i_score + i_shortcut_bonus;
/* Add it to the modules-to-probe list */
if( i_index == 0 )
/* Ok, so at school you learned that quicksort is quick, and
* bubble sort sucks raw eggs. But that's when dealing with
* thousands of items. Here we have barely 50. */
- struct module_list_s *p_newlist = p_first;
+ module_list_t *p_newlist = p_first;
- if( p_first->p_module->pi_score[i_capability]
- < p_module->pi_score[i_capability] )
+ if( p_first->i_score < p_list[ i_index ].i_score )
{
p_list[ i_index ].p_next = p_first;
p_first = &p_list[ i_index ];
}
else
{
- while( p_newlist->p_next != NULL
- && p_newlist->p_next->p_module->pi_score[i_capability]
- >= p_module->pi_score[i_capability] )
+ while( p_newlist->p_next != NULL &&
+ p_newlist->p_next->i_score >= p_list[ i_index ].i_score )
{
p_newlist = p_newlist->p_next;
}
i_index++;
}
- /* Lock all selected modules */
- p_tolock = p_first;
- while( p_tolock != NULL )
+ msg_Dbg( p_this, "probing %i candidate%s",
+ i_index, i_index == 1 ? "" : "s" );
+
+ /* Lock all candidate modules */
+ p_tmp = p_first;
+ while( p_tmp != NULL )
{
- LockModule( p_tolock->p_module );
- p_tolock = p_tolock->p_next;
+ vlc_object_yield( p_tmp->p_module );
+ p_tmp = p_tmp->p_next;
}
- /* We can release the global lock, module refcounts were incremented */
- vlc_mutex_unlock( &p_module_bank->lock );
+ /* We can release the list, interesting modules were yielded */
+ vlc_list_release( p_all );
/* Parse the linked list and use the first successful module */
- while( p_first != NULL )
+ p_tmp = p_first;
+ while( p_tmp != NULL )
{
- /* Test the requested capability */
- switch( i_capability )
- {
- case MODULE_CAPABILITY_ACCESS:
- i_ret = p_first->p_module->p_functions->access.functions.
- access.pf_open( (struct input_thread_s *)p_data );
- break;
-
- case MODULE_CAPABILITY_DEMUX:
- i_ret = p_first->p_module->p_functions->demux.functions.
- demux.pf_init( (struct input_thread_s *)p_data );
- break;
-
- case MODULE_CAPABILITY_NETWORK:
- i_ret = p_first->p_module->p_functions->network.functions.
- network.pf_open( (struct network_socket_s *)p_data );
- break;
-
- case MODULE_CAPABILITY_DECODER:
- i_ret = p_first->p_module->p_functions->dec.functions.
- dec.pf_probe( (u8 *)p_data );
- break;
-
- case MODULE_CAPABILITY_INTF:
- i_ret = p_first->p_module->p_functions->intf.functions.
- intf.pf_open( (struct intf_thread_s *)p_data );
- break;
-
- case MODULE_CAPABILITY_AOUT:
- i_ret = p_first->p_module->p_functions->aout.functions.
- aout.pf_open( (struct aout_thread_s *)p_data );
- break;
-
- case MODULE_CAPABILITY_VOUT:
- i_ret = p_first->p_module->p_functions->vout.functions.
- vout.pf_create( (struct vout_thread_s *)p_data );
- break;
-
- case MODULE_CAPABILITY_CHROMA:
- i_ret = p_first->p_module->p_functions->chroma.functions.
- chroma.pf_init( (struct vout_thread_s *)p_data );
- break;
-
- case MODULE_CAPABILITY_IDCT:
- case MODULE_CAPABILITY_IMDCT:
- case MODULE_CAPABILITY_MOTION:
- case MODULE_CAPABILITY_DOWNMIX:
- case MODULE_CAPABILITY_MEMCPY:
- /* This one always works */
- i_ret = 0;
- break;
-
- default:
- intf_ErrMsg( "module error: unknown module type %i",
- i_capability );
- i_ret = -1;
- break;
- }
-
- /* If the high score was broken, we have a new champion */
- if( i_ret == 0 )
+ if( p_tmp->p_module->pf_activate
+ && p_tmp->p_module->pf_activate( p_this ) == VLC_SUCCESS )
{
break;
}
- else
- {
- UnlockModule( p_first->p_module );
- }
- p_first = p_first->p_next;
+ vlc_object_release( p_tmp->p_module );
+ p_tmp = p_tmp->p_next;
}
/* Store the locked module value */
- if( p_first != NULL )
+ if( p_tmp != NULL )
{
- p_module = p_first->p_module;
- p_first = p_first->p_next;
+ p_module = p_tmp->p_module;
+ p_tmp = p_tmp->p_next;
}
else
{
}
/* Unlock the remaining modules */
- while( p_first != NULL )
+ while( p_tmp != NULL )
{
- UnlockModule( p_first->p_module );
- p_first = p_first->p_next;
+ vlc_object_release( p_tmp->p_module );
+ p_tmp = p_tmp->p_next;
}
free( p_list );
if( p_module != NULL )
{
- intf_WarnMsg( 1, "module: locking %s module `%s'",
- GetCapabilityName( i_capability ),
- p_module->psz_name );
+ msg_Dbg( p_module, "using %s module \"%s\"",
+ psz_capability, p_module->psz_object_name );
+ }
+ else if( p_first == NULL )
+ {
+ msg_Err( p_this, "no %s module matched \"%s\"",
+ psz_capability, (psz_name && *psz_name) ? psz_name : "any" );
}
else if( psz_name != NULL && *psz_name )
{
- intf_ErrMsg( "module error: requested %s module `%s' unavailable",
- GetCapabilityName( i_capability ), psz_name );
+ msg_Warn( p_this, "no %s module matching \"%s\" could be loaded",
+ psz_capability, (psz_name && *psz_name) ? psz_name : "any" );
+ }
+
+ if( psz_shortcuts )
+ {
+ free( psz_shortcuts );
}
- if( psz_realname )
+ if( psz_var )
{
- free( psz_realname );
+ free( psz_var );
}
/* Don't forget that the module is still locked */
- return( p_module );
+ return p_module;
}
/*****************************************************************************
* This function must be called by the thread that called module_Need, to
* decrease the reference count and allow for hiding of modules.
*****************************************************************************/
-void module_Unneed( module_t * p_module )
+void __module_Unneed( vlc_object_t * p_this, module_t * p_module )
{
- /* We take the global lock */
- vlc_mutex_lock( &p_module_bank->lock );
-
- /* Just unlock the module - we can't do anything if it fails,
- * so there is no need to check the return value. */
- UnlockModule( p_module );
+ /* Use the close method */
+ if( p_module->pf_deactivate )
+ {
+ p_module->pf_deactivate( p_this );
+ }
- intf_WarnMsg( 1, "module: unlocking module `%s'", p_module->psz_name );
+ msg_Dbg( p_module, "unlocking module \"%s\"", p_module->psz_object_name );
- /* We release the global lock */
- vlc_mutex_unlock( &p_module_bank->lock );
+ vlc_object_release( p_module );
return;
}
* AllocateAllPlugins: load all plugin modules we can find.
*****************************************************************************/
#ifdef HAVE_DYNAMIC_PLUGINS
-static void AllocateAllPlugins( void )
+static void AllocateAllPlugins( vlc_object_t *p_this )
{
- static char * path[] = { ".", "plugins", PLUGIN_PATH, NULL, NULL };
+ /* Yes, there are two NULLs because we replace one with "plugin-path". */
+ char * path[] = { "modules", PLUGIN_PATH, "plugins", NULL,
+ NULL };
char ** ppsz_path = path;
char * psz_fullpath;
- char * psz_file;
-#if defined( SYS_BEOS ) || defined( SYS_DARWIN )
- char * psz_vlcpath = system_GetProgramPath();
- int i_vlclen = strlen( psz_vlcpath );
- boolean_t b_notinroot;
+
+#if defined( UNDER_CE )
+ wchar_t psz_dir[MAX_PATH];
#endif
- DIR * dir;
- struct dirent * file;
+
+ /* If the user provided a plugin path, we add it to the list */
+ path[ sizeof(path)/sizeof(char*) - 2 ] = config_GetPsz( p_this,
+ "plugin-path" );
for( ; *ppsz_path != NULL ; ppsz_path++ )
{
- /* Store strlen(*ppsz_path) for later use. */
- int i_dirlen = strlen( *ppsz_path );
-
-#if defined( SYS_BEOS ) || defined( SYS_DARWIN )
- b_notinroot = 0;
- /* Under BeOS, we need to add beos_GetProgramPath() to access
- * files under the current directory */
- if( ( i_dirlen > 1 ) && strncmp( *ppsz_path, "/", 1 ) )
+#if defined( SYS_BEOS ) || defined( SYS_DARWIN ) \
+ || ( defined( WIN32 ) && !defined( UNDER_CE ) )
+
+ /* Handle relative as well as absolute paths */
+#ifdef WIN32
+ if( !(*ppsz_path)[0] || (*ppsz_path)[1] != ':' )
+#else
+ if( (*ppsz_path)[0] != '/' )
+#endif
{
- i_dirlen += i_vlclen + 2;
- b_notinroot = 1;
+ int i_dirlen = strlen( *ppsz_path );
+ i_dirlen += strlen( p_this->p_libvlc->psz_vlcpath ) + 2;
psz_fullpath = malloc( i_dirlen );
if( psz_fullpath == NULL )
{
continue;
}
- sprintf( psz_fullpath, "%s/%s", psz_vlcpath, *ppsz_path );
+#ifdef WIN32
+ sprintf( psz_fullpath, "%s\\%s",
+ p_this->p_libvlc->psz_vlcpath, *ppsz_path );
+#else
+ sprintf( psz_fullpath, "%s/%s",
+ p_this->p_libvlc->psz_vlcpath, *ppsz_path );
+#endif
}
else
#endif
{
- psz_fullpath = *ppsz_path;
+ psz_fullpath = strdup( *ppsz_path );
}
- intf_WarnMsg( 1, "module: browsing `%s'", psz_fullpath );
-
- if( (dir = opendir( psz_fullpath )) )
- {
- /* Parse the directory and try to load all files it contains. */
- while( (file = readdir( dir )) )
- {
- int i_filelen = strlen( file->d_name );
-
- /* We only load files ending with ".so" */
- if( i_filelen > 3
- && !strncmp( file->d_name + i_filelen - 3, ".so", 3 ) )
- {
- psz_file = malloc( i_dirlen + i_filelen + 2 );
- if( psz_file == NULL )
- {
- continue;
- }
- sprintf( psz_file, "%s/%s", psz_fullpath, file->d_name );
-
- /* We created a nice filename -- now we just try to load
- * it as a plugin module. */
- AllocatePluginModule( psz_file );
-
- /* We don't care if the allocation succeeded */
- free( psz_file );
- }
- }
-
- /* Close the directory if successfully opened */
- closedir( dir );
- }
+ msg_Dbg( p_this, "recursively browsing `%s'", psz_fullpath );
-#if defined( SYS_BEOS ) || defined( SYS_DARWIN )
- if( b_notinroot )
- {
- free( psz_fullpath );
- }
+ /* Don't go deeper than 5 subdirectories */
+#if defined( UNDER_CE )
+ MultiByteToWideChar( CP_ACP, 0, psz_fullpath, -1, psz_dir, MAX_PATH );
+ AllocatePluginDir( p_this, psz_dir, 5 );
+#else
+ AllocatePluginDir( p_this, psz_fullpath, 5 );
#endif
+
+ free( psz_fullpath );
}
+
+ /* Free plugin-path */
+ if( path[ sizeof(path)/sizeof(char*) - 2 ] )
+ free( path[ sizeof(path)/sizeof(char*) - 2 ] );
+ path[ sizeof(path)/sizeof(char*) - 2 ] = NULL;
}
/*****************************************************************************
- * AllocatePluginModule: load a module into memory and initialize it.
- *****************************************************************************
- * This function loads a dynamically loadable module and allocates a structure
- * for its information data. The module can then be handled by module_Need,
- * module_Unneed and HideModule. It can be removed by DeleteModule.
+ * AllocatePluginDir: recursively parse a directory to look for plugins
*****************************************************************************/
-static int AllocatePluginModule( char * psz_filename )
+static void AllocatePluginDir( vlc_object_t *p_this, const MYCHAR *psz_dir,
+ int i_maxdepth )
{
- char **pp_shortcut;
- module_t * p_module, * p_othermodule;
- module_handle_t handle;
+#if defined( UNDER_CE ) || defined( _MSC_VER )
+#ifdef UNDER_CE
+ MYCHAR psz_path[MAX_PATH + 256];
+#else
+ char psz_path[MAX_PATH + 256];
+#endif
+ WIN32_FIND_DATA finddata;
+ HANDLE handle;
+ unsigned int rc;
+#else
+ int i_dirlen;
+ DIR * dir;
+ char * psz_file;
+ struct dirent * file;
+#endif
- /* Try to dynamically load the module. */
- if( module_load( psz_filename, &handle ) )
+ if( p_this->p_vlc->b_die || i_maxdepth < 0 )
{
- /* The plugin module couldn't be opened */
- intf_WarnMsg( 1, "module warning: cannot open %s (%s)",
- psz_filename, module_error() );
- return( -1 );
+ return;
}
- /* Now that we have successfully loaded the module, we can
- * allocate a structure for it */
- p_module = malloc( sizeof( module_t ) );
- if( p_module == NULL )
+#if defined( UNDER_CE ) || defined( _MSC_VER )
+ rc = GetFileAttributes( psz_dir );
+ if( !(rc & FILE_ATTRIBUTE_DIRECTORY) )
{
- intf_ErrMsg( "module error: can't allocate p_module" );
- module_unload( handle );
- return( -1 );
+ /* Not a directory */
+ return;
}
- /* We need to fill these since they may be needed by CallSymbol() */
- p_module->is.plugin.psz_filename = psz_filename;
- p_module->is.plugin.handle = handle;
- p_module->p_symbols = &symbols;
-
- /* Initialize the module : fill p_module->psz_name, default config, etc. */
- if( CallSymbol( p_module, "InitModule" MODULE_SUFFIX ) != 0 )
+ /* Parse all files in the directory */
+#ifdef UNDER_CE
+ swprintf( psz_path, L"%s\\*.*", psz_dir );
+#else
+ sprintf( psz_path, "%s\\*.*", psz_dir );
+#endif
+ handle = FindFirstFile( psz_path, &finddata );
+ if( handle == INVALID_HANDLE_VALUE )
{
- /* We couldn't call InitModule() */
- free( p_module );
- module_unload( handle );
- return( -1 );
+ /* Empty directory */
+ return;
}
- /* Check that we don't already have a module with this name */
- for( p_othermodule = p_module_bank->first ;
- p_othermodule != NULL ;
- p_othermodule = p_othermodule->next )
+ /* Parse the directory and try to load all files it contains. */
+ do
{
- if( !strcmp( p_othermodule->psz_name, p_module->psz_name ) )
+#ifdef UNDER_CE
+ unsigned int i_len = wcslen( finddata.cFileName );
+ swprintf( psz_path, L"%s\\%s", psz_dir, finddata.cFileName );
+#else
+ unsigned int i_len = strlen( finddata.cFileName );
+ /* Skip ".", ".." and anything starting with "." */
+ if( !*finddata.cFileName || *finddata.cFileName == '.' )
{
- intf_WarnMsg( 5, "module warning: cannot load %s, a module named "
- "`%s' already exists",
- psz_filename, p_module->psz_name );
- free( p_module );
- module_unload( handle );
- return( -1 );
+ if( !FindNextFile( handle, &finddata ) ) break;
+ continue;
}
- }
+ sprintf( psz_path, "%s\\%s", psz_dir, finddata.cFileName );
+#endif
- /* Activate the module : fill the capability structure, etc. */
- if( CallSymbol( p_module, "ActivateModule" MODULE_SUFFIX ) != 0 )
- {
- /* We couldn't call ActivateModule() */
- free( p_module );
- module_unload( handle );
- return( -1 );
+ if( GetFileAttributes( psz_path ) & FILE_ATTRIBUTE_DIRECTORY )
+ {
+ AllocatePluginDir( p_this, psz_path, i_maxdepth - 1 );
+ }
+ else if( i_len > strlen( LIBEXT )
+#ifdef UNDER_CE
+ )
+#else
+ /* We only load files ending with LIBEXT */
+ && !strncasecmp( psz_path + strlen( psz_path)
+ - strlen( LIBEXT ),
+ LIBEXT, strlen( LIBEXT ) ) )
+#endif
+ {
+ AllocatePluginFile( p_this, psz_path );
+ }
}
+ while( !p_this->p_vlc->b_die && FindNextFile( handle, &finddata ) );
- for( pp_shortcut = p_module->pp_shortcuts ; *pp_shortcut ; pp_shortcut++ )
+ /* Close the directory */
+ FindClose( handle );
+
+#else
+ dir = opendir( psz_dir );
+ if( !dir )
{
- *pp_shortcut = strdup( *pp_shortcut );
+ return;
}
- /* We strdup() these entries so that they are still valid when the
- * module is unloaded. */
- p_module->is.plugin.psz_filename =
- strdup( p_module->is.plugin.psz_filename );
- p_module->psz_name = strdup( p_module->psz_name );
- p_module->psz_longname = strdup( p_module->psz_longname );
+ i_dirlen = strlen( psz_dir );
- if( p_module->is.plugin.psz_filename == NULL
- || p_module->psz_name == NULL
- || p_module->psz_longname == NULL )
+ /* Parse the directory and try to load all files it contains. */
+ while( !p_this->p_vlc->b_die && (file = readdir( dir )) )
{
- intf_ErrMsg( "module error: can't duplicate strings" );
-
- free( p_module->is.plugin.psz_filename );
- free( p_module->psz_name );
- free( p_module->psz_longname );
- free( p_module->psz_program );
+ struct stat statbuf;
+ unsigned int i_len;
- free( p_module );
- module_unload( handle );
- return( -1 );
- }
-
- if( p_module->psz_program != NULL )
- {
- p_module->psz_program = strdup( p_module->psz_program );
- }
+ /* Skip ".", ".." and anything starting with "." */
+ if( !*file->d_name || *file->d_name == '.' )
+ {
+ continue;
+ }
- /* Everything worked fine ! The module is ready to be added to the list. */
- p_module->i_usage = 0;
- p_module->i_unused_delay = 0;
+ i_len = strlen( file->d_name );
+ psz_file = malloc( i_dirlen + 1 + i_len + 1 );
+#ifdef WIN32
+ sprintf( psz_file, "%s\\%s", psz_dir, file->d_name );
+#else
+ sprintf( psz_file, "%s/%s", psz_dir, file->d_name );
+#endif
- p_module->b_builtin = 0;
+ if( !stat( psz_file, &statbuf ) && statbuf.st_mode & S_IFDIR )
+ {
+ AllocatePluginDir( p_this, psz_file, i_maxdepth - 1 );
+ }
+ else if( i_len > strlen( LIBEXT )
+ /* We only load files ending with LIBEXT */
+ && !strncasecmp( file->d_name + i_len - strlen( LIBEXT ),
+ LIBEXT, strlen( LIBEXT ) ) )
+ {
+ AllocatePluginFile( p_this, psz_file );
+ }
- /* Link module into the linked list */
- if( p_module_bank->first != NULL )
- {
- p_module_bank->first->prev = p_module;
+ free( psz_file );
}
- p_module->next = p_module_bank->first;
- p_module->prev = NULL;
- p_module_bank->first = p_module;
- p_module_bank->i_count++;
- /* Immediate message so that a slow module doesn't make the user wait */
- intf_WarnMsg( 2, "module: new plugin module `%s', %s",
- p_module->psz_name, p_module->psz_longname );
+ /* Close the directory */
+ closedir( dir );
- return( 0 );
+#endif
}
-#endif /* HAVE_DYNAMIC_PLUGINS */
/*****************************************************************************
- * AllocateBuiltinModule: initialize a built-in module.
+ * AllocatePluginFile: load a module into memory and initialize it.
*****************************************************************************
- * This function registers a built-in module and allocates a structure
- * for its information data. The module can then be handled by module_Need,
- * module_Unneed and HideModule. It can be removed by DeleteModule.
+ * This function loads a dynamically loadable module and allocates a structure
+ * for its information data. The module can then be handled by module_Need
+ * and module_Unneed. It can be removed by DeleteModule.
*****************************************************************************/
-static int AllocateBuiltinModule( int ( *pf_init ) ( module_t * ),
- int ( *pf_activate ) ( module_t * ),
- int ( *pf_deactivate ) ( module_t * ) )
+static int AllocatePluginFile( vlc_object_t * p_this, MYCHAR * psz_file )
{
- module_t * p_module, * p_othermodule;
+ module_t * p_module;
+ module_handle_t handle;
- /* Now that we have successfully loaded the module, we can
- * allocate a structure for it */
- p_module = malloc( sizeof( module_t ) );
- if( p_module == NULL )
+ /*
+ * Try to dynamically load the module. This part is very platform-
+ * specific, and error messages should be as verbose as possible.
+ */
+
+#if defined(HAVE_DL_DYLD)
+ NSObjectFileImage image;
+ NSObjectFileImageReturnCode ret;
+
+ ret = NSCreateObjectFileImageFromFile( psz_file, &image );
+
+ if( ret != NSObjectFileImageSuccess )
{
- intf_ErrMsg( "module error: can't allocate p_module" );
- return( -1 );
+ msg_Warn( p_this, "cannot create image from `%s'", psz_file );
+ return -1;
}
- /* Initialize the module : fill p_module->psz_name, etc. */
- if( pf_init( p_module ) != 0 )
+ /* Open the dynamic module */
+ handle = NSLinkModule( image, psz_file,
+ NSLINKMODULE_OPTION_RETURN_ON_ERROR );
+
+ if( !handle )
{
- /* With a well-written module we shouldn't have to print an
- * additional error message here, but just make sure. */
- intf_ErrMsg( "module error: failed calling init in builtin module" );
- free( p_module );
- return( -1 );
+ NSLinkEditErrors errors;
+ const char *psz_file, *psz_err;
+ int i_errnum;
+ NSLinkEditError( &errors, &i_errnum, &psz_file, &psz_err );
+ msg_Warn( p_this, "cannot link module `%s' (%s)", psz_file, psz_err );
+ NSDestroyObjectFileImage( image );
+ return -1;
}
- /* Check that we don't already have a module with this name */
- for( p_othermodule = p_module_bank->first ;
- p_othermodule != NULL ;
- p_othermodule = p_othermodule->next )
+ /* Destroy our image, we won't need it */
+ NSDestroyObjectFileImage( image );
+
+#elif defined(HAVE_DL_BEOS)
+ handle = load_add_on( psz_file );
+ if( handle < 0 )
{
- if( !strcmp( p_othermodule->psz_name, p_module->psz_name ) )
- {
- intf_WarnMsg( 5, "module warning: cannot load builtin `%s', a "
- "module named `%s' already exists",
- p_module->psz_name, p_module->psz_name );
- free( p_module );
- return( -1 );
- }
+ msg_Warn( p_this, "cannot load module `%s'", psz_file );
+ return -1;
}
- if( pf_activate( p_module ) != 0 )
+#elif defined(HAVE_DL_WINDOWS) && defined(UNDER_CE)
+ char psz_filename[MAX_PATH];
+ WideCharToMultiByte( CP_ACP, WC_DEFAULTCHAR, psz_file, -1,
+ psz_filename, MAX_PATH, NULL, NULL );
+ handle = LoadLibrary( psz_filename );
+ if( handle == NULL )
{
- /* With a well-written module we shouldn't have to print an
- * additional error message here, but just make sure. */
- intf_ErrMsg( "module error: failed calling activate "
- "in builtin module" );
- free( p_module );
- return( -1 );
+ char *psz_error = GetWindowsError();
+ msg_Warn( p_this, "cannot load module `%s' (%s)",
+ psz_filename, psz_error );
+ free( psz_error );
}
- /* Everything worked fine ! The module is ready to be added to the list. */
- p_module->i_usage = 0;
- p_module->i_unused_delay = 0;
-
- p_module->b_builtin = 1;
- p_module->is.builtin.pf_deactivate = pf_deactivate;
-
- /* Link module into the linked list */
- if( p_module_bank->first != NULL )
+#elif defined(HAVE_DL_WINDOWS) && defined(WIN32)
+ handle = LoadLibrary( psz_file );
+ if( handle == NULL )
{
- p_module_bank->first->prev = p_module;
+ char *psz_error = GetWindowsError();
+ msg_Warn( p_this, "cannot load module `%s' (%s)",
+ psz_file, psz_error );
+ free( psz_error );
}
- p_module->next = p_module_bank->first;
- p_module->prev = NULL;
- p_module_bank->first = p_module;
- p_module_bank->i_count++;
-
- /* Immediate message so that a slow module doesn't make the user wait */
- intf_WarnMsg( 2, "module: new builtin module `%s', %s",
- p_module->psz_name, p_module->psz_longname );
- return( 0 );
-}
+#elif defined(HAVE_DL_DLOPEN) && defined(RTLD_NOW)
+ /* static is OK, we are called atomically */
+ static vlc_bool_t b_kde = VLC_FALSE;
-/*****************************************************************************
- * DeleteModule: delete a module and its structure.
- *****************************************************************************
- * This function can only be called if i_usage <= 0.
- *****************************************************************************/
-static int DeleteModule( module_t * p_module )
-{
- /* If the module is not in use but is still in memory, we first have
- * to hide it and remove it from memory before we can free the
- * data structure. */
- if( p_module->b_builtin )
+# if defined(SYS_LINUX)
+ /* XXX HACK #1 - we should NOT open modules with RTLD_GLOBAL, or we
+ * are going to get namespace collisions when two modules have common
+ * public symbols, but ALSA is being a pest here. */
+ if( strstr( psz_file, "alsa_plugin" ) )
{
- if( p_module->i_usage != 0 )
+ handle = dlopen( psz_file, RTLD_NOW | RTLD_GLOBAL );
+ if( handle == NULL )
{
- intf_ErrMsg( "module error: trying to free builtin module `%s' with"
- " usage %i", p_module->psz_name, p_module->i_usage );
- return( -1 );
- }
- else
- {
- /* We deactivate the module now. */
- p_module->is.builtin.pf_deactivate( p_module );
+ msg_Warn( p_this, "cannot load module `%s' (%s)",
+ psz_file, dlerror() );
+ return -1;
}
}
-#ifdef HAVE_DYNAMIC_PLUGINS
- else
+# endif
+ /* XXX HACK #2 - the ugly KDE workaround. It seems that libkdewhatever
+ * causes dlopen() to segfault if libstdc++ is not loaded in the caller,
+ * so we just load libstdc++. Bwahahaha! ph34r! -- Sam. */
+ /* Update: FYI, this is Debian bug #180505, and seems to be fixed. */
+ if( !b_kde && !strstr( psz_file, "kde" ) )
{
- if( p_module->i_usage >= 1 )
- {
- intf_ErrMsg( "module error: trying to free module `%s' which is"
- " still in use", p_module->psz_name );
- return( -1 );
- }
-
- /* Two possibilities here: i_usage == -1 and the module is already
- * unloaded, we can continue, or i_usage == 0, and we have to hide
- * the module before going on. */
- if( p_module->i_usage == 0 )
- {
- if( HideModule( p_module ) != 0 )
- {
- return( -1 );
- }
- }
+ dlopen( "libstdc++.so.6", RTLD_NOW )
+ || dlopen( "libstdc++.so.5", RTLD_NOW )
+ || dlopen( "libstdc++.so.4", RTLD_NOW )
+ || dlopen( "libstdc++.so.3", RTLD_NOW );
+ b_kde = VLC_TRUE;
}
-#endif
- /* Unlink the module from the linked list. */
- if( p_module->prev != NULL )
+ handle = dlopen( psz_file, RTLD_NOW );
+ if( handle == NULL )
{
- p_module->prev->next = p_module->next;
+ msg_Warn( p_this, "cannot load module `%s' (%s)",
+ psz_file, dlerror() );
+ return -1;
}
- else
+
+#elif defined(HAVE_DL_DLOPEN)
+# if defined(DL_LAZY)
+ handle = dlopen( psz_file, DL_LAZY );
+# else
+ handle = dlopen( psz_file, 0 );
+# endif
+ if( handle == NULL )
{
- p_module_bank->first = p_module->next;
+ msg_Warn( p_this, "cannot load module `%s' (%s)",
+ psz_file, dlerror() );
+ return -1;
}
- if( p_module->next != NULL )
+#elif defined(HAVE_DL_SHL_LOAD)
+ handle = shl_load( psz_file, BIND_IMMEDIATE | BIND_NONFATAL, NULL );
+ if( handle == NULL )
{
- p_module->next->prev = p_module->prev;
+ msg_Warn( p_this, "cannot load module `%s' (%s)",
+ psz_file, strerror(errno) );
+ return -1;
}
- p_module_bank->i_count--;
+#else
+# error "Something is wrong in modules.c"
- /* We free the structures that we strdup()ed in Allocate*Module(). */
-#ifdef HAVE_DYNAMIC_PLUGINS
- if( !p_module->b_builtin )
+#endif
+
+ /* Now that we have successfully loaded the module, we can
+ * allocate a structure for it */
+ p_module = vlc_object_create( p_this, VLC_OBJECT_MODULE );
+ if( p_module == NULL )
{
- char **pp_shortcut = p_module->pp_shortcuts;
+ msg_Err( p_this, "out of memory" );
+ CloseModule( handle );
+ return -1;
+ }
- for( ; *pp_shortcut ; pp_shortcut++ )
- {
- free( *pp_shortcut );
- }
+ /* We need to fill these since they may be needed by CallEntry() */
+#ifdef UNDER_CE
+ p_module->psz_filename = psz_filename;
+#else
+ p_module->psz_filename = psz_file;
+#endif
+ p_module->handle = handle;
+ p_module->p_symbols = &p_this->p_libvlc->p_module_bank->symbols;
- free( p_module->is.plugin.psz_filename );
- free( p_module->psz_name );
- free( p_module->psz_longname );
- free( p_module->psz_program );
+ /* Initialize the module: fill p_module->psz_object_name, default config */
+ if( CallEntry( p_module ) != 0 )
+ {
+ /* We couldn't call module_init() */
+ vlc_object_destroy( p_module );
+ CloseModule( handle );
+ return -1;
}
-#endif
- free( p_module );
+ DupModule( p_module );
+ p_module->psz_filename = strdup( p_module->psz_filename );
+ p_module->psz_longname = strdup( p_module->psz_longname );
- return( 0 );
+ /* Everything worked fine ! The module is ready to be added to the list. */
+ p_module->b_builtin = VLC_FALSE;
+
+ /* msg_Dbg( p_this, "plugin \"%s\", %s",
+ p_module->psz_object_name, p_module->psz_longname ); */
+
+ vlc_object_attach( p_module, p_this->p_libvlc->p_module_bank );
+
+ return 0;
}
/*****************************************************************************
- * LockModule: increase the usage count of a module and load it if needed.
+ * DupModule: make a plugin module standalone.
*****************************************************************************
- * This function has to be called before a thread starts using a module. If
- * the module is already loaded, we just increase its usage count. If it isn't
- * loaded, we have to dynamically open it and initialize it.
- * If you successfully call LockModule() at any moment, be careful to call
- * UnlockModule() when you don't need it anymore.
+ * This function duplicates all strings in the module, so that the dynamic
+ * object can be unloaded. It acts recursively on submodules.
*****************************************************************************/
-static int LockModule( module_t * p_module )
+static void DupModule( module_t *p_module )
{
- if( p_module->i_usage >= 0 )
+ char **pp_shortcut;
+ int i_submodule;
+
+ for( pp_shortcut = p_module->pp_shortcuts ; *pp_shortcut ; pp_shortcut++ )
+ {
+ *pp_shortcut = strdup( *pp_shortcut );
+ }
+
+ /* We strdup() these entries so that they are still valid when the
+ * module is unloaded. */
+ p_module->psz_object_name = strdup( p_module->psz_object_name );
+ p_module->psz_capability = strdup( p_module->psz_capability );
+
+ if( p_module->psz_program != NULL )
{
- /* This module is already loaded and activated, we can return */
- p_module->i_usage++;
- return( 0 );
+ p_module->psz_program = strdup( p_module->psz_program );
}
- if( p_module->b_builtin )
+ for( i_submodule = 0; i_submodule < p_module->i_children; i_submodule++ )
{
- /* A built-in module should always have a refcount >= 0 ! */
- intf_ErrMsg( "module error: built-in module `%s' has refcount %i",
- p_module->psz_name, p_module->i_usage );
- return( -1 );
+ DupModule( (module_t*)p_module->pp_children[ i_submodule ] );
}
+}
-#ifdef HAVE_DYNAMIC_PLUGINS
- if( p_module->i_usage != -1 )
+/*****************************************************************************
+ * UndupModule: free a duplicated module.
+ *****************************************************************************
+ * This function frees the allocations done in DupModule().
+ *****************************************************************************/
+static void UndupModule( module_t *p_module )
+{
+ char **pp_shortcut;
+ int i_submodule;
+
+ for( i_submodule = 0; i_submodule < p_module->i_children; i_submodule++ )
{
- /* This shouldn't happen. Ever. We have serious problems here. */
- intf_ErrMsg( "module error: plugin module `%s' has refcount %i",
- p_module->psz_name, p_module->i_usage );
- return( -1 );
+ UndupModule( (module_t*)p_module->pp_children[ i_submodule ] );
}
- /* i_usage == -1, which means that the module isn't in memory */
- if( module_load( p_module->is.plugin.psz_filename,
- &p_module->is.plugin.handle ) )
+ for( pp_shortcut = p_module->pp_shortcuts ; *pp_shortcut ; pp_shortcut++ )
{
- /* The plugin module couldn't be opened */
- intf_ErrMsg( "module error: cannot open %s (%s)",
- p_module->is.plugin.psz_filename, module_error() );
- return( -1 );
+ free( *pp_shortcut );
}
- /* FIXME: what to do if the guy modified the plugin while it was
- * unloaded ? It makes XMMS crash nastily, perhaps we should try
- * to be a bit more clever here. */
+ free( p_module->psz_object_name );
+ free( p_module->psz_capability );
- /* Activate the module : fill the capability structure, etc. */
- if( CallSymbol( p_module, "ActivateModule" MODULE_SUFFIX ) != 0 )
+ if( p_module->psz_program != NULL )
{
- /* We couldn't call ActivateModule() -- looks nasty, but
- * we can't do much about it. Just try to unload module. */
- module_unload( p_module->is.plugin.handle );
- p_module->i_usage = -1;
- return( -1 );
+ free( p_module->psz_program );
}
+}
- /* Everything worked fine ! The module is ready to be used */
- p_module->i_usage = 1;
#endif /* HAVE_DYNAMIC_PLUGINS */
- return( 0 );
-}
-
/*****************************************************************************
- * UnlockModule: decrease the usage count of a module.
+ * AllocateBuiltinModule: initialize a builtin module.
*****************************************************************************
- * We decrease the usage count of a module so that we know when a module
- * becomes unused and can be hidden.
+ * This function registers a builtin module and allocates a structure
+ * for its information data. The module can then be handled by module_Need
+ * and module_Unneed. It can be removed by DeleteModule.
*****************************************************************************/
-static int UnlockModule( module_t * p_module )
+static int AllocateBuiltinModule( vlc_object_t * p_this,
+ int ( *pf_entry ) ( module_t * ) )
{
- if( p_module->i_usage <= 0 )
+ module_t * p_module;
+
+ /* Now that we have successfully loaded the module, we can
+ * allocate a structure for it */
+ p_module = vlc_object_create( p_this, VLC_OBJECT_MODULE );
+ if( p_module == NULL )
{
- /* This shouldn't happen. Ever. We have serious problems here. */
- intf_ErrMsg( "module error: trying to call module_Unneed() on `%s'"
- " which isn't even in use", p_module->psz_name );
- return( -1 );
+ msg_Err( p_this, "out of memory" );
+ return -1;
}
- /* This module is still in use, we can return */
- p_module->i_usage--;
- p_module->i_unused_delay = 0;
+ /* Initialize the module : fill p_module->psz_object_name, etc. */
+ if( pf_entry( p_module ) != 0 )
+ {
+ /* With a well-written module we shouldn't have to print an
+ * additional error message here, but just make sure. */
+ msg_Err( p_this, "failed calling entry point in builtin module" );
+ vlc_object_destroy( p_module );
+ return -1;
+ }
- return( 0 );
+ /* Everything worked fine ! The module is ready to be added to the list. */
+ p_module->b_builtin = VLC_TRUE;
+
+ /* msg_Dbg( p_this, "builtin \"%s\", %s",
+ p_module->psz_object_name, p_module->psz_longname ); */
+
+ vlc_object_attach( p_module, p_this->p_libvlc->p_module_bank );
+
+ return 0;
}
-#ifdef HAVE_DYNAMIC_PLUGINS
/*****************************************************************************
- * HideModule: remove a module from memory but keep its structure.
+ * DeleteModule: delete a module and its structure.
*****************************************************************************
- * This function can only be called if i_usage == 0. It will make a call
- * to the module's inner DeactivateModule() symbol, and then unload it
- * from memory. A call to module_Need() will automagically load it again.
+ * This function can only be called if the module isn't being used.
*****************************************************************************/
-static int HideModule( module_t * p_module )
+static int DeleteModule( module_t * p_module )
{
- if( p_module->b_builtin )
- {
- /* A built-in module should never be hidden. */
- intf_ErrMsg( "module error: trying to hide built-in module `%s'",
- p_module->psz_name );
- return( -1 );
- }
+ vlc_object_detach( p_module );
- if( p_module->i_usage >= 1 )
- {
- intf_ErrMsg( "module error: trying to hide module `%s' which is still"
- " in use", p_module->psz_name );
- return( -1 );
- }
-
- if( p_module->i_usage <= -1 )
+ /* We free the structures that we strdup()ed in Allocate*Module(). */
+#ifdef HAVE_DYNAMIC_PLUGINS
+ if( !p_module->b_builtin )
{
- intf_ErrMsg( "module error: trying to hide module `%s' which is already"
- " hidden", p_module->psz_name );
- return( -1 );
+ if( p_module->b_unloadable )
+ {
+ CloseModule( p_module->handle );
+ }
+ UndupModule( p_module );
+ free( p_module->psz_filename );
+ free( p_module->psz_longname );
}
+#endif
- /* Deactivate the module : free the capability structure, etc. */
- if( CallSymbol( p_module, "DeactivateModule" MODULE_SUFFIX ) != 0 )
+ /* Free and detach the object's children */
+ while( p_module->i_children )
{
- /* We couldn't call DeactivateModule() -- looks nasty, but
- * we can't do much about it. Just try to unload module anyway. */
- module_unload( p_module->is.plugin.handle );
- p_module->i_usage = -1;
- return( -1 );
+ vlc_object_t *p_this = p_module->pp_children[0];
+ vlc_object_detach( p_this );
+ vlc_object_destroy( p_this );
}
- /* Everything worked fine, we can safely unload the module. */
- module_unload( p_module->is.plugin.handle );
- p_module->i_usage = -1;
+ config_Free( p_module );
+ vlc_object_destroy( p_module );
- return( 0 );
+ return 0;
}
+#ifdef HAVE_DYNAMIC_PLUGINS
/*****************************************************************************
- * CallSymbol: calls a module symbol.
+ * CallEntry: call an entry point.
*****************************************************************************
* This function calls a symbol given its name and a module structure. The
* symbol MUST refer to a function returning int and taking a module_t* as
* an argument.
*****************************************************************************/
-static int CallSymbol( module_t * p_module, char * psz_name )
+static int CallEntry( module_t * p_module )
{
+ static char *psz_name = "vlc_entry" MODULE_SUFFIX;
int (* pf_symbol) ( module_t * p_module );
/* Try to resolve the symbol */
- pf_symbol = module_getsymbol( p_module->is.plugin.handle, psz_name );
+ pf_symbol = (int (*)(module_t *)) GetSymbol( p_module->handle, psz_name );
if( pf_symbol == NULL )
{
- /* We couldn't load the symbol */
- intf_WarnMsg( 1, "module warning: "
- "cannot find symbol %s in module %s (%s)",
- psz_name, p_module->is.plugin.psz_filename,
- module_error() );
- return( -1 );
+#if defined(HAVE_DL_DYLD) || defined(HAVE_DL_BEOS)
+ msg_Warn( p_module, "cannot find symbol \"%s\" in file `%s'",
+ psz_name, p_module->psz_filename );
+#elif defined(HAVE_DL_WINDOWS)
+ char *psz_error = GetWindowsError();
+ msg_Warn( p_module, "cannot find symbol \"%s\" in file `%s' (%s)",
+ psz_name, p_module->psz_filename, psz_error );
+ free( psz_error );
+#elif defined(HAVE_DL_DLOPEN)
+ msg_Warn( p_module, "cannot find symbol \"%s\" in file `%s' (%s)",
+ psz_name, p_module->psz_filename, dlerror() );
+#elif defined(HAVE_DL_SHL_LOAD)
+ msg_Warn( p_module, "cannot find symbol \"%s\" in file `%s' (%s)",
+ psz_name, p_module->psz_filename, strerror(errno) );
+#else
+# error "Something is wrong in modules.c"
+#endif
+ return -1;
}
/* We can now try to call the symbol */
{
/* With a well-written module we shouldn't have to print an
* additional error message here, but just make sure. */
- intf_ErrMsg( "module error: failed calling symbol %s in module %s",
- psz_name, p_module->is.plugin.psz_filename );
- return( -1 );
+ msg_Err( p_module, "failed calling symbol \"%s\" in file `%s'",
+ psz_name, p_module->psz_filename );
+ return -1;
}
/* Everything worked fine, we can return */
- return( 0 );
+ return 0;
}
-#endif /* HAVE_DYNAMIC_PLUGINS */
+/*****************************************************************************
+ * CloseModule: unload a dynamic library
+ *****************************************************************************
+ * This function unloads a previously opened dynamically linked library
+ * using a system dependant method. No return value is taken in consideration,
+ * since some libraries sometimes refuse to close properly.
+ *****************************************************************************/
+static void CloseModule( module_handle_t handle )
+{
+#if defined(HAVE_DL_DYLD)
+ NSUnLinkModule( handle, FALSE );
+
+#elif defined(HAVE_DL_BEOS)
+ unload_add_on( handle );
+
+#elif defined(HAVE_DL_WINDOWS)
+ FreeLibrary( handle );
+
+#elif defined(HAVE_DL_DLOPEN)
+ dlclose( handle );
+
+#elif defined(HAVE_DL_SHL_LOAD)
+ shl_unload( handle );
+
+#endif
+ return;
+}
+
+/*****************************************************************************
+ * GetSymbol: get a symbol from a dynamic library
+ *****************************************************************************
+ * This function queries a loaded library for a symbol specified in a
+ * string, and returns a pointer to it. We don't check for dlerror() or
+ * similar functions, since we want a non-NULL symbol anyway.
+ *****************************************************************************/
+static void * _module_getsymbol( module_handle_t, const char * );
+
+static void * GetSymbol( module_handle_t handle, const char * psz_function )
+{
+ void * p_symbol = _module_getsymbol( handle, psz_function );
+
+ /* MacOS X dl library expects symbols to begin with "_". So do
+ * some other operating systems. That's really lame, but hey, what
+ * can we do ? */
+ if( p_symbol == NULL )
+ {
+ char *psz_call = malloc( strlen( psz_function ) + 2 );
+
+ strcpy( psz_call + 1, psz_function );
+ psz_call[ 0 ] = '_';
+ p_symbol = _module_getsymbol( handle, psz_call );
+ free( psz_call );
+ }
+
+ return p_symbol;
+}
+
+static void * _module_getsymbol( module_handle_t handle,
+ const char * psz_function )
+{
+#if defined(HAVE_DL_DYLD)
+ NSSymbol sym = NSLookupSymbolInModule( handle, psz_function );
+ return NSAddressOfSymbol( sym );
+
+#elif defined(HAVE_DL_BEOS)
+ void * p_symbol;
+ if( B_OK == get_image_symbol( handle, psz_function,
+ B_SYMBOL_TYPE_TEXT, &p_symbol ) )
+ {
+ return p_symbol;
+ }
+ else
+ {
+ return NULL;
+ }
+
+#elif defined(HAVE_DL_WINDOWS) && defined(UNDER_CE)
+ wchar_t psz_real[256];
+ MultiByteToWideChar( CP_ACP, 0, psz_function, -1, psz_real, 256 );
+
+ return (void *)GetProcAddress( handle, psz_real );
+
+#elif defined(HAVE_DL_WINDOWS) && defined(WIN32)
+ return (void *)GetProcAddress( handle, (MYCHAR*)psz_function );
+
+#elif defined(HAVE_DL_DLOPEN)
+ return dlsym( handle, psz_function );
+
+#elif defined(HAVE_DL_SHL_LOAD)
+ void *p_sym;
+ shl_findsym( &handle, psz_function, TYPE_UNDEFINED, &p_sym );
+ return p_sym;
+
+#endif
+}
+
+#if defined(HAVE_DL_WINDOWS)
+static char * GetWindowsError( void )
+{
+#if defined(UNDER_CE)
+ wchar_t psz_tmp[256];
+ char * psz_buffer = malloc( 256 );
+#else
+ char * psz_tmp = malloc( 256 );
+#endif
+ int i = 0, i_error = GetLastError();
+
+ FormatMessage( FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS,
+ NULL, i_error, MAKELANGID (LANG_NEUTRAL, SUBLANG_DEFAULT),
+ (LPTSTR) psz_tmp, 256, NULL );
+
+ /* Go to the end of the string */
+#if defined(UNDER_CE)
+ while( psz_tmp[i] && psz_tmp[i] != L'\r' && psz_tmp[i] != L'\n' )
+#else
+ while( psz_tmp[i] && psz_tmp[i] != '\r' && psz_tmp[i] != '\n' )
+#endif
+ {
+ i++;
+ }
+
+ if( psz_tmp[i] )
+ {
+#if defined(UNDER_CE)
+ swprintf( psz_tmp + i, L" (error %i)", i_error );
+ psz_tmp[ 255 ] = L'\0';
+#else
+ snprintf( psz_tmp + i, 256 - i, " (error %i)", i_error );
+ psz_tmp[ 255 ] = '\0';
+#endif
+ }
+
+#if defined(UNDER_CE)
+ WideCharToMultiByte( CP_ACP, WC_DEFAULTCHAR, psz_tmp, -1,
+ psz_buffer, 256, NULL, NULL );
+ return psz_buffer;
+#else
+ return psz_tmp;
+#endif
+}
+#endif /* HAVE_DL_WINDOWS */
+
+#endif /* HAVE_DYNAMIC_PLUGINS */