svn_dso.h File Reference

DSO loading routines. More...

#include <apr_dso.h>
#include "svn_error.h"

Go to the source code of this file.

Functions

svn_error_tsvn_dso_initialize2 (void)
 Initialize the DSO loading routines.
SVN_DEPRECATED void svn_dso_initialize (void)
 Initialize the DSO loading routines.
svn_error_tsvn_dso_load (apr_dso_handle_t **dso, const char *libname)
 Attempt to load libname, returning it in dso.


Detailed Description

DSO loading routines.

Definition in file svn_dso.h.


Function Documentation

SVN_DEPRECATED void svn_dso_initialize void   ) 
 

Initialize the DSO loading routines.

Note:
This should be called prior to the creation of any pool that is passed to a function that comes from a DSO, otherwise you risk having the DSO unloaded before all pool cleanup callbacks that live in the DSO have been executed. If it is not called prior to svn_dso_load being used for the first time there will be a best effort attempt made to initialize the subsystem, but it will not be entirely thread safe and it risks running into the previously mentioned problems with DSO unloading and pool cleanup callbacks.
Calls svn_dso_initialize2(void) upon error aborts.

Deprecated:
Provided for backwards compatibility with the 1.5 API.
Since:
New in 1.4.

svn_error_t* svn_dso_initialize2 void   ) 
 

Initialize the DSO loading routines.

Note:
This should be called prior to the creation of any pool that is passed to a function that comes from a DSO, otherwise you risk having the DSO unloaded before all pool cleanup callbacks that live in the DSO have been executed. If it is not called prior to svn_dso_load being used for the first time there will be a best effort attempt made to initialize the subsystem, but it will not be entirely thread safe and it risks running into the previously mentioned problems with DSO unloading and pool cleanup callbacks.
Returns svn_error_t object with corresponding apr_err returned by underlying calls. In case of no error returns SVN_NO_ERROR.

Since:
New in 1.6.

svn_error_t* svn_dso_load apr_dso_handle_t **  dso,
const char *  libname
 

Attempt to load libname, returning it in dso.

If libname cannot be loaded set dso to NULL and return SVN_NO_ERROR.

Note:
Due to pool lifetime issues DSOs are all loaded into a global pool, so you must be certain that there is a bounded number of them that will ever be loaded by the system, otherwise you will leak memory.
Since:
New in 1.4.


Generated on Tue Oct 7 04:09:55 2008 for Subversion by  doxygen 1.3.9.1