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 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 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) in the User's Reference Manual.