]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/yesterday
merge
[plan9front.git] / sys / man / 1 / yesterday
1 .TH YESTERDAY 1
2 .SH NAME
3 yesterday, diffy \- print file names from the dump
4 .SH SYNOPSIS
5 .B yesterday
6 [
7 .B -abcCdDs
8 ] [
9 .B -n
10 .I daysago
11 ] [
12 .I \-date
13 ]
14 .I files ...
15 .PP
16 .B diffy
17 [
18 .B -abcefmnrw
19 ]
20 .I files ...
21 .SH DESCRIPTION
22 .I Yesterday
23 prints the names of the
24 .I files
25 from the most recent dump.
26 Since dumps are done early in the morning,
27 yesterday's files are really in today's dump.
28 For example, if today is March 17, 1992,
29 .IP
30 .EX
31 yesterday /adm/users
32 .EE
33 .PP
34 prints
35 .IP
36 .EX
37 /n/dump/1992/0317/adm/users
38 .EE
39 .PP
40 In fact, the implementation is to select the most recent dump in
41 the current year, so the dump selected may not be from today.
42 .PP
43 When presented with a path of the form
44 .BI /n/ fs / path \fR,
45 .I yesterday
46 will look for
47 dump files of the form
48 \fL/n/\fIfs\fLdump/\fIyyyy\fL/\fIhhmm\fL/\fIpath\fR.
49 .PP
50 By default, 
51 .I yesterday
52 prints the names of the dump files corresponding to the named files.
53 The first set of options changes this behavior.
54 .TP
55 .B -a
56 Run
57 .IR acme (1)'s
58 .I adiff
59 to compare the dump files with the named files.
60 .TP
61 .B -b
62 Bind the dump files over the named files.
63 .TP
64 .B -c
65 Copy the dump files over the named files.
66 .TP
67 .B -C
68 Copy the dump files over the named files only when
69 they differ.
70 .TP
71 .B -d
72 Run 
73 .B diff
74 to compare the dump files with the named files.
75 .TP
76 .B -D
77 Run 
78 .B diff
79 .B -n
80 to compare the dump files with the named files.
81 .PP
82 The
83 .I date
84 option selects other day's dumps, with a format of
85 1, 2, 4, 6, or 8 digits of the form
86 .IR d,
87 .IR dd ,
88 .IR mmdd ,
89 .IR yymmdd ,
90 or
91 .IR yyyymmdd .
92 .PP
93 The
94 .B -n
95 option selects the dump
96 .I daysago
97 prior to the current day.
98 .PP
99 The
100 .B -s
101 option selects the most recent snapshot instead of the most
102 recent archived dump.  Snapshots may occur more frequently
103 than dumps.
104 .PP
105 .I Yesterday
106 does not guarantee that the string it prints represents an existing file.
107 .PP
108 .I Diffy
109 runs
110 .IR diff (1)
111 with the given options
112 to compare yesterday's version of each of the named files
113 with today's.
114 .SH EXAMPLES
115 .PP
116 Back up to yesterday's MIPS binary of
117 .BR vc :
118 .IP
119 .EX
120 yesterday -c /mips/bin/vc
121 .EE
122 .PP
123 Temporarily back up to March 1's MIPS C library to see if a program
124 runs correctly when loaded with it:
125 .IP
126 .EX
127 yesterday -b -0301 /mips/lib/libc.a
128 rm v.out
129 mk
130 v.out
131 .EE
132 .PP
133 Find what has changed in the C library since March 1:
134 .IP
135 .EX
136 yesterday -d -0301 /sys/src/libc/port/*.c
137 .EE
138 .PP
139 Find what has changed in the source tree today:
140 .IP
141 .EX
142 diffy -r /sys/src
143 .EE
144 .SH FILES
145 .B /n/dump
146 .SH SOURCE
147 .B /rc/bin/yesterday
148 .br
149 .B /rc/bin/diffy
150 .SH SEE ALSO
151 .IR history (1),
152 .IR bind (1),
153 .IR diff (1),
154 .IR fs (4).
155 .SH BUGS
156 It's hard to use this command without singing.