Berkeley DB: DbEnv::set_verbose
Description: Berkeley DB: An embedded database programmatic toolkit.
Keywords: embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++

### 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_CHKPOINT". 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_CHKPOINT
    Display checkpoint location information when searching the log for checkpoints.

  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-2003 Sleepycat Software, Inc. - All rights reserved.