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 objects (file systems or data slices). 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 information 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 contents

SEE ALSO

backup(1M), bkreg(1M), date(1), ls(1). 

  —  System Administration Utilities