From 3aec33fee92d97715e648bd8205823ddc7e5cbba Mon Sep 17 00:00:00 2001 From: rsc Date: Mon, 18 Jul 2005 22:41:58 +0000 Subject: done --- man/man1/0intro.1 | 1 + man/man1/hist.1 | 7 +- man/man1/vbackup.1 | 263 --------------------------------------------------- man/man1/venti.1 | 14 +-- man/man1/yesterday.1 | 11 +-- 5 files changed, 19 insertions(+), 277 deletions(-) delete mode 100644 man/man1/vbackup.1 (limited to 'man/man1') diff --git a/man/man1/0intro.1 b/man/man1/0intro.1 index b06d3d52..42e1caf2 100644 --- a/man/man1/0intro.1 +++ b/man/man1/0intro.1 @@ -311,6 +311,7 @@ the variable in .IR mk (1), .IR namespace (1), +.IR netfiles (1), .IR page (1), .IR psfonts (1), .IR rio (1), diff --git a/man/man1/hist.1 b/man/man1/hist.1 index 15e8df09..6b46587b 100644 --- a/man/man1/hist.1 +++ b/man/man1/hist.1 @@ -65,11 +65,16 @@ Examine changes in block.c: hist -d block.c .EE .SH FILES +.TF /dump +.TP .B /dump +by convention, root of dump file system +.PD .SH SOURCE .B /home/am3/rsc/src/backup/cmd/history.c .SH SEE ALSO -.IR yesterday (1) +.IR yesterday (1), +.IR vbackup (8) .SH BUGS Should be called .IR history , diff --git a/man/man1/vbackup.1 b/man/man1/vbackup.1 deleted file mode 100644 index 72d93e73..00000000 --- a/man/man1/vbackup.1 +++ /dev/null @@ -1,263 +0,0 @@ -.TH VBACKUP 8 -.SH NAME -vbackup, vcat, vftp, vmount, vmount0, vnfs \- -back up Unix file systems to Venti -.SH SYNOPSIS -.B vbackup -[ -.B -DVnv -] -[ -.B -s -.I secs -] -[ -.B -w -.I n -] -.I disk -[ -.I score -] -.PP -.B vcat -[ -.B -z -] -.I disk -| -.I score -.B > -.I disk -.PP -.B vftp -.I disk -| -.I score -.PP -.B vmount -[ -.B -v -] -.I addr -.I mtpt -.PP -.B vmount0 -[ -.B -v -] -[ -.B -h -.I handle -] -.I addr -.I mtpt -.PP -.B vnfs -[ -.B -LLMRVr -] -[ -.B -a -.I addr -] -[ -.B -m -.I mntaddr -] -[ -.B -b -.I blocksize -] -[ -.B -c -.I cachesize -] -.I config -.SH DESCRIPTION -These programs back up and restore standard -Unix file system images stored in -.IR venti (8). -Images stored in -.I venti -are named by -.IR scores , -which consist of a file system type followed -by a colon and forty hexadecimal digits, as in: -.IP -.EX -ffs:0123456789abcdef0123456789abcdef01234567 -.EE -.PP -(The hexadecimal data is the SHA1 hash of the Venti -root block representing the file system image.) -.PP -These programs expect the environment variable -.B $venti -to be set to the network address of the Venti server to use -(for example, -.B yourhost -or -.BR tcp!yourhost!venti ). -.PP -.I Vbackup -copies the file system stored on -.I disk -to the Venti server and prints the -score for the newly-stored image. -The argument -.I disk -should be a disk or disk partition device -that would be appropriate to pass to -.IR mount (8). -.PP -The optional argument -.I score -is the score of a previous backup of the disk image. -If -.I score -is given, -.I vbackup -will not write to Venti any blocks that have not changed -since the previous backup. -This is only a speed optimization: since the blocks are already -stored on Venti they need not be sent to the Venti server again. -.PP -The options to -.I vbackup -are: -.TP -.B -D -.TP -.B -V -.TP -.B -n -.TP -.B -v -.TP -.B -w \fIn -.TP -.B -s \fIsecs -.PP -.I Vcat -writes the named disk image to standard output. -Unused file system blocks are printed zeroed regardless -of their actual content. -.PP -If the -.B -z -flag is given, -.I vcat -will attempt to seek over unused blocks instead of writing to them. -The -.B -z -flag should only be used when standard output is seekable -.RI ( i.e. , -when it has been redirected to a file or disk). -.PP -.I Vftp -presents the -file system image named by -.I disk -or -.I score -in a shell-like -interactive session. -Type -.B help -at the -.B vftp> -prompt for details. -.PP -.I Vmount -mounts the NFS service at the network connection -.I address -onto -.IR mountpoint . -On most operating systems, -.I vmount -must be run by the user -.BR root . -.PP -.I Vmount0 -is a simple C program that -.I vmount -uses if -.IR mount (8) -does not suffice. -.PP -.I Vnfs -serves, using the -NFS version 3 protocol, -one or more disk images in a synthetic tree defined -by the configuration file -.IR config . -.I Vnfs -announces NFS service at -.IR addr -(default -.BR udp!*!nfs ) -and NFS mount service at -.IR mntaddr -(default -.BR udp!*!\fI999 ), -registering both with the port mapper. -If no port mapper is found running (on port 111), -.I vnfs -starts its own port mapper. -The options are: -.TP -.B -r -Reply to all NFS requests with RPC rejections. -.TP -.B -M -Do not announce an NFS mount service. -.TP -.B -P -Do not register service with the port mapper. -.TP -.B -a - - -.SH EXAMPLES -.PP -Back up the file system stored on -.BR /dev/da0s1a : -.IP -.EX -% vbackup /dev/da0s1a -ffs:0123456789abcdef0123456789abcdef01234567 -% -.EE -.PP -Serve that backup and a few others in a tree reminiscent -of Plan 9's dump file system, but hide each day's contents of -.B /tmp : -.IP -.EX -% cat config -mount /2005/0510 ffs:0123456789abcdef\fI...\fP -mount /2005/0510/home ffs:0123456789abcdef\fI...\fP -mount /2005/0510 ffs:0123456789abcdef\fI...\fP -mount /2005/0510/home ffs:0123456789abcdef\fI...\fP -hide /*/*/tmp -% vnfs -m -b 16k -c 1k config -% -.EE -.PP -Mount the backups on a client machine using -.IR vmount : -.IP -.EX -# vmount udp!yourserver!nfs /dump -# ls /dump -2005 -# -.EE -.PP -Mount the backups using the standard NFS mount program: -.IP -.EX -# mount -t nfs -o soft,intr,ro,nfsv3,rsize=8192,timeo=100 \ - -o nfsvers=3,nolock,noatime,nodev,nosuid \ -.EE diff --git a/man/man1/venti.1 b/man/man1/venti.1 index a40eebf9..24fa0773 100644 --- a/man/man1/venti.1 +++ b/man/man1/venti.1 @@ -85,7 +85,7 @@ If the .B -z option is given, .I write -truncates the block before writing it to the server. +zero truncates the block before writing it to the server. .PP .I Copy expects @@ -114,14 +114,15 @@ and .B -r option control .IR copy 's -behavior upon encountering errors while reading -from srchost. +reaction to errors reading +from +.IR srchost . .I Copy always prints information to standard error about each read error. By default, .I copy -immediately exits after printing the first error. +exits after printing the first error. If the .B -i option is given, read errors are ignored. @@ -138,12 +139,11 @@ It writes the new root score to standard output. .B \*9/src/cmd/venti/cmd .SH SEE ALSO .IR vac (1), -.IR vbackup (1), .IR venti (3), .IR vacfs (4), -.IR vnfs (4), .IR venti (7), +.IR vbackup (8), .IR venti (8) .SH BUGS There should be programs to read and write -streams and directories. +venti files and directories. diff --git a/man/man1/yesterday.1 b/man/man1/yesterday.1 index b8a198ba..87ec4ff6 100644 --- a/man/man1/yesterday.1 +++ b/man/man1/yesterday.1 @@ -84,16 +84,15 @@ Restore your profile from yesterday: yesterday -c ~/.profile .EE .SH FILES +.TF /dump .B /dump +by convention, root of the dump file system +.PD .SH SOURCE .B /usr/local/bin/yesterday .SH SEE ALSO .IR diff (1), -.IR hist (1) +.IR hist (1), +.IR vbackup (8) .SH BUGS -Backups are only available on -.B amsterdam -and -.BR toil . -.PP It's hard to use this command without singing. -- cgit v1.2.3