bkhistory(1M)   UNIX System V(System Administration Utilities)    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 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.





10/89                                                                    Page 1

bkhistory(1M)   UNIX System V(System Administration Utilities)    bkhistory(1M)


      -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





Page 2                                                                    10/89

bkhistory(1M)   UNIX System V(System Administration Utilities)    bkhistory(1M)


      /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.
















































10/89                                                                    Page 3