plugin.c File Reference

Include dependency graph for plugin.c:

Functions
char *	vlc_dlerror (void)
	Formats an error message for vlc_dlopen() or vlc_dlsym().
void *	vlc_dlopen (const char *psz_file, bool lazy)
	Loads a dynamically linked library.
int	vlc_dlclose (void *handle)
	Unloads a dynamic library.
void *	vlc_dlsym (void *handle, const char *psz_function)
	Looks up a symbol from a dynamically loaded library.

Function Documentation

vlc_dlclose()

int vlc_dlclose

(

void *

handle

)

Unloads a dynamic library.

This function unloads a previously opened dynamically linked library using a system dependent method.

Parameters

handle

handle of the library

Return values

0	on success
-1	on error (none are defined though)

vlc_dlerror()

char * vlc_dlerror

(

void

)

Formats an error message for vlc_dlopen() or vlc_dlsym().

Returns

a heap-allocated nul-terminated error string, or NULL.

References FromLocaleDup.

vlc_dlopen()

void * vlc_dlopen	(	const char *	path,
		bool	lazy
	)

Loads a dynamically linked library.

Parameters

path	library file path
lazy	whether to resolve the symbols lazily

Returns

a module handle on success, or NULL on error.

References ToLocaleDup, and unlikely.

vlc_dlsym()

void * vlc_dlsym	(	void *	handle,
		const char *	name
	)

Looks up a symbol from a dynamically loaded library.

This function looks for a named symbol within a loaded library.

Parameters

handle	handle to the library
name	function name

Returns

the address of the symbol on success, or NULL on error

Note

If the symbol address is NULL, errors cannot be detected. However, normal symbols such as function or global variables cannot have NULL as their address.