huschi.net

DB_PRINTLOG(1)               BerkeleyDB Utilities               DB_PRINTLOG(1)
NAME
       db_printlog - Dumps log files into a human-readable format
SYNOPSIS
       db_printlog [-NrV] [-b start-LSN] [-e stop-LSN] [-h home] [-P password]
       [-D bytes]
DESCRIPTION
       The db_printlog utility is a debugging utility that dumps  Berkeley  DB
       log files in a human-readable format.
OPTIONS
       -b start-LSN
              Display log records starting at log sequence number (LSN) start-
              LSN; start-LSN is specified as a  file  number,  followed  by  a
              slash  (/)  character,  followed  by  an  offset number, with no
              intervening whitespace.
       -D bytes
              Specifies the maximum number of bytes to dump for each  key/data
              item found in the specified database.  This option is only valid
              when -da is also specified. This option overrides the value  set
              for the "set_data_len" parameter in your DB_CONFIG file, if any.
       -e stop-LSN
              Stop  displaying  log records at log sequence number (LSN) stop-
              LSN; stop-LSN is specified as a file number, followed by a slash
              (/) character, followed by an offset number, with no intervening
              whitespace.
       -h home
              Specify a  home  directory  for  the  database  environment;  by
              default, the current working directory is used.
       -N     Do not acquire shared region mutexes while running.  Other prob-
              lems, such as potentially fatal errors in Berkeley DB,  will  be
              ignored  as  well.   This  option is intended only for debugging
              errors, and should not be used under any other circumstances.
       -P password
              Specify an environment password.  Although Berkeley DB utilities
              overwrite  password  strings as soon as possible, be aware there
              may be a window of vulnerability on systems  where  unprivileged
              users  can see command-line arguments or where utilities are not
              able to overwrite the memory containing the  command-line  argu-
              ments.
       -r     Read the log files in reverse order.
       -V     Write  the  library  version  number to the standard output, and
              exit.
       The db_printlog utility uses a Berkeley DB  environment  (as  described
       for  the  -h  option,  the environment variable DB_HOME, or because the
       utility was run in a directory containing a Berkeley  DB  environment).
       In order to avoid environment corruption when using a Berkeley DB envi-
       ronment, db_printlog should always be given the chance to  detach  from
       the  environment  and exit gracefully.  To cause db_printlog to release
       all environment resources and exit cleanly, send it an interrupt signal
       (SIGINT).
EXIT STATUS
       The db_printlog utility exits 0 on success, and >0 if an error occurs.
ENVIRONMENT
       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_ENV->open.
NOTES
       If  the  application(s)  that  use  the  environment  make  use  of the
       DB_ENV->set_lg_dir method, then in order for this utility to  run  cor-
       rectly, you need a DB_CONFIG file which sets the proper paths using the
       set_lg_dir configuration parameter.
SEE ALSO
       db_archive(1)  db_checkpoint(1)   db_deadlock(1)   db_dump(1)   db_hot-
       backup(1)  db_log_verify(1)  db_load(1)  db_recover(1)  db_replicate(1)
       db_stat(1) db_tuner(1) db_upgrade(1) db_verify(1)
BerkeleyDB 5.3.28              06 December 2016                 DB_PRINTLOG(1)