HISTORY(1)                                             HISTORY(1)

     NAME
          history - print file names from the dump

     SYNOPSIS
          history [ -Dabcemnw ] [ -fuv ] [ -d dumpfilesystem ] [ -s
          yyyymmdd ] files ...

     DESCRIPTION
          History prints the names, dates, and sizes, and modifier 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 example,

               history /adm/users

          produces

               May 14 15:29:18 EDT 2001 /adm/users 10083 [adm]
               May 14 15:29:18 EDT 2001 /n/dump/2001/0515/adm/users 10083 [adm]
               May 11 17:26:24 EDT 2001 /n/dump/2001/0514/adm/users 10481 [adm]
               May 10 16:40:51 EDT 2001 /n/dump/2001/0511/adm/users 10476 [adm]
                    ...

          When presented with a path of the form /n/fs/path, history
          will use fsdump as the name of the dump file system, and
          will print a history of path.

          The -v option enables verbose debugging printout.

          The -D option causes diff(1) to be run for each adjacent
          pair of dump files.  The options -abcemnw are passed through
          to diff; the little-used diff option -f is replaced by the
          functionality described below, and the -r option is disal-
          lowed.

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

          The -d option selects some other dump file system such as
          /n/bootesdump.

          The -f option forces the search to continue even when the
          file in question does not exist (useful for files that only
          exist intermittently).

          The -q option prints only the path, quoted as in rc(1).

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

     Page 1                       Plan 9            (printed 11/18/24)

     HISTORY(1)                                             HISTORY(1)

     EXAMPLES
          Check how often a user has been logged in.

               history /usr/ches/tmp

     FILES
          /n/dump

     SOURCE
          /sys/src/cmd/history.c

     SEE ALSO
          fs(4)
          yesterday(1)

     Page 2                       Plan 9            (printed 11/18/24)