Viewing file:  env_set_verbose.html (5.24 KB) -rw-r--r--
Select action/file-type:
 (+) | (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
Berkeley DB: DbEnv::set_verbose
DbEnv::set_verbose
|
 |
#include <db_cxx.h>
int
DbEnv::set_verbose(u_int32_t which, int onoff);
int
DbEnv::get_verbose(u_int32_t which, int *onoffp);
Description: DbEnv::set_verbose
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
Db::set_errfile method.
The database environment's messages may also be set 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; for example,
"set_verbose DB_VERB_RECOVERY".
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.
Parameters
- onoff
- If the onoff parameter is set to non-zero, the additional
messages are output.
- which
- The which parameter must be set to one of the following values:
- DB_VERB_DEADLOCK
- Display additional information when doing deadlock detection.
- DB_VERB_RECOVERY
- Display additional information when performing recovery.
- DB_VERB_REPLICATION
- Display additional information when processing replication messages.
Note, to get complete replication logging when debugging replication
applications, you must also configure and build the Berkeley DB library with
the --enable-diagnostic
configuration option as well as call the DbEnv::set_verbose method.
- DB_VERB_WAITSFOR
- Display the waits-for table when doing deadlock detection.
Errors
The DbEnv::set_verbose method
may fail and throw
DbException,
encapsulating one of the following non-zero errors, or return one of
the following non-zero errors:
- EINVAL
- An
invalid flag value or parameter was specified.
Description: dbenv_get_verbose
The DbEnv::get_verbose method returns whether the specified which
parameter is currently set or not.
The DbEnv::get_verbose method may be called at any time during the life of the
application.
The DbEnv::get_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.
Parameters
- which
- The which parameter is the message value for which configuration
is being checked.
- onoffp
- The onoffp parameter references memory into which
the configuration of the specified which parameter is copied.
Class
DbEnv
See Also
Database Environments and Related Methods
Copyright (c) 1996-2004 Sleepycat Software, Inc. - All rights reserved.
|