Dynamic Object Handling
[Apache Portability Runtime library]


Typedefs

typedef apr_dso_handle_t apr_dso_handle_t
typedef void * apr_dso_handle_sym_t

Functions

apr_status_t apr_dso_load (apr_dso_handle_t **res_handle, const char *path, apr_pool_t *ctx)
apr_status_t apr_dso_unload (apr_dso_handle_t *handle)
apr_status_t apr_dso_sym (apr_dso_handle_sym_t *ressym, apr_dso_handle_t *handle, const char *symname)
const char * apr_dso_error (apr_dso_handle_t *dso, char *buf, apr_size_t bufsize)

Typedef Documentation

typedef void* apr_dso_handle_sym_t

Structure for referencing symbols from dynamic objects

typedef struct apr_dso_handle_t apr_dso_handle_t

Structure for referencing dynamic objects


Function Documentation

const char* apr_dso_error ( apr_dso_handle_t dso,
char *  buf,
apr_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

apr_status_t apr_dso_load ( apr_dso_handle_t **  res_handle,
const char *  path,
apr_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.

apr_status_t apr_dso_sym ( apr_dso_handle_sym_t ressym,
apr_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.

apr_status_t apr_dso_unload ( apr_dso_handle_t handle  ) 

Close a DSO library.

Parameters:
handle handle to close.


Generated on Mon Nov 26 11:47:27 2007 for Apache Portable Runtime by  doxygen 1.5.2