Dynamic Object Handling Routines
[Brought To You By APR]

Collaboration diagram for Dynamic Object Handling Routines:

Typedefs
typedef apr_dso_handle_t	switch_dso_handle_t
typedef void *	switch_dso_handle_sym_t
Functions
switch_status_t	switch_dso_load (switch_dso_handle_t **res_handle, const char *path, switch_memory_pool_t *ctx)
switch_status_t	switch_dso_unload (switch_dso_handle_t *handle)
switch_status_t	switch_dso_sym (switch_dso_handle_sym_t *ressym, switch_dso_handle_t *handle, const char *symname)
const char *	switch_dso_error (switch_dso_handle_t *dso, char *buf, size_t bufsize)

---

Typedef Documentation

typedef void* switch_dso_handle_sym_t

Structure for referencing symbols from dynamic objects

Definition at line 104 of file switch_apr.h.

typedef struct apr_dso_handle_t switch_dso_handle_t

Structure for referencing dynamic objects

Definition at line 99 of file switch_apr.h.

---

Function Documentation

const char* switch_dso_error	(	switch_dso_handle_t *	dso,
		char *	buf,
		size_t	bufsize
	)

Report more information when a DSO function fails.

Parameters:

	dso	The dso handle that has been opened
	buf	Location to store the dso error
	bufsize	The size of the provided buffer

Definition at line 142 of file switch_apr.c.

{
        return apr_dso_error(dso, buf, bufsize);
}

switch_status_t switch_dso_load	(	switch_dso_handle_t **	res_handle,
		const char *	path,
		switch_memory_pool_t *	ctx
	)

Load a DSO library.

Parameters:

	res_handle	Location to store new handle for the DSO.
	path	Path to the DSO library
	ctx	Pool to use.

Bug:

We aught to provide an alternative to RTLD_GLOBAL, which is the only supported method of loading DSOs today.

Definition at line 127 of file switch_apr.c.

{
        return apr_dso_load(res_handle, path, ctx);
}

switch_status_t switch_dso_sym	(	switch_dso_handle_sym_t *	ressym,
		switch_dso_handle_t *	handle,
		const char *	symname
	)

Load a symbol from a DSO handle.

Parameters:

	ressym	Location to store the loaded symbol
	handle	handle to load the symbol from.
	symname	Name of the symbol to load.

Definition at line 137 of file switch_apr.c.

{
        return apr_dso_sym(ressym, handle, symname);
}

switch_status_t switch_dso_unload

(

switch_dso_handle_t *

handle

)

Close a DSO library.

Parameters:

handle

handle to close.

Definition at line 132 of file switch_apr.c.

{
        return apr_dso_unload(handle);
}

---