bkhistory(1M) SYSTEM ADMINISTRATION COMMANDS 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 only be executed by a user with 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
1
bkhistory(1M) SYSTEM ADMINISTRATION COMMANDS bkhistory(1M)
objects (file systems or data partitions). names is a
list of items in the following form:
oname|odevice Items in this list are either
blank-separated and enclosed in quotes or comma-
separated.
-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; the maximum value is 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 3 weeks are deleted from the log. Exam-
ple 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 oname /usr (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
/toc list of directories with on-line tables of
contents
2
bkhistory(1M) SYSTEM ADMINISTRATION COMMANDS bkhistory(1M)
SEE ALSO
backup(1M), bkreg(1M), date(1), ls(1)
3