3 vbackup, vcat, vftp, vmount, vnfs \-
4 back up Unix file systems to Venti
71 These programs back up and restore standard
72 Unix file system images stored in
78 which consist of a file system type followed
79 by a colon and forty hexadecimal digits, as in:
82 ffs:0123456789abcdef0123456789abcdef01234567
85 (The hexadecimal data is the SHA1 hash of the Venti
86 root block representing the file system image.)
88 These programs expect the environment variable
90 to be set to the network address of the Venti server to use
94 .BR tcp!yourhost!venti ).
97 copies the file system stored on
99 to the Venti server and prints the
100 score for the newly-stored image.
103 should be a disk or disk partition device
104 that would be appropriate to pass to
107 The optional argument
109 is the score of a previous backup of the disk image.
114 will not write to Venti any blocks that have not changed
115 since the previous backup.
116 This is only a speed optimization: since the blocks are already
117 stored on Venti they need not be sent to the Venti server again.
124 Turn on debugging output.
127 Trace interactions with Venti server.
131 Set names used to construct the path in the
135 is the name returned by
143 is currently mounted.
145 Set backup mount point:
146 this name is also used in the printed
149 The default is the name returned by
155 No-op mode: do not write any blocks to the server
158 Read scores incrementally from the previous backup as needed,
159 rather than prefetching them.
162 Print verbose output.
165 Write parallelism: keep
167 writes to the server in progress at a time.
170 Status interval: every
172 seconds, print a line tracking progress of the backup.
177 finishes, it prints a single line of the form
180 mount /\fIhost\fL/\fIyyyy\fL/\fImmdd\fL/\fImtpt\fL \fIscore\fL \fIyyyy\fL/\fImmdd\fL/\fIhhmm
183 This line is a valid configuration line for
189 is currently mounted.
192 writes the named disk image to standard output.
193 Unused file system blocks are printed zeroed regardless
194 of their actual content.
198 will assume that its standard output is seekable
200 it has been redirected to a file or disk)
201 and seek over unused blocks instead of writing to them.
206 to zero unused blocks instead.
211 interface to a physical or backed-up disk image.
212 It is used mainly for debugging.
217 prompt for a list of commands.
220 mounts the NFS service at the network connection
224 On most operating systems,
226 must be run by the user
231 NFS version 3 protocol,
232 one or more disk images in a synthetic tree defined
233 by the configuration file
236 serves both NFS mount protocol
245 Disable `encrypted' handles.
246 By default handles are encrypted with a random key to avoid
247 leaking information about the backed-up file systems.
248 If encryption is disabled, the NFS handles exposed to the client
249 may leak information about the root scores of the disks as well
253 Local service only: serve only requests from the loopback interface (127.0.0.1).
256 Local service only, with paranoia: serve only requests from loopback,
257 and only from the first source port that sends a request.
258 This option is intended to be used to make sure that once the local
259 host has mounted the service, no other local users can access it.
262 Print all NFS and NFS mount RPCs to standard error.
265 Print all Venti transactions to standard error.
273 Set block size used by the in-memory venti block cache.
274 Must be as large as the maximum block size in any
275 file system mentioned in the configuration.
278 Set the number of blocks stored by the in-memory venti cache.
281 Respond to all requests with a Sun RPC rejection.
282 This is useful during debugging.
286 is a text file describing the
290 Lines beginning with a sharp
293 The rest of the file is a sequence of commands, one per line.
296 .BI mount " mtpt score time
297 Add the file system with the given
299 to the tree at the mount point
301 The path to the mount point will be created
305 is given as the score, an empty file system is mounted at
311 is the modification time to return for the directory
313 either a decimal number of seconds since the epoch
314 or a string of the form
315 .IB yyyy / mmdd / hhmm
316 giving the year, month, day, hour, and minute.
318 does not use the modification time of the root in order
319 to avoid accessing every mounted file system on common
323 .BR /dump/sys/2005 .)
325 .BI allow " ip\fR[\fL/\fImask\fR]
327 .BI deny " ip\fR[\fL/\fImask\fR]
328 These two commands define access permissions based on IP address.
331 can be a decimal number (24) or an equivalent IP mask (255.255.255.0).
332 Each request is filtered through the rules listed in the configuration file.
333 The first rule that matches is used.
338 rules are given, the default action is to reject the request.
339 In the absence of any rules, the default action is to accept all requests.
343 Running on the server
345 back up the file system stored on
351 % vbackup /dev/da0s1a
352 mount /bob/2005/0510/home ffs:0123456789abcdef\fI...\fP 2005/0510/0831
356 Serve that backup and a few others in a tree reminiscent
357 of Plan 9's dump file system, but hide each day's contents of
362 mount /bob/2005/0510 ffs:0123456789abcdef\fI...\fP 2005/0510/0829
363 mount /bob/2005/0510/home ffs:0123456789abcdef\fI...\fP 2005/0510/0831
364 mount /bob/2005/0510/tmp /dev/null 1
365 mount /bob/2005/0511 ffs:0123456789abcdef\fI...\fP 2005/0511/0827
366 mount /bob/2005/0511/home ffs:0123456789abcdef\fI...\fP 2005/0511/0828
367 mount /bob/2005/0511/tmp /dev/null 1
368 % vnfs -b 16k -c 1k config
372 Mount the backups on a client machine using
376 # vmount udp!yourserver!nfs /dump
383 (Users of fancy shells may need to quote the address argument.)