Dynamic Object Handling Routines
[Brought To You By APR]

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

typedef struct apr_dso_handle_t switch_dso_handle_t

Structure for referencing dynamic objects

---

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 { 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. { 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. { 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. { return apr_dso_unload(handle); }

---