1 35ed6913 2005-07-13 devnull .TH VBACKUP 8
3 35ed6913 2005-07-13 devnull vbackup, vcat, vftp, vmount, vmount0, vnfs \-
4 35ed6913 2005-07-13 devnull back up Unix file systems to Venti
5 35ed6913 2005-07-13 devnull .SH SYNOPSIS
6 35ed6913 2005-07-13 devnull .B vbackup
38 35ed6913 2005-07-13 devnull .B vmount
45 35ed6913 2005-07-13 devnull .B vmount0
51 35ed6913 2005-07-13 devnull .I handle
58 35ed6913 2005-07-13 devnull .B -LLMRVr
66 35ed6913 2005-07-13 devnull .I mntaddr
70 35ed6913 2005-07-13 devnull .I blocksize
74 35ed6913 2005-07-13 devnull .I cachesize
76 35ed6913 2005-07-13 devnull .I config
77 35ed6913 2005-07-13 devnull .SH DESCRIPTION
78 35ed6913 2005-07-13 devnull These programs back up and restore standard
79 35ed6913 2005-07-13 devnull Unix file system images stored in
80 35ed6913 2005-07-13 devnull .IR venti (8).
81 35ed6913 2005-07-13 devnull Images stored in
83 35ed6913 2005-07-13 devnull are named by
84 35ed6913 2005-07-13 devnull .IR scores ,
85 35ed6913 2005-07-13 devnull which consist of a file system type followed
86 35ed6913 2005-07-13 devnull by a colon and forty hexadecimal digits, as in:
89 35ed6913 2005-07-13 devnull ffs:0123456789abcdef0123456789abcdef01234567
92 35ed6913 2005-07-13 devnull (The hexadecimal data is the SHA1 hash of the Venti
93 35ed6913 2005-07-13 devnull root block representing the file system image.)
95 35ed6913 2005-07-13 devnull These programs expect the environment variable
96 35ed6913 2005-07-13 devnull .B $venti
97 35ed6913 2005-07-13 devnull to be set to the network address of the Venti server to use
98 35ed6913 2005-07-13 devnull (for example,
99 35ed6913 2005-07-13 devnull .B yourhost
101 35ed6913 2005-07-13 devnull .BR tcp!yourhost!venti ).
103 35ed6913 2005-07-13 devnull .I Vbackup
104 35ed6913 2005-07-13 devnull copies the file system stored on
106 35ed6913 2005-07-13 devnull to the Venti server and prints the
107 35ed6913 2005-07-13 devnull score for the newly-stored image.
108 35ed6913 2005-07-13 devnull The argument
110 35ed6913 2005-07-13 devnull should be a disk or disk partition device
111 35ed6913 2005-07-13 devnull that would be appropriate to pass to
112 35ed6913 2005-07-13 devnull .IR mount (8).
114 35ed6913 2005-07-13 devnull The optional argument
115 35ed6913 2005-07-13 devnull .I score
116 35ed6913 2005-07-13 devnull is the score of a previous backup of the disk image.
118 35ed6913 2005-07-13 devnull .I score
119 35ed6913 2005-07-13 devnull is given,
120 35ed6913 2005-07-13 devnull .I vbackup
121 35ed6913 2005-07-13 devnull will not write to Venti any blocks that have not changed
122 35ed6913 2005-07-13 devnull since the previous backup.
123 35ed6913 2005-07-13 devnull This is only a speed optimization: since the blocks are already
124 35ed6913 2005-07-13 devnull stored on Venti they need not be sent to the Venti server again.
126 35ed6913 2005-07-13 devnull The options to
127 35ed6913 2005-07-13 devnull .I vbackup
138 35ed6913 2005-07-13 devnull .B -w \fIn
140 35ed6913 2005-07-13 devnull .B -s \fIsecs
143 35ed6913 2005-07-13 devnull writes the named disk image to standard output.
144 35ed6913 2005-07-13 devnull Unused file system blocks are printed zeroed regardless
145 35ed6913 2005-07-13 devnull of their actual content.
149 35ed6913 2005-07-13 devnull flag is given,
151 35ed6913 2005-07-13 devnull will attempt to seek over unused blocks instead of writing to them.
154 35ed6913 2005-07-13 devnull flag should only be used when standard output is seekable
155 35ed6913 2005-07-13 devnull .RI ( i.e. ,
156 35ed6913 2005-07-13 devnull when it has been redirected to a file or disk).
159 35ed6913 2005-07-13 devnull presents the
160 35ed6913 2005-07-13 devnull file system image named by
163 35ed6913 2005-07-13 devnull .I score
164 35ed6913 2005-07-13 devnull in a shell-like
165 35ed6913 2005-07-13 devnull interactive session.
169 35ed6913 2005-07-13 devnull .B vftp>
170 35ed6913 2005-07-13 devnull prompt for details.
172 35ed6913 2005-07-13 devnull .I Vmount
173 35ed6913 2005-07-13 devnull mounts the NFS service at the network connection
174 35ed6913 2005-07-13 devnull .I address
176 35ed6913 2005-07-13 devnull .IR mountpoint .
177 35ed6913 2005-07-13 devnull On most operating systems,
178 35ed6913 2005-07-13 devnull .I vmount
179 35ed6913 2005-07-13 devnull must be run by the user
180 35ed6913 2005-07-13 devnull .BR root .
182 35ed6913 2005-07-13 devnull .I Vmount0
183 35ed6913 2005-07-13 devnull is a simple C program that
184 35ed6913 2005-07-13 devnull .I vmount
186 35ed6913 2005-07-13 devnull .IR mount (8)
187 35ed6913 2005-07-13 devnull does not suffice.
190 35ed6913 2005-07-13 devnull serves, using the
191 35ed6913 2005-07-13 devnull NFS version 3 protocol,
192 35ed6913 2005-07-13 devnull one or more disk images in a synthetic tree defined
193 35ed6913 2005-07-13 devnull by the configuration file
194 35ed6913 2005-07-13 devnull .IR config .
196 35ed6913 2005-07-13 devnull announces NFS service at
197 35ed6913 2005-07-13 devnull .IR addr
198 35ed6913 2005-07-13 devnull (default
199 35ed6913 2005-07-13 devnull .BR udp!*!nfs )
200 35ed6913 2005-07-13 devnull and NFS mount service at
201 35ed6913 2005-07-13 devnull .IR mntaddr
202 35ed6913 2005-07-13 devnull (default
203 35ed6913 2005-07-13 devnull .BR udp!*!\fI999 ),
204 35ed6913 2005-07-13 devnull registering both with the port mapper.
205 35ed6913 2005-07-13 devnull If no port mapper is found running (on port 111),
207 35ed6913 2005-07-13 devnull starts its own port mapper.
208 35ed6913 2005-07-13 devnull The options are:
211 35ed6913 2005-07-13 devnull Reply to all NFS requests with RPC rejections.
214 35ed6913 2005-07-13 devnull Do not announce an NFS mount service.
217 35ed6913 2005-07-13 devnull Do not register service with the port mapper.
222 35ed6913 2005-07-13 devnull .SH EXAMPLES
224 35ed6913 2005-07-13 devnull Back up the file system stored on
225 35ed6913 2005-07-13 devnull .BR /dev/da0s1a :
228 35ed6913 2005-07-13 devnull % vbackup /dev/da0s1a
229 35ed6913 2005-07-13 devnull ffs:0123456789abcdef0123456789abcdef01234567
233 35ed6913 2005-07-13 devnull Serve that backup and a few others in a tree reminiscent
234 35ed6913 2005-07-13 devnull of Plan 9's dump file system, but hide each day's contents of
235 35ed6913 2005-07-13 devnull .B /tmp :
238 35ed6913 2005-07-13 devnull % cat config
239 35ed6913 2005-07-13 devnull mount /2005/0510 ffs:0123456789abcdef\fI...\fP
240 35ed6913 2005-07-13 devnull mount /2005/0510/home ffs:0123456789abcdef\fI...\fP
241 35ed6913 2005-07-13 devnull mount /2005/0510 ffs:0123456789abcdef\fI...\fP
242 35ed6913 2005-07-13 devnull mount /2005/0510/home ffs:0123456789abcdef\fI...\fP
243 35ed6913 2005-07-13 devnull hide /*/*/tmp
244 35ed6913 2005-07-13 devnull % vnfs -m -b 16k -c 1k config
248 35ed6913 2005-07-13 devnull Mount the backups on a client machine using
249 35ed6913 2005-07-13 devnull .IR vmount :
252 35ed6913 2005-07-13 devnull # vmount udp!yourserver!nfs /dump
253 35ed6913 2005-07-13 devnull # ls /dump
258 35ed6913 2005-07-13 devnull Mount the backups using the standard NFS mount program:
261 35ed6913 2005-07-13 devnull # mount -t nfs -o soft,intr,ro,nfsv3,rsize=8192,timeo=100 \
262 35ed6913 2005-07-13 devnull -o nfsvers=3,nolock,noatime,nodev,nosuid \