svn_error.h File Reference

Common exception handling for Subversion. More...

#include <apr.h>
#include <apr_errno.h>
#include <apr_pools.h>
#include <apr_want.h>
#include "svn_types.h"
#include "svn_error_codes.h"

Go to the source code of this file.

Defines
#define	SVN_NO_ERROR   0
	the best kind of (svn_error_t *) !
#define	SVN_ERR(expr)
	A statement macro for checking error values.
#define	svn_error_trace(expr)   (expr)
	A macro for wrapping an error in a source-location trace message.
#define	SVN_ERR_W(expr, wrap_msg)
	A statement macro, very similar to SVN_ERR.
#define	SVN_INT_ERR(expr)
	A statement macro, similar to SVN_ERR, but returns an integer.
#define	SVN_ERR_IS_LOCK_ERROR(err)
	Return TRUE if err is an error specifically related to locking a path in the repository, FALSE otherwise.
#define	SVN_ERR_IS_UNLOCK_ERROR(err)
	Return TRUE if err is an error specifically related to unlocking a path in the repository, FALSE otherwise.
#define	SVN_ERROR_IN_CATEGORY(apr_err, category)   ((category) == ((apr_err) / SVN_ERR_CATEGORY_SIZE) * SVN_ERR_CATEGORY_SIZE)
	Evaluates to TRUE iff apr_err (of type #apr_status_t) is in the given category, which should be one of the SVN_ERR_*_CATEGORY_START constants.
#define	SVN_ERR_MALFUNCTION()
	Report that an internal malfunction has occurred, and possibly terminate the program.
#define	SVN_ERR_MALFUNCTION_NO_RETURN()
	Similar to SVN_ERR_MALFUNCTION(), but without the option of returning an error to the calling function.
#define	SVN_ERR_ASSERT(expr)
	Check that a condition is true: if not, report an error and possibly terminate the program.
#define	SVN_ERR_ASSERT_NO_RETURN(expr)
	Similar to SVN_ERR_ASSERT(), but without the option of returning an error to the calling function.
#define	SVN__NOT_IMPLEMENTED()   return svn_error__malfunction(TRUE, __FILE__, __LINE__, "Not implemented.")
	Report a "Not implemented" malfunction.
Typedefs
typedef svn_error_t *(*	svn_error_malfunction_handler_t )(svn_boolean_t can_return, const char *file, int line, const char *expr)
	A type of function that handles an assertion failure or other internal malfunction detected within the Subversion libraries.
Functions
char *	svn_strerror (apr_status_t statcode, char *buf, apr_size_t bufsize)
	Put an English description of statcode into buf and return buf, NULL-terminated.
const char *	svn_err_best_message (svn_error_t *err, char *buf, apr_size_t bufsize)
	If err has a custom error message, return that, otherwise store the generic error string associated with err->apr_err into buf (terminating with NULL) and return buf.
svn_error_t *	svn_error_create (apr_status_t apr_err, svn_error_t *child, const char *message)
	Create a nested exception structure.
svn_error_t *	svn_error_createf (apr_status_t apr_err, svn_error_t *child, const char *fmt,...)
	Create an error structure with the given apr_err and child, with a printf-style error message produced by passing fmt, using apr_psprintf().
svn_error_t *	svn_error_wrap_apr (apr_status_t status, const char *fmt,...)
	Wrap a status from an APR function.
svn_error_t *	svn_error_quick_wrap (svn_error_t *child, const char *new_msg)
	A quick n' easy way to create a wrapped exception with your own message, before throwing it up the stack.
svn_error_t *	svn_error_compose_create (svn_error_t *err1, svn_error_t *err2)
	Compose two errors, returning the composition as a brand new error and consuming the original errors.
void	svn_error_compose (svn_error_t *chain, svn_error_t *new_err)
	Add new_err to the end of chain's chain of errors.
svn_error_t *	svn_error_root_cause (svn_error_t *err)
	Return the root cause of err by finding the last error in its chain (e.g.
svn_error_t *	svn_error_find_cause (svn_error_t *err, apr_status_t apr_err)
	Return the first error in err's chain that has an error code apr_err or SVN_NO_ERROR if there is no error with that code.
svn_error_t *	svn_error_dup (svn_error_t *err)
	Create a new error that is a deep copy of err and return it.
void	svn_error_clear (svn_error_t *error)
	Free the memory used by error, as well as all ancestors and descendants of error.
void	svn_handle_error2 (svn_error_t *error, FILE *stream, svn_boolean_t fatal, const char *prefix)
	Very basic default error handler: print out error stack error to the stdio stream stream, with each error prefixed by prefix; quit and clear error iff the fatal flag is set.
void	svn_handle_error (svn_error_t *error, FILE *stream, svn_boolean_t fatal)
	Like svn_handle_error2() but with prefix set to "svn: ".
void	svn_handle_warning2 (FILE *stream, svn_error_t *error, const char *prefix)
	Very basic default warning handler: print out the error error to the stdio stream stream, prefixed by prefix.
void	svn_handle_warning (FILE *stream, svn_error_t *error)
	Like svn_handle_warning2() but with prefix set to "svn: ".
svn_error_t *	svn_error_purge_tracing (svn_error_t *err)
	Returns an error chain that is based on err's error chain but does not include any error tracing placeholders.
svn_error_t *	svn_error__malfunction (svn_boolean_t can_return, const char *file, int line, const char *expr)
	A helper function for the macros that report malfunctions.
svn_error_malfunction_handler_t	svn_error_set_malfunction_handler (svn_error_malfunction_handler_t func)
	Cause subsequent malfunctions to be handled by func.
svn_error_t *	svn_error_raise_on_malfunction (svn_boolean_t can_return, const char *file, int line, const char *expr)
	Handle a malfunction by returning an error object that describes it.
svn_error_t *	svn_error_abort_on_malfunction (svn_boolean_t can_return, const char *file, int line, const char *expr)
	Handle a malfunction by printing a message to stderr and aborting.

---

Detailed Description

Common exception handling for Subversion.

Definition in file svn_error.h.

---

Function Documentation

const char* svn_err_best_message	(	svn_error_t *	err,
		char *	buf,
		apr_size_t	bufsize
	)

If err has a custom error message, return that, otherwise store the generic error string associated with err->apr_err into buf (terminating with NULL) and return buf.

Since:

New in 1.4.

Note:

buf and bufsize are provided in the interface so that this function is thread-safe and yet does no allocation.

char* svn_strerror	(	apr_status_t	statcode,
		char *	buf,
		apr_size_t	bufsize
	)

Put an English description of statcode into buf and return buf, NULL-terminated.

statcode is either an svn error or apr error.