DbEnv::set_paniccall

APIRef

#include <db_cxx.h>

int DbEnv::set_paniccall(void (*)(DbEnv *, int));

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, when the C++ error model has been configured so that the individual Berkeley DB methods return error codes (see DbException for more information), the value DB_RUNRECOVERY is returned by Berkeley DB methods.

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 DbEnv::set_paniccall and Db::set_paniccall methods are used to specify methods 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 method.

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 method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.

Class

DbEnv

See Also

DbEnv::close, DbEnv::err, DbEnv::errx DbEnv::open, DbEnv::remove, DbEnv::set_alloc, DbEnv::set_cachesize, DbEnv::set_data_dir, DbEnv::set_errcall, DbEnv::set_errfile, DbEnv::set_error_stream, DbEnv::set_errpfx, DbEnv::set_feedback, DbEnv::set_flags, DbEnv::set_mutexlocks, DbEnv::set_pageyield, DbEnv::set_paniccall, DbEnv::set_panicstate, DbEnv::set_recovery_init, DbEnv::set_rpc_server, DbEnv::set_region_init, DbEnv::set_shm_key, DbEnv::set_tas_spins, DbEnv::set_tmp_dir, DbEnv::set_verbose, DbEnv::strerror and DbEnv::version.

APIRef

Copyright Sleepycat Software