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
230 is passed to the host OS kernel rather than interpreted by
232 it must be only an IP address, not a full dial address.
236 NFS version 3 protocol,
237 one or more disk images in a synthetic tree defined
238 by the configuration file
241 serves both NFS mount protocol
250 Disable `encrypted' handles.
251 By default handles are encrypted with a random key to avoid
252 leaking information about the backed-up file systems.
253 If encryption is disabled, the NFS handles exposed to the client
254 may leak information about the root scores of the disks as well
258 Local service only: serve only requests from the loopback interface (127.0.0.1).
261 Local service only, with paranoia: serve only requests from loopback,
262 and only from the first source port that sends a request.
263 This option is intended to be used to make sure that once the local
264 host has mounted the service, no other local users can access it.
267 Print all NFS and NFS mount RPCs to standard error.
270 Print all Venti transactions to standard error.
278 Set block size used by the in-memory venti block cache.
279 Must be as large as the maximum block size in any
280 file system mentioned in the configuration.
283 Set the number of blocks stored by the in-memory venti cache.
286 Run in ``insecure'' mode, allowing remote root users to
287 use uid and gid 0 and read any file.
288 (Normally, remote root is mapped to uid and gid \-1
289 and has no special permissions.)
292 Respond to all requests with a Sun RPC rejection.
293 This is useful during debugging.
297 is a text file describing the
301 Lines beginning with a sharp
304 The rest of the file is a sequence of commands, one per line.
307 .BI mount " mtpt score time
308 Add the file system with the given
310 to the tree at the mount point
312 The path to the mount point will be created
316 is given as the score, an empty file system is mounted at
322 is the modification time to return for the directory
324 either a decimal number of seconds since the epoch
325 or a string of the form
326 .IB yyyy / mmdd / hhmm
327 giving the year, month, day, hour, and minute.
329 does not use the modification time of the root in order
330 to avoid accessing every mounted file system on common
334 .BR /dump/sys/2005 .)
336 .BI allow " ip\fR[\fL/\fImask\fR]
338 .BI deny " ip\fR[\fL/\fImask\fR]
339 These two commands define access permissions based on IP address.
342 can be a decimal number (24) or an equivalent IP mask (255.255.255.0).
343 Each request is filtered through the rules listed in the configuration file.
344 The first rule that matches is used.
349 rules are given, the default action is to reject the request.
350 In the absence of any rules, the default action is to accept all requests.
353 Reading the special file
354 .B /dump/+refreshconfig
359 The read returns either the string
364 Running on the server
366 back up the file system stored on
372 % vbackup /dev/da0s1a
373 mount /bob/2005/0510/home ffs:0123456789abcdef\fI...\fP 2005/0510/0831
377 Serve that backup and a few others in a tree reminiscent
378 of Plan 9's dump file system, but hide each day's contents of
383 mount /bob/2005/0510 ffs:0123456789abcdef\fI...\fP 2005/0510/0829
384 mount /bob/2005/0510/home ffs:0123456789abcdef\fI...\fP 2005/0510/0831
385 mount /bob/2005/0510/tmp /dev/null 1
386 mount /bob/2005/0511 ffs:0123456789abcdef\fI...\fP 2005/0511/0827
387 mount /bob/2005/0511/home ffs:0123456789abcdef\fI...\fP 2005/0511/0828
388 mount /bob/2005/0511/tmp /dev/null 1
389 % vnfs -b 16k -c 1k config
393 Mount the backups on a client machine using
397 # vmount udp!yourserver!nfs /dump
404 (Users of fancy shells may need to quote the address argument.)