HIST(1)                                                   HIST(1)

     NAME
          hist, history - print file names from the dump

     SYNOPSIS
          hist [ -vdu ] [ -s yyyymmdd ] files ...

     DESCRIPTION
          Hist prints the names, dates, and sizes of all versions of
          the named files, looking backwards in time, stored in the
          dump file system.  If the file exists in the main tree, the
          first line of output will be its current state.  For exam-
          ple,

               hist ~rsc/.bash_history

          produces

               May 19 16:11:37 EDT 2005 /home/am3/rsc/.bash_history 6175
               May 18 23:32:16 EDT 2005 /dump/am/2005/0519/home/am3/rsc/.bash_history 5156
               May 17 23:32:31 EDT 2005 /dump/am/2005/0518/home/am3/rsc/.bash_history 5075
               May 16 07:53:47 EDT 2005 /dump/am/2005/0517/home/am3/rsc/.bash_history 5065

          The -v option enables verbose debugging printout.

          The -d option causes diff(1) -c to be run for each adjacent
          pair of dump files, while -b runs diff -cb.

          The -u option causes times to be printed in GMT (UT) rather
          than local time.

          Finally, the -s option sets the starting (most recent) date
          for the output.

     EXAMPLES
          Examine changes in block.c:

               hist -d block.c

     FILES
          /dump  by convention, root of dump file system

     SOURCE
          /usr/local/plan9/src/cmd/hist.c

     SEE ALSO
          yesterday(1), vbackup(8)

     BUGS
          Should be called history, but that name is taken by sh(1).

     Page 1                       Plan 9            (printed 12/22/24)