NAME

       db5.3_printlog - Dumps Berkeley DB log files in a human-readable format

SYNOPSIS

       db5.3_printlog [-NrV] [-b start-LSN] [-e stop-LSN] [-h home] [-P password]

DESCRIPTION

       The  db5.3_printlog  utility  is a debugging utility that dumps Berkeley DB log files in a human-readable
       format.

OPTIONS

       -b     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.

       -e     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     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 problems,  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     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 arguments.

       -r     Read the log files in reverse order.

       -V     Write the library version number to the standard output, and exit.

       The  db5.3_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  environment,
       db5.3_printlog should always be given the chance to detach from the environment and exit gracefully.   To
       cause  db5.3_printlog  to release all environment resources and exit cleanly, send it an interrupt signal
       (SIGINT).

       The db5.3_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.

AUTHORS

       Sleepycat  Software,  Inc.  This  manual page was created based on the HTML documentation for db_printlog
       from Sleepycat, by Thijs Kinkhorst <thijs@kinkhorst.com>, for the Debian  system  (but  may  be  used  by
       others).

                                                 28 January 2005                               DB5.3_PRINTLOG(1)