1 35ed6913 2005-07-13 devnull .TH VBACKUP 8
  2 35ed6913 2005-07-13 devnull .SH NAME
  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
  7 35ed6913 2005-07-13 devnull [
  8 35ed6913 2005-07-13 devnull .B -DVnv
  9 35ed6913 2005-07-13 devnull ]
 10 35ed6913 2005-07-13 devnull [
 11 35ed6913 2005-07-13 devnull .B -s
 12 35ed6913 2005-07-13 devnull .I secs
 13 35ed6913 2005-07-13 devnull ]
 14 35ed6913 2005-07-13 devnull [
 15 35ed6913 2005-07-13 devnull .B -w
 16 35ed6913 2005-07-13 devnull .I n
 17 35ed6913 2005-07-13 devnull ]
 18 35ed6913 2005-07-13 devnull .I disk
 19 35ed6913 2005-07-13 devnull [
 20 35ed6913 2005-07-13 devnull .I score
 21 35ed6913 2005-07-13 devnull ]
 22 35ed6913 2005-07-13 devnull .PP
 23 35ed6913 2005-07-13 devnull .B vcat
 24 35ed6913 2005-07-13 devnull [
 25 35ed6913 2005-07-13 devnull .B -z
 26 35ed6913 2005-07-13 devnull ]
 27 35ed6913 2005-07-13 devnull .I disk
 28 35ed6913 2005-07-13 devnull |
 29 35ed6913 2005-07-13 devnull .I score
 30 35ed6913 2005-07-13 devnull .B >
 31 35ed6913 2005-07-13 devnull .I disk
 32 35ed6913 2005-07-13 devnull .PP
 33 35ed6913 2005-07-13 devnull .B vftp
 34 35ed6913 2005-07-13 devnull .I disk
 35 35ed6913 2005-07-13 devnull |
 36 35ed6913 2005-07-13 devnull .I score
 37 35ed6913 2005-07-13 devnull .PP
 38 35ed6913 2005-07-13 devnull .B vmount
 39 35ed6913 2005-07-13 devnull [
 40 35ed6913 2005-07-13 devnull .B -v
 41 35ed6913 2005-07-13 devnull ]
 42 35ed6913 2005-07-13 devnull .I addr
 43 35ed6913 2005-07-13 devnull .I mtpt
 44 35ed6913 2005-07-13 devnull .PP
 45 35ed6913 2005-07-13 devnull .B vmount0
 46 35ed6913 2005-07-13 devnull [
 47 35ed6913 2005-07-13 devnull .B -v
 48 35ed6913 2005-07-13 devnull ]
 49 35ed6913 2005-07-13 devnull [
 50 35ed6913 2005-07-13 devnull .B -h
 51 35ed6913 2005-07-13 devnull .I handle
 52 35ed6913 2005-07-13 devnull ]
 53 35ed6913 2005-07-13 devnull .I addr
 54 35ed6913 2005-07-13 devnull .I mtpt
 55 35ed6913 2005-07-13 devnull .PP
 56 35ed6913 2005-07-13 devnull .B vnfs
 57 35ed6913 2005-07-13 devnull [
 58 35ed6913 2005-07-13 devnull .B -LLMRVr
 59 35ed6913 2005-07-13 devnull ]
 60 35ed6913 2005-07-13 devnull [
 61 35ed6913 2005-07-13 devnull .B -a
 62 35ed6913 2005-07-13 devnull .I addr
 63 35ed6913 2005-07-13 devnull ]
 64 35ed6913 2005-07-13 devnull [
 65 35ed6913 2005-07-13 devnull .B -m
 66 35ed6913 2005-07-13 devnull .I mntaddr
 67 35ed6913 2005-07-13 devnull ]
 68 35ed6913 2005-07-13 devnull [
 69 35ed6913 2005-07-13 devnull .B -b
 70 35ed6913 2005-07-13 devnull .I blocksize
 71 35ed6913 2005-07-13 devnull ]
 72 35ed6913 2005-07-13 devnull [
 73 35ed6913 2005-07-13 devnull .B -c
 74 35ed6913 2005-07-13 devnull .I cachesize
 75 35ed6913 2005-07-13 devnull ]
 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
 82 35ed6913 2005-07-13 devnull .I venti
 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:
 87 35ed6913 2005-07-13 devnull .IP
 88 35ed6913 2005-07-13 devnull .EX
 89 35ed6913 2005-07-13 devnull ffs:0123456789abcdef0123456789abcdef01234567
 90 35ed6913 2005-07-13 devnull .EE
 91 35ed6913 2005-07-13 devnull .PP
 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.)
 94 35ed6913 2005-07-13 devnull .PP
 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
100 35ed6913 2005-07-13 devnull or
101 35ed6913 2005-07-13 devnull .BR tcp!yourhost!venti ).
102 35ed6913 2005-07-13 devnull .PP
103 35ed6913 2005-07-13 devnull .I Vbackup
104 35ed6913 2005-07-13 devnull copies the file system stored on
105 35ed6913 2005-07-13 devnull .I disk
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
109 35ed6913 2005-07-13 devnull .I disk
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).
113 35ed6913 2005-07-13 devnull .PP
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.
117 35ed6913 2005-07-13 devnull If
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.
125 35ed6913 2005-07-13 devnull .PP
126 35ed6913 2005-07-13 devnull The options to
127 35ed6913 2005-07-13 devnull .I vbackup
128 35ed6913 2005-07-13 devnull are:
129 35ed6913 2005-07-13 devnull .TP
130 35ed6913 2005-07-13 devnull .B -D
131 35ed6913 2005-07-13 devnull .TP
132 35ed6913 2005-07-13 devnull .B -V
133 35ed6913 2005-07-13 devnull .TP
134 35ed6913 2005-07-13 devnull .B -n
135 35ed6913 2005-07-13 devnull .TP
136 35ed6913 2005-07-13 devnull .B -v
137 35ed6913 2005-07-13 devnull .TP
138 35ed6913 2005-07-13 devnull .B -w \fIn
139 35ed6913 2005-07-13 devnull .TP
140 35ed6913 2005-07-13 devnull .B -s \fIsecs
141 35ed6913 2005-07-13 devnull .PP
142 35ed6913 2005-07-13 devnull .I Vcat
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.
146 35ed6913 2005-07-13 devnull .PP
147 35ed6913 2005-07-13 devnull If the
148 35ed6913 2005-07-13 devnull .B -z
149 35ed6913 2005-07-13 devnull flag is given, 
150 35ed6913 2005-07-13 devnull .I vcat
151 35ed6913 2005-07-13 devnull will attempt to seek over unused blocks instead of writing to them.
152 35ed6913 2005-07-13 devnull The
153 35ed6913 2005-07-13 devnull .B -z
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).
157 35ed6913 2005-07-13 devnull .PP
158 35ed6913 2005-07-13 devnull .I Vftp
159 35ed6913 2005-07-13 devnull presents the
160 35ed6913 2005-07-13 devnull file system image named by
161 35ed6913 2005-07-13 devnull .I disk
162 35ed6913 2005-07-13 devnull or
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.
166 35ed6913 2005-07-13 devnull Type
167 35ed6913 2005-07-13 devnull .B help
168 35ed6913 2005-07-13 devnull at the
169 35ed6913 2005-07-13 devnull .B vftp>
170 35ed6913 2005-07-13 devnull prompt for details.
171 35ed6913 2005-07-13 devnull .PP
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
175 35ed6913 2005-07-13 devnull onto
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 .
181 35ed6913 2005-07-13 devnull .PP
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
185 35ed6913 2005-07-13 devnull uses if 
186 35ed6913 2005-07-13 devnull .IR mount (8)
187 35ed6913 2005-07-13 devnull does not suffice.
188 35ed6913 2005-07-13 devnull .PP
189 35ed6913 2005-07-13 devnull .I Vnfs
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 .
195 35ed6913 2005-07-13 devnull .I Vnfs
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),
206 35ed6913 2005-07-13 devnull .I vnfs
207 35ed6913 2005-07-13 devnull starts its own port mapper.
208 35ed6913 2005-07-13 devnull The options are:
209 35ed6913 2005-07-13 devnull .TP
210 35ed6913 2005-07-13 devnull .B -r
211 35ed6913 2005-07-13 devnull Reply to all NFS requests with RPC rejections.
212 35ed6913 2005-07-13 devnull .TP
213 35ed6913 2005-07-13 devnull .B -M
214 35ed6913 2005-07-13 devnull Do not announce an NFS mount service.
215 35ed6913 2005-07-13 devnull .TP
216 35ed6913 2005-07-13 devnull .B -P
217 35ed6913 2005-07-13 devnull Do not register service with the port mapper.
218 35ed6913 2005-07-13 devnull .TP
219 35ed6913 2005-07-13 devnull .B -a
220 35ed6913 2005-07-13 devnull 
221 35ed6913 2005-07-13 devnull 
222 35ed6913 2005-07-13 devnull .SH EXAMPLES
223 35ed6913 2005-07-13 devnull .PP
224 35ed6913 2005-07-13 devnull Back up the file system stored on
225 35ed6913 2005-07-13 devnull .BR /dev/da0s1a :
226 35ed6913 2005-07-13 devnull .IP
227 35ed6913 2005-07-13 devnull .EX
228 35ed6913 2005-07-13 devnull % vbackup /dev/da0s1a
229 35ed6913 2005-07-13 devnull ffs:0123456789abcdef0123456789abcdef01234567
230 35ed6913 2005-07-13 devnull % 
231 35ed6913 2005-07-13 devnull .EE
232 35ed6913 2005-07-13 devnull .PP
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 :
236 35ed6913 2005-07-13 devnull .IP
237 35ed6913 2005-07-13 devnull .EX
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
245 35ed6913 2005-07-13 devnull % 
246 35ed6913 2005-07-13 devnull .EE
247 35ed6913 2005-07-13 devnull .PP
248 35ed6913 2005-07-13 devnull Mount the backups on a client machine using
249 35ed6913 2005-07-13 devnull .IR vmount :
250 35ed6913 2005-07-13 devnull .IP
251 35ed6913 2005-07-13 devnull .EX
252 35ed6913 2005-07-13 devnull # vmount udp!yourserver!nfs /dump
253 35ed6913 2005-07-13 devnull # ls /dump
254 35ed6913 2005-07-13 devnull 2005
255 35ed6913 2005-07-13 devnull # 
256 35ed6913 2005-07-13 devnull .EE
257 35ed6913 2005-07-13 devnull .PP
258 35ed6913 2005-07-13 devnull Mount the backups using the standard NFS mount program:
259 35ed6913 2005-07-13 devnull .IP
260 35ed6913 2005-07-13 devnull .EX
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 \
263 35ed6913 2005-07-13 devnull .EE