unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



db_stat(8)							   db_stat(8)



NAME

  db_stat - Displays statistics	for the	database files (Enhanced Security)

SYNOPSIS

  /usr/tcb/bin/db_stat [-clmNt]	[-C Acfhlmo] [-d file]
	  [-h home] [-M	Ahlm]

FLAGS

  -C Acfhlmo
      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.

  -d  Display database statistics for the specified database.

  -h home
      Specify a	home directory for the database.  The correct directory	for
      enhanced security	is /var/tcb/files.

  -l  Display log region statistics.

  -M Ahlm
      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.

  -N  Do not acquire shared region locks while accumulating 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.

DESCRIPTION

  A customized version of the Berkeley Database	(Berkeley DB) is embedded in
  the operating	system to provide high-performance database support for	crit-
  ical security	files.	The DB includes	full transactional support and data-
  base recovery, using write-ahead logging and checkpointing to	record
  changes.

  The db_stat utility provides database	statistics for these security files.
  Customization	for Tru64 UNIX makes some of this information, particularly
  lock-related information, meaningless.

  Values smaller than 10 million are generally displayed without any special
  notation.  Values larger than	10 million are normally	displayed as M.

  The db_stat utility utility attaches to one or more of the Berkeley 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).

RETURN VALUES

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

ENVIRONMENT VARIABLES

  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.	The
	  home directory for security is /var/tcb/files.

FILES

  /var/tcb/files/auth.db

  /var/tcb/files/dblogs/*

RELATED	INFORMATION

  Commands: db_archive(8), db_checkpoint(8), db_printlog(8), db_dump(8),
  db_load(8), db_recover(8)