bkhistory(1M) 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 privileged user.
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.
Copyright 1994 Novell, Inc. Page 1
bkhistory(1M) bkhistory(1M)
-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
Copyright 1994 Novell, Inc. Page 2
bkhistory(1M) bkhistory(1M)
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
REFERENCES
backup(1M), bkreg(1M), date(1), ls(1)
Copyright 1994 Novell, Inc. Page 3