mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
d32deab17b
Suggested by G. Brandon Robinson.
83 lines
1.4 KiB
Groff
83 lines
1.4 KiB
Groff
.TH HIST 1
|
|
.SH NAME
|
|
hist, history \- print file names from the dump
|
|
.SH SYNOPSIS
|
|
.B hist
|
|
[
|
|
.B -vdu
|
|
] [
|
|
.B -s
|
|
.I yyyymmdd
|
|
]
|
|
.I files ...
|
|
.SH DESCRIPTION
|
|
.I Hist
|
|
prints the names, dates, and sizes of all versions of the named
|
|
.IR 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,
|
|
.IP
|
|
.EX
|
|
hist ~rsc/.bash_history
|
|
.EE
|
|
.PP
|
|
produces
|
|
.IP
|
|
.EX
|
|
.nf
|
|
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
|
|
.fi
|
|
.EE
|
|
.PP
|
|
The
|
|
.B -v
|
|
option enables verbose debugging printout.
|
|
.PP
|
|
The
|
|
.B -d
|
|
option causes
|
|
.MR diff (1)
|
|
.B -c
|
|
to be run for each adjacent pair of dump files, while
|
|
.B -b
|
|
runs
|
|
.IR diff
|
|
.BR -cb .
|
|
.PP
|
|
The
|
|
.B -u
|
|
option causes times to be printed in GMT (UT) rather than local time.
|
|
.PP
|
|
Finally, the
|
|
.B -s
|
|
option
|
|
sets the starting (most recent) date for the output.
|
|
.SH EXAMPLES
|
|
.PP
|
|
Examine changes in block.c:
|
|
.IP
|
|
.EX
|
|
hist -d block.c
|
|
.EE
|
|
.SH FILES
|
|
.TF /dump
|
|
.TP
|
|
.B /dump
|
|
by convention, root of dump file system
|
|
.PD
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/hist.c
|
|
.SH SEE ALSO
|
|
.MR yesterday (1) ,
|
|
.MR vbackup (8)
|
|
.SH BUGS
|
|
Should be called
|
|
.IR history ,
|
|
but
|
|
that name is taken by
|
|
.MR sh (1) .
|