Include dependency graph for modules.c:

Functions
bool	module_provides (const module_t m, const char cap)
	Checks whether a module implements a capability. More...

const char *	module_get_object (const module_t *m)
	Gets the internal name of a module. More...

const char *	module_get_name (const module_t *m, bool long_name)
	Gets the human-friendly name of a module. More...

const char *	module_get_help (const module_t *m)
	Gets the help text for a module. More...

const char *	module_get_capability (const module_t *m)
	Gets the capability string of a module. More...

int	module_get_score (const module_t *m)
	Gets the precedence of a module. More...

const char *	module_gettext (const module_t m, const char str)
	Translates a string using the module's text domain. More...

static bool	module_match_name (const module_t m, const char name, size_t len)

static int	module_load (vlc_logger_t log, module_t m, vlc_activate_t init, bool forced, va_list args)

module_t *()	vlc_module_load (struct vlc_logger log, const char capability, const char *name, bool strict, vlc_activate_t probe,...)
	Finds and instantiates the best module of a certain type. More...

static int	generic_start (void *func, bool forced, va_list ap)

module_t *	module_need (vlc_object_t obj, const char cap, const char *name, bool strict)

void	module_unneed (vlc_object_t obj, module_t module)

module_t *	module_find (const char *name)
	Get a pointer to a module_t given it's name. More...

bool	module_exists (const char *psz_name)
	Checks if a module exists. More...

module_config_t *	module_config_get (const module_t module, unsigned restrict psize)
	Gets the table of module configuration items. More...

void	module_config_free (module_config_t *config)
	Releases the configuration items table. More...

Function Documentation

◆ generic_start()

static int generic_start	(	void *	func,
		bool	forced,
		va_list	ap
	)

static

References vlc_object_t::force, vlc_objres_clear(), and VLC_SUCCESS.

Referenced by module_need().

◆ module_config_free()

void module_config_free ( module_config_t * tab )

Releases the configuration items table.

Parameters

tab	base address of a table returned by module_config_get()

◆ module_config_get()

module_config_t* module_config_get	(	const module_t *	module,
		unsigned *restrict	psize
	)

Gets the table of module configuration items.

Note: Use module_config_free() to release the allocated memory.

Parameters

module	the module
psize	the size of the configuration returned

Returns: the configuration as an array

References module_config_t::b_internal, module_config_t::b_removed, vlc_plugin_t::conf, config, vlc_plugin_t::items, vlc_plugin_t::module, module_t::plugin, vlc_plugin_t::size, and vlc_alloc().

◆ module_exists()

bool module_exists ( const char * )

Checks if a module exists.

Parameters

name	name of the module

Return values

true	if the module exists
false	if the module does not exist (in the running installation)

References module_find().

Referenced by aout_New().

◆ module_find()

module_t* module_find ( const char * name )

Get a pointer to a module_t given it's name.

Parameters

name	the name of the module

Returns: a pointer to the module or NULL in case of a failure

References count, module_t::i_shortcuts, list, module_list_free(), module_list_get(), module_t::pp_shortcuts, and unlikely.

Referenced by module_exists(), and module_get_main().

◆ module_get_capability()

const char* module_get_capability ( const module_t * m )

Gets the capability string of a module.

Parameters

m	the module

Returns: the capability, or "none" if unspecified

References module_t::psz_capability.

Referenced by module_provides(), and vlc_module_store().

◆ module_get_help()

const char* module_get_help ( const module_t * m )

Gets the help text for a module.

Parameters

m	the module

Returns: the help

References module_t::psz_help.

◆ module_get_name()

const char* module_get_name	(	const module_t *	m,
		bool	longname
	)

Gets the human-friendly name of a module.

Parameters

m	the module
longname	TRUE to have the long name of the module

Returns: the short or long name of the module

References module_get_object(), module_t::psz_longname, and module_t::psz_shortname.

Referenced by config_ListModules(), demux_filter_enable_disable(), and filter_chain_AppendInner().

◆ module_get_object()

const char* module_get_object ( const module_t * m )

Gets the internal name of a module.

Parameters

m	the module

Returns: the module name

References module_t::i_shortcuts, module_t::pp_shortcuts, and unlikely.

Referenced by config_ListModules(), config_SaveConfigFile(), ListModules(), module_get_name(), module_is_main(), module_match(), module_need(), module_unneed(), Usage(), and vlc_module_load().

◆ module_get_score()

int module_get_score ( const module_t * m )

Gets the precedence of a module.

Parameters

m	the module return the score for the capability

References module_t::i_score.

Referenced by vlc_module_load().

◆ module_gettext()

const char* module_gettext	(	const module_t *	m,
		const char *	s
	)

Translates a string using the module's text domain.

Parameters

m	the module
s	the American English ASCII string to localize

Returns: the gettext-translated string

References module_t::plugin, vlc_plugin_t::textdomain, and unlikely.

Referenced by config_ListModules(), ListModules(), print_item(), print_section(), and Usage().

◆ module_load()

static int module_load	(	vlc_logger_t *	log,
		module_t *	m,
		vlc_activate_t	init,
		bool	forced,
		va_list	args
	)

static

References init, module_Map(), module_t::pf_activate, module_t::plugin, VLC_EGENERIC, and VLC_SUCCESS.

Referenced by vlc_module_load().

◆ module_match_name()

static bool module_match_name	(	const module_t *	m,
		const char *	name,
		size_t	len
	)

static

References module_t::i_score, module_t::i_shortcuts, and module_t::pp_shortcuts.

Referenced by vlc_module_load().

◆ module_need()

module_t* module_need	(	vlc_object_t *	obj,
		const char *	cap,
		const char *	name,
		bool	strict
	)

References vlc_object_t::force, generic_start(), vlc_object_t::logger, module_get_object(), var_Create(), var_SetString(), vlc_module_load(), and VLC_VAR_STRING.

◆ module_provides()

bool module_provides	(	const module_t *	m,
		const char *	cap
	)

Checks whether a module implements a capability.

Parameters

m	the module
cap	the capability to check

Return values

true	if the module has the capability
false	if the module has another capability

References module_get_capability().

◆ module_unneed()

void module_unneed	(	vlc_object_t *	obj,
		module_t *	module
	)

References module_t::deactivate, module_get_object(), msg_Dbg, var_Destroy(), and vlc_objres_clear().

◆ vlc_module_load()

module_t*() vlc_module_load	(	struct vlc_logger *	log,
		const char *	capability,
		const char *	name,
		bool	strict,
		vlc_activate_t	probe,
			...
	)

Finds and instantiates the best module of a certain type.

All candidates modules having the specified capability and name will be sorted in decreasing order of priority. Then the probe callback will be invoked for each module, until it succeeds (returns 0), or all candidate module failed to initialize.

The probe callback first parameter is the address of the module entry point. Further parameters are passed as an argument list; it corresponds to the variable arguments passed to this function. This scheme is meant to support arbitrary prototypes for the module entry point.

Parameters

log	logger (or NULL to ignore)
capability	capability, i.e. class of module
name	name of the module asked, if any
strict	if true, do not fallback to plugin with a different name but the same capability
probe	module probe callback

Returns: the module or NULL in case of a failure

References module_get_object(), module_get_score(), module_list_cap(), module_list_free(), module_load(), module_match_name(), name, strcasecmp(), vlc_debug, VLC_ETIMEOUT, and VLC_SUCCESS.

Referenced by module_need().

Functions

Function Documentation

◆ generic_start()

◆ module_config_free()

◆ module_config_get()

◆ module_exists()

◆ module_find()

◆ module_get_capability()

◆ module_get_help()

◆ module_get_name()

◆ module_get_object()

◆ module_get_score()

◆ module_gettext()

◆ module_load()

◆ module_match_name()

◆ module_need()

◆ module_provides()

◆ module_unneed()

◆ vlc_module_load()