#include <db.h>

int
DB->set_paniccall(DB *db,
    void (*paniccall)(DB_ENV *, int errval));

Description

Errors can occur in the Berkeley DB library where the only solution is to shut down the application and run recovery (for example, if Berkeley DB is unable to allocate heap memory). In these cases, the value DB_RUNRECOVERY is returned by Berkeley DB.

In these cases, it is also often simpler to shut down the application when such errors occur rather than to try to gracefully return up the stack. The DB_ENV->set_paniccall and DB->set_paniccall methods are used to specify functions to be called when DB_RUNRECOVERY is about to be returned from a Berkeley DB interface. When called, the dbenv argument will be a reference to the current environment, and the errval argument is the error value that would have been returned to the calling function.

For DB handles opened inside of Berkeley DB environments, calling the DB->set_paniccall method affects the entire environment and is equivalent to calling the DB_ENV->set_paniccall method.

The DB->set_paniccall interface may be called at any time during the life of the application.

The DB->set_paniccall method returns a non-zero error value on failure and 0 on success.

Class

See Also