1 004aa293 2005-07-13 devnull .TH VBACKUP 8
  2 004aa293 2005-07-13 devnull .SH NAME
  3 004aa293 2005-07-13 devnull vbackup, vcat, vftp, vmount, vmount0, vnfs \- 
  4 004aa293 2005-07-13 devnull back up Unix file systems to Venti
  5 004aa293 2005-07-13 devnull .SH SYNOPSIS
  6 004aa293 2005-07-13 devnull .B vbackup
  7 004aa293 2005-07-13 devnull [
  8 004aa293 2005-07-13 devnull .B -DVnv
  9 004aa293 2005-07-13 devnull ]
 10 004aa293 2005-07-13 devnull [
 11 004aa293 2005-07-13 devnull .B -s
 12 004aa293 2005-07-13 devnull .I secs
 13 004aa293 2005-07-13 devnull ]
 14 004aa293 2005-07-13 devnull [
 15 004aa293 2005-07-13 devnull .B -w
 16 004aa293 2005-07-13 devnull .I n
 17 004aa293 2005-07-13 devnull ]
 18 004aa293 2005-07-13 devnull .I disk
 19 004aa293 2005-07-13 devnull [
 20 004aa293 2005-07-13 devnull .I score
 21 004aa293 2005-07-13 devnull ]
 22 004aa293 2005-07-13 devnull .PP
 23 004aa293 2005-07-13 devnull .B vcat
 24 004aa293 2005-07-13 devnull [
 25 004aa293 2005-07-13 devnull .B -z
 26 004aa293 2005-07-13 devnull ]
 27 004aa293 2005-07-13 devnull .I disk
 28 004aa293 2005-07-13 devnull |
 29 004aa293 2005-07-13 devnull .I score
 30 004aa293 2005-07-13 devnull .B >
 31 004aa293 2005-07-13 devnull .I disk
 32 004aa293 2005-07-13 devnull .PP
 33 004aa293 2005-07-13 devnull .B vftp
 34 004aa293 2005-07-13 devnull .I disk
 35 004aa293 2005-07-13 devnull |
 36 004aa293 2005-07-13 devnull .I score
 37 004aa293 2005-07-13 devnull .PP
 38 004aa293 2005-07-13 devnull .B vmount
 39 004aa293 2005-07-13 devnull [
 40 004aa293 2005-07-13 devnull .B -v
 41 004aa293 2005-07-13 devnull ]
 42 004aa293 2005-07-13 devnull .I addr
 43 004aa293 2005-07-13 devnull .I mtpt
 44 004aa293 2005-07-13 devnull .PP
 45 004aa293 2005-07-13 devnull .B vmount0
 46 004aa293 2005-07-13 devnull [
 47 004aa293 2005-07-13 devnull .B -v
 48 004aa293 2005-07-13 devnull ]
 49 004aa293 2005-07-13 devnull [
 50 004aa293 2005-07-13 devnull .B -h
 51 004aa293 2005-07-13 devnull .I handle
 52 004aa293 2005-07-13 devnull ]
 53 004aa293 2005-07-13 devnull .I addr
 54 004aa293 2005-07-13 devnull .I mtpt
 55 004aa293 2005-07-13 devnull .PP
 56 004aa293 2005-07-13 devnull .B vnfs
 57 004aa293 2005-07-13 devnull [
 58 004aa293 2005-07-13 devnull .B -LLMRVr
 59 004aa293 2005-07-13 devnull ]
 60 004aa293 2005-07-13 devnull [
 61 004aa293 2005-07-13 devnull .B -a
 62 004aa293 2005-07-13 devnull .I addr
 63 004aa293 2005-07-13 devnull ]
 64 004aa293 2005-07-13 devnull [
 65 004aa293 2005-07-13 devnull .B -m
 66 004aa293 2005-07-13 devnull .I mntaddr
 67 004aa293 2005-07-13 devnull ]
 68 004aa293 2005-07-13 devnull [
 69 004aa293 2005-07-13 devnull .B -b
 70 004aa293 2005-07-13 devnull .I blocksize
 71 004aa293 2005-07-13 devnull ]
 72 004aa293 2005-07-13 devnull [
 73 004aa293 2005-07-13 devnull .B -c
 74 004aa293 2005-07-13 devnull .I cachesize
 75 004aa293 2005-07-13 devnull ]
 76 004aa293 2005-07-13 devnull .I config
 77 004aa293 2005-07-13 devnull .SH DESCRIPTION
 78 004aa293 2005-07-13 devnull These programs back up and restore standard
 79 004aa293 2005-07-13 devnull Unix file system images stored in
 80 004aa293 2005-07-13 devnull .IR venti (8).
 81 004aa293 2005-07-13 devnull Images stored in
 82 004aa293 2005-07-13 devnull .I venti
 83 004aa293 2005-07-13 devnull are named by
 84 004aa293 2005-07-13 devnull .IR scores ,
 85 004aa293 2005-07-13 devnull which consist of a file system type followed
 86 004aa293 2005-07-13 devnull by a colon and forty hexadecimal digits, as in:
 87 004aa293 2005-07-13 devnull .IP
 88 004aa293 2005-07-13 devnull .EX
 89 004aa293 2005-07-13 devnull ffs:0123456789abcdef0123456789abcdef01234567
 90 004aa293 2005-07-13 devnull .EE
 91 004aa293 2005-07-13 devnull .PP
 92 004aa293 2005-07-13 devnull (The hexadecimal data is the SHA1 hash of the Venti
 93 004aa293 2005-07-13 devnull root block representing the file system image.)
 94 004aa293 2005-07-13 devnull .PP
 95 004aa293 2005-07-13 devnull These programs expect the environment variable
 96 004aa293 2005-07-13 devnull .B $venti
 97 004aa293 2005-07-13 devnull to be set to the network address of the Venti server to use
 98 004aa293 2005-07-13 devnull (for example,
 99 004aa293 2005-07-13 devnull .B yourhost
100 004aa293 2005-07-13 devnull or
101 004aa293 2005-07-13 devnull .BR tcp!yourhost!venti ).
102 004aa293 2005-07-13 devnull .PP
103 004aa293 2005-07-13 devnull .I Vbackup
104 004aa293 2005-07-13 devnull copies the file system stored on
105 004aa293 2005-07-13 devnull .I disk
106 004aa293 2005-07-13 devnull to the Venti server and prints the 
107 004aa293 2005-07-13 devnull score for the newly-stored image.
108 004aa293 2005-07-13 devnull The argument
109 004aa293 2005-07-13 devnull .I disk
110 004aa293 2005-07-13 devnull should be a disk or disk partition device
111 004aa293 2005-07-13 devnull that would be appropriate to pass to
112 004aa293 2005-07-13 devnull .IR mount (8).
113 004aa293 2005-07-13 devnull .PP
114 004aa293 2005-07-13 devnull The optional argument
115 004aa293 2005-07-13 devnull .I score
116 004aa293 2005-07-13 devnull is the score of a previous backup of the disk image.
117 004aa293 2005-07-13 devnull If
118 004aa293 2005-07-13 devnull .I score
119 004aa293 2005-07-13 devnull is given, 
120 004aa293 2005-07-13 devnull .I vbackup
121 004aa293 2005-07-13 devnull will not write to Venti any blocks that have not changed
122 004aa293 2005-07-13 devnull since the previous backup.
123 004aa293 2005-07-13 devnull This is only a speed optimization: since the blocks are already
124 004aa293 2005-07-13 devnull stored on Venti they need not be sent to the Venti server again.
125 004aa293 2005-07-13 devnull .PP
126 004aa293 2005-07-13 devnull The options to
127 004aa293 2005-07-13 devnull .I vbackup
128 004aa293 2005-07-13 devnull are:
129 004aa293 2005-07-13 devnull .TP
130 004aa293 2005-07-13 devnull .B -D
131 004aa293 2005-07-13 devnull .TP
132 004aa293 2005-07-13 devnull .B -V
133 004aa293 2005-07-13 devnull .TP
134 004aa293 2005-07-13 devnull .B -n
135 004aa293 2005-07-13 devnull .TP
136 004aa293 2005-07-13 devnull .B -v
137 004aa293 2005-07-13 devnull .TP
138 004aa293 2005-07-13 devnull .B -w \fIn
139 004aa293 2005-07-13 devnull .TP
140 004aa293 2005-07-13 devnull .B -s \fIsecs
141 004aa293 2005-07-13 devnull .PP
142 004aa293 2005-07-13 devnull .I Vcat
143 004aa293 2005-07-13 devnull writes the named disk image to standard output.
144 004aa293 2005-07-13 devnull Unused file system blocks are printed zeroed regardless
145 004aa293 2005-07-13 devnull of their actual content.
146 004aa293 2005-07-13 devnull .PP
147 004aa293 2005-07-13 devnull If the
148 004aa293 2005-07-13 devnull .B -z
149 004aa293 2005-07-13 devnull flag is given, 
150 004aa293 2005-07-13 devnull .I vcat
151 004aa293 2005-07-13 devnull will attempt to seek over unused blocks instead of writing to them.
152 004aa293 2005-07-13 devnull The
153 004aa293 2005-07-13 devnull .B -z
154 004aa293 2005-07-13 devnull flag should only be used when standard output is seekable
155 004aa293 2005-07-13 devnull .RI ( i.e. ,
156 004aa293 2005-07-13 devnull when it has been redirected to a file or disk).
157 004aa293 2005-07-13 devnull .PP
158 004aa293 2005-07-13 devnull .I Vftp
159 004aa293 2005-07-13 devnull presents the
160 004aa293 2005-07-13 devnull file system image named by
161 004aa293 2005-07-13 devnull .I disk
162 004aa293 2005-07-13 devnull or
163 004aa293 2005-07-13 devnull .I score
164 004aa293 2005-07-13 devnull in a shell-like
165 004aa293 2005-07-13 devnull interactive session.
166 004aa293 2005-07-13 devnull Type
167 004aa293 2005-07-13 devnull .B help
168 004aa293 2005-07-13 devnull at the
169 004aa293 2005-07-13 devnull .B vftp>
170 004aa293 2005-07-13 devnull prompt for details.
171 004aa293 2005-07-13 devnull .PP
172 004aa293 2005-07-13 devnull .I Vmount
173 004aa293 2005-07-13 devnull mounts the NFS service at the network connection
174 004aa293 2005-07-13 devnull .I address
175 004aa293 2005-07-13 devnull onto
176 004aa293 2005-07-13 devnull .IR mountpoint .
177 004aa293 2005-07-13 devnull On most operating systems,
178 004aa293 2005-07-13 devnull .I vmount
179 004aa293 2005-07-13 devnull must be run by the user
180 004aa293 2005-07-13 devnull .BR root .
181 004aa293 2005-07-13 devnull .PP
182 004aa293 2005-07-13 devnull .I Vmount0
183 004aa293 2005-07-13 devnull is a simple C program that 
184 004aa293 2005-07-13 devnull .I vmount
185 004aa293 2005-07-13 devnull uses if 
186 004aa293 2005-07-13 devnull .IR mount (8)
187 004aa293 2005-07-13 devnull does not suffice.
188 004aa293 2005-07-13 devnull .PP
189 004aa293 2005-07-13 devnull .I Vnfs
190 004aa293 2005-07-13 devnull serves, using the
191 004aa293 2005-07-13 devnull NFS version 3 protocol,
192 004aa293 2005-07-13 devnull one or more disk images in a synthetic tree defined
193 004aa293 2005-07-13 devnull by the configuration file
194 004aa293 2005-07-13 devnull .IR config .
195 004aa293 2005-07-13 devnull .I Vnfs
196 004aa293 2005-07-13 devnull announces NFS service at
197 004aa293 2005-07-13 devnull .IR addr 
198 004aa293 2005-07-13 devnull (default
199 004aa293 2005-07-13 devnull .BR udp!*!nfs )
200 004aa293 2005-07-13 devnull and NFS mount service at
201 004aa293 2005-07-13 devnull .IR mntaddr
202 004aa293 2005-07-13 devnull (default
203 004aa293 2005-07-13 devnull .BR udp!*!\fI999 ),
204 004aa293 2005-07-13 devnull registering both with the port mapper.
205 004aa293 2005-07-13 devnull If no port mapper is found running (on port 111),
206 004aa293 2005-07-13 devnull .I vnfs
207 004aa293 2005-07-13 devnull starts its own port mapper.
208 004aa293 2005-07-13 devnull The options are:
209 004aa293 2005-07-13 devnull .TP
210 004aa293 2005-07-13 devnull .B -r
211 004aa293 2005-07-13 devnull Reply to all NFS requests with RPC rejections.
212 004aa293 2005-07-13 devnull .TP
213 004aa293 2005-07-13 devnull .B -M
214 004aa293 2005-07-13 devnull Do not announce an NFS mount service.
215 004aa293 2005-07-13 devnull .TP
216 004aa293 2005-07-13 devnull .B -P
217 004aa293 2005-07-13 devnull Do not register service with the port mapper.
218 004aa293 2005-07-13 devnull .TP
219 004aa293 2005-07-13 devnull .B -a
220 004aa293 2005-07-13 devnull 
221 004aa293 2005-07-13 devnull 
222 004aa293 2005-07-13 devnull .SH EXAMPLES
223 004aa293 2005-07-13 devnull .PP
224 004aa293 2005-07-13 devnull Back up the file system stored on
225 004aa293 2005-07-13 devnull .BR /dev/da0s1a :
226 004aa293 2005-07-13 devnull .IP
227 004aa293 2005-07-13 devnull .EX
228 004aa293 2005-07-13 devnull % vbackup /dev/da0s1a
229 004aa293 2005-07-13 devnull ffs:0123456789abcdef0123456789abcdef01234567
230 004aa293 2005-07-13 devnull % 
231 004aa293 2005-07-13 devnull .EE
232 004aa293 2005-07-13 devnull .PP
233 004aa293 2005-07-13 devnull Serve that backup and a few others in a tree reminiscent
234 004aa293 2005-07-13 devnull of Plan 9's dump file system, but hide each day's contents of
235 004aa293 2005-07-13 devnull .B /tmp :
236 004aa293 2005-07-13 devnull .IP
237 004aa293 2005-07-13 devnull .EX
238 004aa293 2005-07-13 devnull % cat config
239 004aa293 2005-07-13 devnull mount /2005/0510 ffs:0123456789abcdef\fI...\fP
240 004aa293 2005-07-13 devnull mount /2005/0510/home ffs:0123456789abcdef\fI...\fP
241 004aa293 2005-07-13 devnull mount /2005/0510 ffs:0123456789abcdef\fI...\fP
242 004aa293 2005-07-13 devnull mount /2005/0510/home ffs:0123456789abcdef\fI...\fP
243 004aa293 2005-07-13 devnull hide /*/*/tmp
244 004aa293 2005-07-13 devnull % vnfs -m -b 16k -c 1k config
245 004aa293 2005-07-13 devnull % 
246 004aa293 2005-07-13 devnull .EE
247 004aa293 2005-07-13 devnull .PP
248 004aa293 2005-07-13 devnull Mount the backups on a client machine using
249 004aa293 2005-07-13 devnull .IR vmount :
250 004aa293 2005-07-13 devnull .IP
251 004aa293 2005-07-13 devnull .EX
252 004aa293 2005-07-13 devnull # vmount udp!yourserver!nfs /dump
253 004aa293 2005-07-13 devnull # ls /dump
254 004aa293 2005-07-13 devnull 2005
255 004aa293 2005-07-13 devnull # 
256 004aa293 2005-07-13 devnull .EE
257 004aa293 2005-07-13 devnull .PP
258 004aa293 2005-07-13 devnull Mount the backups using the standard NFS mount program:
259 004aa293 2005-07-13 devnull .IP
260 004aa293 2005-07-13 devnull .EX
261 004aa293 2005-07-13 devnull # mount -t nfs -o soft,intr,ro,nfsv3,rsize=8192,timeo=100 \
262 004aa293 2005-07-13 devnull 	-o nfsvers=3,nolock,noatime,nodev,nosuid \
263 004aa293 2005-07-13 devnull .EE