DbEnv::lock_stat_print()

#include <db_cxx.h>

int
DbEnv::lock_stat_print(u_int32_t flags);

The DbEnv::lock_stat_print() method displays the locking subsystem statistical information, as described for the DbEnv::lock_stat() method. The information is printed to a specified output channel (see the DbEnv::set_msgfile() method for more information), or passed to an application callback function (see the DbEnv::set_msgcall() method for more information).

The DbEnv::lock_stat_print() method may not be called before the DbEnv::open() method is called.

The DbEnv::lock_stat_print() 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

flags

The flags parameter must be set to 0 or by bitwise inclusively OR'ing together one or more of the following values:

  • DB_STAT_ALL

    Display all available information. For each object, the amount of data displayed is limited to 100 bytes, unless some other limit is set using the DB_CONFIG "set_data_len" parameter.

  • DB_STAT_ALLOC

    Display allocation information. To display allocation information, both DB_STAT_ALLOC and DB_STAT_ALL need to be set.

  • DB_STAT_CLEAR

    Reset statistics after displaying their values.

  • DB_STAT_LOCK_CONF

    Display the lock conflict matrix.

  • DB_STAT_LOCK_LOCKERS

    Display the lockers within hash chains.

  • DB_STAT_LOCK_OBJECTS

    Display the lock objects within hash chains. For each object, the amount of data displayed is limited to 100 bytes, unless some other limit is set using the DB_CONFIG "set_data_len" parameter.

  • DB_STAT_LOCK_PARAMS

    Display the locking subsystem parameters.

Class

DbEnv, DbLock

See Also

Locking Subsystem and Related Methods