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 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)].



   7/91                                                                 Page 1

   bkhistory(1M)                                                 bkhistory(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




   Page 2                                                                 7/91

   bkhistory(1M)                                                 bkhistory(1M)


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











































   7/91                                                                 Page 3