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 Print verbose output.
161 Write parallelism: keep
163 writes to the server in progress at a time.
166 Status interval: every
168 seconds, print a line tracking progress of the backup.
173 finishes, it prints a single line of the form
176 mount /\fIhost\fL/\fIyyyy\fL/\fImmdd\fL/\fImtpt\fL \fIscore\fL \fIyyyy\fL/\fImmdd\fL/\fIhhmm
179 This line is a valid configuration line for
185 is currently mounted.
188 writes the named disk image to standard output.
189 Unused file system blocks are printed zeroed regardless
190 of their actual content.
194 will assume that its standard output is seekable
196 it has been redirected to a file or disk)
197 and seek over unused blocks instead of writing to them.
202 to zero unused blocks instead.
207 interface to a physical or backed-up disk image.
208 It is used mainly for debugging.
213 prompt for a list of commands.
216 mounts the NFS service at the network connection
220 On most operating systems,
222 must be run by the user
227 NFS version 3 protocol,
228 one or more disk images in a synthetic tree defined
229 by the configuration file
232 serves both NFS mount protocol
241 Disable `encrypted' handles.
242 By default handles are encrypted with a random key to avoid
243 leaking information about the backed-up file systems.
244 If encryption is disabled, the NFS handles exposed to the client
245 may leak information about the root scores of the disks as well
249 Local service only: serve only requests from the loopback interface (127.0.0.1).
252 Local service only, with paranoia: serve only requests from loopback,
253 and only from the first source port that sends a request.
254 This option is intended to be used to make sure that once the local
255 host has mounted the service, no other local users can access it.
258 Print all NFS and NFS mount RPCs to standard error.
261 Print all Venti transactions to standard error.
269 Set block size used by the in-memory venti block cache.
270 Must be as large as the maximum block size in any
271 file system mentioned in the configuration.
274 Set the number of blocks stored by the in-memory venti cache.
277 Respond to all requests with a Sun RPC rejection.
278 This is useful during debugging.
282 is a text file describing the
286 Lines beginning with a sharp
289 The rest of the file is a sequence of commands, one per line.
292 .BI mount " mtpt score time
293 Add the file system with the given
295 to the tree at the mount point
297 The path to the mount point will be created
301 is given as the score, an empty file system is mounted at
307 is the modification time to return for the directory
309 either a decimal number of seconds since the epoch
310 or a string of the form
311 .IB yyyy / mmdd / hhmm
312 giving the year, month, day, hour, and minute.
314 does not use the modification time of the root in order
315 to avoid accessing every mounted file system on common
319 .BR /dump/sys/2005 .)
321 .BI allow " ip\fR[\fL/\fImask\fR]
323 .BI deny " ip\fR[\fL/\fImask\fR]
324 These two commands define access permissions based on IP address.
327 can be a decimal number (24) or an equivalent IP mask (255.255.255.0).
328 Each request is filtered through the rules listed in the configuration file.
329 The first rule that matches is used.
334 rules are given, the default action is to reject the request.
335 In the absence of any rules, the default action is to accept all requests.
339 Running on the server
341 back up the file system stored on
347 % vbackup /dev/da0s1a
348 mount /bob/2005/0510/home ffs:0123456789abcdef\fI...\fP 2005/0510/0831
352 Serve that backup and a few others in a tree reminiscent
353 of Plan 9's dump file system, but hide each day's contents of
358 mount /bob/2005/0510 ffs:0123456789abcdef\fI...\fP 2005/0510/0829
359 mount /bob/2005/0510/home ffs:0123456789abcdef\fI...\fP 2005/0510/0831
360 mount /bob/2005/0510/tmp /dev/null 1
361 mount /bob/2005/0511 ffs:0123456789abcdef\fI...\fP 2005/0511/0827
362 mount /bob/2005/0511/home ffs:0123456789abcdef\fI...\fP 2005/0511/0828
363 mount /bob/2005/0511/tmp /dev/null 1
364 % vnfs -b 16k -c 1k config
368 Mount the backups on a client machine using
372 # vmount udp!yourserver!nfs /dump
379 (Users of fancy shells may need to quote the address argument.)