hist.1 (1419B)
1 .TH HIST 1 2 .SH NAME 3 hist, history \- print file names from the dump 4 .SH SYNOPSIS 5 .B hist 6 [ 7 .B -vdu 8 ] [ 9 .B -s 10 .I yyyymmdd 11 ] 12 .I files ... 13 .SH DESCRIPTION 14 .I Hist 15 prints the names, dates, and sizes of all versions of the named 16 .IR files , 17 looking backwards in time, 18 stored in the dump file system. 19 If the file exists in the main tree, the first line of output will be its current state. 20 For example, 21 .IP 22 .EX 23 hist ~rsc/.bash_history 24 .EE 25 .PP 26 produces 27 .IP 28 .EX 29 .nf 30 May 19 16:11:37 EDT 2005 /home/am3/rsc/.bash_history 6175 31 May 18 23:32:16 EDT 2005 /dump/am/2005/0519/home/am3/rsc/.bash_history 5156 32 May 17 23:32:31 EDT 2005 /dump/am/2005/0518/home/am3/rsc/.bash_history 5075 33 May 16 07:53:47 EDT 2005 /dump/am/2005/0517/home/am3/rsc/.bash_history 5065 34 .fi 35 .EE 36 .PP 37 The 38 .B -v 39 option enables verbose debugging printout. 40 .PP 41 The 42 .B -d 43 option causes 44 .MR diff (1) 45 .B -c 46 to be run for each adjacent pair of dump files, while 47 .B -b 48 runs 49 .IR diff 50 .BR -cb . 51 .PP 52 The 53 .B -u 54 option causes times to be printed in GMT (UT) rather than local time. 55 .PP 56 Finally, the 57 .B -s 58 option 59 sets the starting (most recent) date for the output. 60 .SH EXAMPLES 61 .PP 62 Examine changes in block.c: 63 .IP 64 .EX 65 hist -d block.c 66 .EE 67 .SH FILES 68 .TF /dump 69 .TP 70 .B /dump 71 by convention, root of dump file system 72 .PD 73 .SH SOURCE 74 .B \*9/src/cmd/hist.c 75 .SH SEE ALSO 76 .MR yesterday (1) , 77 .MR vbackup (8) 78 .SH BUGS 79 Should be called 80 .IR history , 81 but 82 that name is taken by 83 .MR sh (1) .