db_stat(1db)

db_stat1db

Display db statistics

Usage

db_stat [-clmNt] [-C Acfhlmo] [-d file] [-h home] [-M Ahlm]

Overview

The db_stat utility displays statistics for DB environments.

The options are as follows:

-C

Display internal information about the lock region. (The output from this option is often both voluminous and meaningless, and is intended only for debugging.)

-A

Display all information.

-c

Display lock conflict matrix.

-f

Display lock and object free lists.

-l

Display lockers within hash chains.

-m

Display region memory information.

-o

Display objects within hash chains.

-c

Display lock region statistics as described in db_lock(3).

-d

Display database statistics for the specified database, as described in db_open(3).

-h

Specify a home directory for the database.

-l

Display log region statistics as described in db_log(3).

-M

Display internal information about the shared memory buffer pool. (The output from this option is often both voluminous and meaningless, and is intended only for debugging.)

-A

Display all information.

-h

Display buffers within hash chains.

-l

Display buffers within LRU chains.

-m

Display region memory information.

-m

Display shared memory buffer pool statistics as described in db_mpool(3).

-N

Don't acquire locks while displaying the statistics. This option is intended only for debugging corrupt regions and should not be used under any other circumstances.

-t

Display transaction region statistics as described in db_txn(3).

The db_stat utility attaches to DB shared memory regions. In order to avoid region corruption, it should always be given the chance to detach and exit gracefully. To cause db_stat to clean up after itself and exit, send it an interrupt signal (SIGINT).

Values smaller than 10 million are generally displayed without any special notation. Values larger than 10 million are normally displayed as ``<number>M''.

The db_stat utility exits 0 on success, and >0 if an error occurs.

Environment

The following environment variables affect the execution of db_stat:

DB_HOME

If the -h option is not specified and the environment variable DB_HOME is set, it is used as the path of the database home, as described in db_appinit(3).

Releases

3 releases since Debian 2.0 (Hamm); the text changed 2 times.

  1. 2.0
  2. 2.1
  3. 2.2

-A since Debian 2.1 (Slink); -C since Debian 2.1 (Slink); -M since Debian 2.1 (Slink); -N since Debian 2.1 (Slink); -c since Debian 2.1 (Slink); -f since Debian 2.1 (Slink); -o since Debian 2.1 (Slink).

From libdb2-util 2:2.4.14-2.7.7.1.c in Debian 2.2 (Potato). Parsed by carta from the page's man source.