bkhistory(1M) MISC. REFERENCE MANUAL PAGES bkhistory(1M)
NAME
bkhistory - report on completed backup operations
SYNOPSIS
bkhistory [-hl] [-f field_separator] [-d dates] [-o names]
[-t tags]
bkhistory -p period
DESCRIPTION
bkhistory without options reports a summary of the contents
of the backup history log, bkhist.tab. Backup operations
are sorted alphabetically by tag. For each tag, operations
are listed from most to least recent. backup(1M) updates
this log after each successful backup operation.
bkhistory may be executed only by a user with the superuser
privilege.
bkhistory -p assigns a rotation period (in weeks) for the
history log; all entries older than the specified number of
weeks are deleted from the log. The default rotation period
is one (1) week.
Options
-d dates
Restricts the report to backup operations performed on
the specified dates. dates are in the date format.
day, hour, minute, and year, are optional and will be
ignored. The list of dates is either comma-separated
or blank-separated and surrounded by quotes.
-f field_separator
Suppresses field wrap on the display and specifies an
output field separator to be used. The value of c is
the character that will appear as the field separator
on the display output. For clarity of output, do not
use a separator character that is likely to occur in a
field. For example, do not use the colon as a field
separator character if the display will contain dates
that use a colon to separate hours from minutes. To
use the default field separator (tab), specify the null
character ("") for c.
-h Suppresses header for the reports.
-l Displays a long form of the report. This produces an
ls -l listing of the files included in the backup
archive (if backup tables of contents are available
on-line).
-o names
Restricts the report to the specified originating
Last change: System Administration Utilities 1
bkhistory(1M) MISC. REFERENCE MANUAL PAGES bkhistory(1M)
objects (file systems or data partitions). names is a
list of onames and/or odevices. [See bkreg(1M)].
The list of names is either comma-separated or blank-
separated and surrounded by quotes.
-p period
Sets the number of weeks of information that will be
saved in the backup history table. The minimum value
of period is 1, which is also the default value. the
size of int. By default, period is 1.
-t tags
Restricts the report to backups with the specified
tags. tags is a list of tag values as specified in the
backup register. The list of tags is either comma-
separated or blank-separated and surrounded by quotes.
DIAGNOSTICS
The exit codes for the bkhistory command are the following:
0 = the task completed successfully
1 = one or more parameters to bkhistory are invalid
2 = an error has occurred, causing bkhistory to fail
to complete all portions of its task
EXAMPLES
Example 1:
bkhistory -p 3
sets the rotation period for the history log to three weeks.
Entries older than three weeks are deleted from the log.
Example 2:
bkhistory -t SpoolDai,UsrDaily,TPubsWed
displays a report of completed backup operations for the
three tags listed. Example 3:
bkhistory -l -o /usr
Displays an ls -l listing of the files that were backed up
from /usr (the originating object) if there is a table of
contents.
FILES
/etc/bkup/bkhist.tab
the backup history log that contains informa-
tion about successfully completed backup
operations
/etc/bkup/bkreg.tab
description of the backup policy established
by the administrator
/var/sadm/bkup/toc
list of directories with on-line tables of
Last change: System Administration Utilities 2
bkhistory(1M) MISC. REFERENCE MANUAL PAGES bkhistory(1M)
contents
SEE ALSO
backup(1M), bkreg(1M).
date(1), ls(1) in the User's Reference Manual.
Last change: System Administration Utilities 3