1DB_PRINTLOG(1)               BerkeleyDB Utilities               DB_PRINTLOG(1)
2
3
4

NAME

6       db_printlog - Dumps log files into a human-readable format
7

SYNOPSIS

9       db_printlog [-NrV] [-b start-LSN] [-e stop-LSN] [-h home] [-P password]
10

DESCRIPTION

12       The  db_printlog  utility is a debugging utility that dumps Berkeley DB
13       log files in a human-readable format.
14

OPTIONS

16       -b start-LSN
17              Display log records starting at log sequence number (LSN) start-
18              LSN;  start-LSN  is  specified  as  a file number, followed by a
19              slash (/) character, followed  by  an  offset  number,  with  no
20              intervening whitespace.
21
22       -e stop-LSN
23              Stop  displaying  log records at log sequence number (LSN) stop-
24              LSN; stop-LSN is specified as a file number, followed by a slash
25              (/) character, followed by an offset number, with no intervening
26              whitespace.
27
28       -h home
29              Specify a  home  directory  for  the  database  environment;  by
30              default, the current working directory is used.
31
32       -N     Do not acquire shared region mutexes while running.  Other prob‐
33              lems, such as potentially fatal errors in Berkeley DB,  will  be
34              ignored  as  well.   This  option is intended only for debugging
35              errors, and should not be used under any other circumstances.
36
37       -P password
38              Specify an environment password.  Although Berkeley DB utilities
39              overwrite  password  strings as soon as possible, be aware there
40              may be a window of vulnerability on systems  where  unprivileged
41              users  can see command-line arguments or where utilities are not
42              able to overwrite the memory containing the  command-line  argu‐
43              ments.
44
45       -r     Read the log files in reverse order.
46
47       -V     Write  the  library  version  number to the standard output, and
48              exit.
49
50       The db_printlog utility uses a Berkeley DB  environment  (as  described
51       for  the  -h  option,  the environment variable DB_HOME, or because the
52       utility was run in a directory containing a Berkeley  DB  environment).
53       In order to avoid environment corruption when using a Berkeley DB envi‐
54       ronment, db_printlog should always be given the chance to  detach  from
55       the  environment  and exit gracefully.  To cause db_printlog to release
56       all environment resources and exit cleanly, send it an interrupt signal
57       (SIGINT).
58

EXIT STATUS

60       The db_printlog utility exits 0 on success, and >0 if an error occurs.
61

ENVIRONMENT

63       DB_HOME
64              If  the  -h option is not specified and the environment variable
65              DB_HOME is set, it is used as the path of the database home,  as
66              described in DB_ENV->open.
67

NOTES

69       If  the  application(s)  that  use  the  environment  make  use  of the
70       DB_ENV->set_lg_dir method, then in order for this utility to  run  cor‐
71       rectly, you need a DB_CONFIG file which sets the proper paths using the
72       set_lg_dir configuration parameter.
73

SEE ALSO

75       db_archive(1)  db_checkpoint(1)   db_deadlock(1)   db_dump(1)   db_hot‐
76       backup(1)  db_log_verify(1)  db_load(1)  db_recover(1)  db_replicate(1)
77       db_stat(1) db_tuner(1) db_upgrade(1) db_verify(1)
78
79
80
81BerkeleyDB 5.3.21              06 December 2016                 DB_PRINTLOG(1)
Impressum