Dynamic binaries handling
[Portability layer]

Modules
	Shared library binding modes
Defines
#define	PORT_DSO_NAME(name)
	Decorates the shared library name (.dll <-> lib*.so).
#define	PORT_DSO_NAME(name)   PORT_DSO_PREFIX name PORT_DSO_EXT
	Decorates the shared library name (.dll <-> lib*.so).
Functions
apr_status_t	port_dso_load_ex (apr_dso_handle_t **handle, const char *path, uint32 mode, apr_pool_t *pool)
	Loads the shared binary file, an executable or a library.
apr_status_t	port_dso_search_path (char **path, apr_pool_t *pool)
	Returns the list of directories wher the OS searches for libraries.
char *	port_dso_name_decorate (const char *dl_name, apr_pool_t *pool)
	Decorates shared library name (.dll <-> lib*.so).

---

Define Documentation

#define PORT_DSO_NAME

(

name

)

Decorates the shared library name (.dll <-> lib*.so).

The name parameter should be double-quoted string.

#define PORT_DSO_NAME

(

name

)

PORT_DSO_PREFIX name PORT_DSO_EXT

Decorates the shared library name (.dll <-> lib*.so).

The name parameter should be double-quoted string.

---

Function Documentation

apr_status_t port_dso_load_ex	(	apr_dso_handle_t **	handle,
		const char *	path,
		uint32	mode,
		apr_pool_t *	pool
	)

Loads the shared binary file, an executable or a library.

Parameters:

[out]	handle	- a handle to the loaded object
	path	- the path to the binary
	mode	- the flag to control resolution/relocation of dynamic symbols in the loaded object, see PORT_DSO_BIND_* defines.
	pool	- storage to allocate the returned handle

Returns:

APR_SUCCESS if OK; otherwise, an error code.

apr_status_t port_dso_search_path	(	char **	path,
		apr_pool_t *	pool
	)

Returns the list of directories wher the OS searches for libraries.

Parameters:

[out]	path	- the pointer to the path list
	pool	- the storage to allocate the returned buffer

Returns:

APR_SUCCESS if OK; otherwise, an error code.

char* port_dso_name_decorate	(	const char *	dl_name,
		apr_pool_t *	pool
	)

Decorates shared library name (.dll <-> lib*.so).

Parameters:

	dl_name	- the name of the shared library
	pool	- storage to allocate the returned handle

Returns:

The platform-specific filename for the library.

---