![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to backup.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / adm / man1|
Return to backup.1 CVS log | Up to [Research Unix] / researchv10dc / man / adm / man1 |
1.1 root 1: .TH BACKUP 1
2: .CT 1 sa_mortals
3: .SH NAME
4: backup \- backup and recover files
5: .SH SYNOPSIS
6: .B "backup recover"
7: [
8: .I option ...
9: ]
10: .I file ...
11: .PP
12: .B "backup grep"
13: [
14: .I option ...
15: ]
16: .I pattern ...
17: .PP
18: .B "backup fetch"
19: [
20: .I option ...
21: ]
22: [
23: .I file ...
24: ]
25: .PP
26: .B "backup stats"
27: [
28: .I option ...
29: ]
30: .PP
31: .B "backup backup"
32: [
33: .I file ...
34: ]
35: .PP
36: .B "backup munge"
37: .PP
38: .B "backup mount"
39: [
40: .I option ...
41: ]
42: .I mountpt
43: .SH DESCRIPTION
44: The
45: .I backup
46: programs save and restore archival copies of files in an optical disk
47: store on a central system (see
48: .IR backup (5)).
49: Backup occurs automatically daily (see
50: .IR backup (8))
51: and upon specific request via
52: .IR "backup backup" .
53: .I "Backup grep"
54: shows backup copy names for specific files, and
55: .I "backup fetch"
56: restores data from specific backup copies.
57: .I "Backup recover"
58: is a combination of these two;
59: it fetches the most recent copy.
60: All the
61: .I backup
62: programs describe their options when presented
63: with a bad option such as
64: .BR -? .
65: .PP
66: .I "Backup recover"
67: retrieves
68: .I files
69: by name.
70: The names should be full pathnames rooted at
71: .BR /n/ ;
72: if not,
73: .I backup
74: tries to guess names that begin with
75: .BR /n/ .
76: Directories should be recovered before their contents.
77: Regular files that are linked together will stay linked if they
78: are recovered together.
79: The options for
80: .I recover
81: are:
82: .TP
83: .BI -o " dir"
84: The argument is restored as an entry in the directory
85: .IR dir .
86: .PD 0
87: .TP
88: .B -v
89: Verbose (enforced).
90: .TP
91: .B -F
92: Restore directories as files containing a null-terminated list of element names.
93: .TP
94: .B -r
95: Recursively recover any subdirectories.
96: .TP
97: .B -d
98: Create any missing intermediate directories.
99: .TP
100: .BI -D old = new
101: Replace the prefix
102: .I old
103: of the original filename with
104: .I new
105: to form the new output filename.
106: .TP
107: .B -m
108: The names are backup copy names, as determined from
109: .I backup grep,
110: not original filenames.
111: .TP
112: .BI -fdevice
113: Use
114: .I device
115: rather than
116: .B /dev/worm0
117: for the WORM.
118: .I Device
119: may be on another machine:
120: .IB machine ! device\fR.
121: An initial
122: .B w
123: implies a WORM device; a
124: .B j
125: implies a jukebox.
126: A numeric
127: .I device
128: means
129: .BI /dev/worm device\fR.
130: .TP
131: .B -e
132: Cause the
133: .I worm fetch
134: server on the backup system to terminate gracefully.
135: .TP
136: .B -i
137: Append
138: .BI . n
139: to the output name for each file where
140: .I n
141: is an increasing integer.
142: This is useful for recovering multiple copies of the same file.
143: .PD
144: .PP
145: A diagnostic like
146: .B "need disk backup2a"
147: means you need to mount the
148: A side of the cartridge labeled
149: .BR backup2 .
150: .PP
151: .I "Backup grep"
152: searches for names of backed up files that match the strings
153: .IR patterns .
154: If the pattern is a literal (no
155: .BR -e )
156: that looks like a filename,
157: it reports the filename catenated with
158: .B //
159: and the time
160: of the most recent backup copy.
161: If the pattern is a literal that looks like the output under option
162: .BR -d ,
163: it reports the name of the corresponding backup copy.
164: The options are:
165: .TP
166: .B -d
167: Print file change times
168: .RB ( ctime ,
169: see
170: .IR stat (2))
171: as integers rather than as dates.
172: .PD 0
173: .TP
174: .B -e
175: Interpret
176: .I patterns
177: as regular expressions
178: given in the notation of
179: .IR regexp (3).
180: Warning:
181: this option can execute extremely slowly;
182: it is almost always better to use
183: .IR gre (1)
184: on
185: .F /usr/backup/filenames
186: on the backup machine; see
187: .IR backup (5).
188: .TP
189: .B -a
190: Print all names in the database.
191: .TP
192: .B -V
193: Treat
194: .I pattern
195: as a literal filename
196: and list all versions of the file.
197: .TP
198: .BI -< n
199: Only list entries with a date less than or equal to
200: .IR n .
201: If
202: .I n
203: is not a simple integer date, it is interpreted as by
204: .IR timec (3).
205: .TP
206: .BI -> n
207: Only list entries with a date greater than or equal to
208: .IR n .
209: .TP
210: .B -D
211: Print the most recent entry for every file name starting with
212: .I pattern,
213: taking into account any cutoff date, but turning off option
214: .BR -e .
215: .PD
216: .PP
217: .I Backup fetch
218: takes from its arguments or from standard input
219: backup copy names as reported by
220: .I backup grep
221: (such as
222: .BR v2345/987 )
223: and restores the corresponding files.
224: It accepts the same options as
225: .I backup recover
226: except
227: .BR -m ;
228: .B -v
229: is really optional.
230: Irrelevant prefixes are stripped from backup copy names.
231: Thus the output of the
232: .I "backup grep"
233: command can be used directly.
234: .PP
235: .I "Backup stats"
236: provides statistics about the files backed up.
237: By default, it looks for all systems and all users and gives a grand total.
238: The options are
239: .nr xx \w'\f5-u \fIusers '
240: .TP \n(xxu
241: .B -i
242: Give information per system or user
243: rather than a total.
244: .TP
245: .BI -s " systems
246: .br
247: .ns
248: .TP
249: .BI -u " users
250: With option
251: .BR -i ,
252: restrict the total to the systems or users named in
253: comma-separated lists.
254: The name
255: .L *
256: expands to all systems or all users.
257: .TP
258: .B -d
259: Print average number of files and bytes for the last 1 day,
260: 7 days and 30 days.
261: .PP
262: .I "Backup backup"
263: backs up files.
264: If no file names are given,
265: they are taken from standard input.
266: File names are interpreted as in
267: .IR "backup recover" .
268: The files are safely on the backup system when the command exits but
269: will normally take a day to get into the backup database.
270: .PP
271: .I "Backup munge"
272: causes the backup system to process any received files.
273: When this terminates (assuming no errors), the files have been
274: put onto backup media and have been absorbed into the database.
275: .PP
276: .I "Backup mount"
277: is an experimental way to access backed up files.
278: The specified part of the backup files
279: (set by
280: .BI -D root
281: or
282: .B /
283: by default) is mounted at
284: .IR mountpt .
285: There is one option
286: .TP \n(xxu
287: .BI -d " date
288: Make the mounted hierarchy reflect the state at
289: the given date.
290: The mounting can be reversed with
291: .IR umount ;
292: see
293: .IR mount (8).
294: .SH EXAMPLES
295: .TP
296: .L
297: backup stats -i -s '*'
298: Get totals for all systems.
299: .TP
300: .L
301: backup fetch `backup grep -d \e`backup grep -d /n/bowell/etc/passwd\e``
302: What
303: .I backup recover
304: does for you.
305: .TP
306: .L
307: backup recover /n/coma/usr/rob/fortunes
308: .br
309: .ns
310: .TP
311: .L
312: cd /n/coma/usr/rob; backup recover fortunes
313: Two ways to get the latest available copy of
314: .BR /n/coma/usr/rob/fortunes .
315: .TP
316: .L
317: backup grep -V /n/coma/usr/rob/fortunes
318: List all available copies of
319: .B /n/coma/usr/rob/fortunes
320: with their dates.
321: .TP
322: .L
323: backup recover -m -o /tmp /n/wild/usr/backup/v/v919/678
324: .br
325: .ns
326: .TP
327: .L
328: backup recover -m -o /tmp v919/678
329: Two ways to recover a specific backup copy and place the result in
330: .BR /tmp .
331: .B /n/wild/usr/backup/v/v919/678
332: is the name of the backup copy; the file will be restored to
333: its home machine, not to
334: .BR wild .
335: .TP
336: .L
337: backup grep -V /n/coma/usr/rob/fortunes | backup fetch -i -o .
338: Recover all the versions of the fortunes file into
339: .BR fortunes.1 ,
340: .BR fortunes.2 ,
341: \&... in the current directory.
342: .PD
343: .SH FILES
344: .F /usr/lib/backup
345: \h'.5i'home of all datafiles and executables (on client machines)
346: .SH "SEE ALSO"
347: .IR worm (8),
348: .IR backup (5),
349: .IR backup (8)
350: .SH BUGS
351: Recovery via symbolic links may not work; use the non-linked pathname.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.