Loading...
Searching...
No Matches
svn_dso.h
Go to the documentation of this file.
/**
* @copyright
* ====================================================================
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
* ====================================================================
* @endcopyright
*
* @file svn_dso.h
* @brief DSO loading routines
*/
␌
#ifndef SVN_DSO_H
#define SVN_DSO_H
#include <apr_dso.h>
#include "svn_types.h"
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/**
* 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 @c 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 @c SVN_NO_ERROR.
*
* @since New in 1.6.
*/
svn_error_t *
svn_dso_initialize2(void);
/** The same as svn_dso_initialize2(), except that if there is an error this
* calls abort() instead of returning the error.
*
* @deprecated Provided for backwards compatibility with the 1.5 API.
*
* @since New in 1.4.
*/
SVN_DEPRECATED
void
svn_dso_initialize(void);
#if APR_HAS_DSO
/**
* Attempt to load @a libname, returning it in @a *dso.
*
* If @a libname cannot be loaded set @a *dso to NULL and return
* @c 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.
*/
svn_error_t *
svn_dso_load(apr_dso_handle_t **dso,
const char *libname);
#endif /* APR_HAS_DSO */
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* SVN_DSO_H */
svn_error_t
Subversion error object.
Definition svn_types.h:181
svn_dso_initialize2
svn_error_t * svn_dso_initialize2(void)
Initialize the DSO loading routines.
svn_dso_initialize
void svn_dso_initialize(void)
The same as svn_dso_initialize2(), except that if there is an error this calls abort() instead of ret...
svn_types.h
Subversion's data types.
SVN_DEPRECATED
#define SVN_DEPRECATED
Macro used to mark deprecated functions.
Definition svn_types.h:62