#include <db_cxx.h>

void DbEnv::set_errcall(
    void (*db_errcall_fcn)(const char *errpfx, char *msg));

Description: DbEnv::set_errcall

The DbEnv::set_errcall and Db::set_errcall methods are used to enhance the mechanism for reporting error messages to the application. In some cases, when an error occurs, Berkeley DB will call db_errcall_fcn with additional error information. It is up to the db_errcall_fcn function to display the error message in an appropriate manner.

Alternatively, you can use the DbEnv::set_error_stream and Db::set_error_stream methods to display the additional information via an output stream, or the Db::set_errfile or DbEnv::set_errfile methods to display the additional information via a C library FILE *. You should not mix these approaches.

This error-logging enhancement does not slow performance or significantly increase application size, and may be run during normal operation as well as during application debugging.

The DbEnv::set_errcall method may be called at any time during the life of the application.

Parameters

db_errcall_fcn

The db_errcall_fcn parameter is the application-specified error reporting function. The function takes two parameters:

errpfx

The errpfx parameter is the prefix string (as previously set by Db::set_errpfx or DbEnv::set_errpfx).

msg

The msg parameter is the error message string.

Class

See Also