#include <db_cxx.h> int DbEnv::set_verbose(u_int32_t which, int onoff);
The DbEnv::set_verbose() method turns specific additional
informational and debugging messages in the Berkeley DB message output
on and off. To see the additional messages, verbose messages must
also be configured for the application. For more information on
verbose messages, see the
DbEnv::set_msgfile()
method.
The database environment's messages may also be configured using the environment's DB_CONFIG file. The syntax of the entry in that file is a single line with the string "set_verbose", one or more whitespace characters, and the method which parameter as a string and optionally one or more whitespace characters, and the string "on" or "off". If the optional string is omitted, the default is "on"; for example, "set_verbose DB_VERB_RECOVERY" or "set_verbose DB_VERB_RECOVERY on". Because the DB_CONFIG file is read when the database environment is opened, it will silently overrule configuration done before that time.
The DbEnv::set_verbose() method configures operations performed
using the specified DbEnv handle, not all
operations performed on the underlying database environment.
The DbEnv::set_verbose() method may be called at any time during the
life of the application.
The DbEnv::set_verbose()
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.
The which parameter must be set to one of the following values:
Display additional information when doing backup.
Display additional information when doing deadlock detection.
Display additional information when performing filesystem operations such as open, close or rename. May not be available on all platforms.
Display additional information when performing all filesystem operations, including read and write. May not be available on all platforms.
Display additional information when performing recovery.
Display additional information concerning support for the DB_REGISTER flag to the DbEnv::open() method.
Display all detailed information about replication. This includes the information displayed by all of the other DB_VERB_REP_* and DB_VERB_REPMGR_* values.
Display detailed information about replication elections.
Display detailed information about replication master leases.
Display detailed information about general replication processing not covered by the other DB_VERB_REP_* values.
Display detailed information about replication message processing.
Display detailed information about replication client synchronization.
Saves replication system information to a system-owned file. This value is on by default.
Display detailed information about Replication Manager connection failures.
Display detailed information about general Replication Manager processing.
Display detailed information about all Replication Manager SSL processing.
Display detailed information about Replication Manager SSL connection setup (connect and accept) and shutdown processing.
Display detailed information about Replication Manager SSL connection IO (reads and writes).
Display detailed information about sliced databases.
Display the waits-for table when doing deadlock detection.
The DbEnv::set_verbose()
method may fail and throw a DbException
exception, encapsulating one of the following non-zero errors, or return one
of the following non-zero errors: