NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

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

OPTIONS    [Toc]    [Back]

       Display  internal  information about the lock region. (The
       output from this option is often both voluminous and meaningless,
 and is intended only for debugging.)  Display all
       information.  Display lock conflict matrix.  Display  lock
       and  object  free  lists.   Display  lockers  within  hash
       chains.   Display  region  memory  information.    Display
       objects  within  hash chains.  Display lock region statistics.
   Display  database  statistics  for  the  specified
       database.   Specify a home directory for the database. The
       correct directory for enhanced security is /var/tcb/files.
       Display  log region statistics.  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.)  Display all information.
       Display  buffers  within  hash  chains.   Display  buffers
       within LRU chains.   Display  region  memory  information.
       Display  shared  memory  buffer  pool  statistics.  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.
  Display transaction region statistics.

DESCRIPTION    [Toc]    [Back]

       A  customized  version  of the Berkeley Database (Berkeley
       DB) is embedded in the operating system to  provide  highperformance
  database support for critical security files.
       The DB includes full transactional  support  and  database
       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    [Toc]    [Back]

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

ENVIRONMENT VARIABLES    [Toc]    [Back]

       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    [Toc]    [Back]

       /var/tcb/files/auth.db

       /var/tcb/files/dblogs/*

SEE ALSO    [Toc]    [Back]

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



                                                       db_stat(8)