int
DBENV->set_paniccall(DB_ENV *dbenv,
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 write log records to disk because there is insufficient disk space.)
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 attempting to gracefully return up the stack.
The DBENV->set_paniccall function is used to specify a function to be called when
DB_RUNRECOVERY is about to be returned from a Berkeley DB method. 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.
The DBENV->set_paniccall interface may be used to configure Berkeley DB at any time
during the life of the application.
The DBENV->set_paniccall function returns a non-zero error value on failure and 0 on success.