1 be7cbb4e 2005-07-12 devnull .TH VENTI 1
  2 be7cbb4e 2005-07-12 devnull .SH NAME
  3 be7cbb4e 2005-07-12 devnull read, write, copy \- simple Venti clients
  4 be7cbb4e 2005-07-12 devnull .SH SYNOPSIS
  5 be7cbb4e 2005-07-12 devnull .B venti/read
  6 be7cbb4e 2005-07-12 devnull [
  7 be7cbb4e 2005-07-12 devnull .B -h
  8 be7cbb4e 2005-07-12 devnull .I host
  9 be7cbb4e 2005-07-12 devnull ]
 10 be7cbb4e 2005-07-12 devnull [
 11 be7cbb4e 2005-07-12 devnull .B -t
 12 be7cbb4e 2005-07-12 devnull .I type
 13 be7cbb4e 2005-07-12 devnull ]
 14 be7cbb4e 2005-07-12 devnull .I score
 15 be7cbb4e 2005-07-12 devnull .br
 16 be7cbb4e 2005-07-12 devnull .B venti/write
 17 be7cbb4e 2005-07-12 devnull [
 18 be7cbb4e 2005-07-12 devnull .B -z
 19 be7cbb4e 2005-07-12 devnull ]
 20 be7cbb4e 2005-07-12 devnull [
 21 be7cbb4e 2005-07-12 devnull .B -h
 22 be7cbb4e 2005-07-12 devnull .I host
 23 be7cbb4e 2005-07-12 devnull ]
 24 be7cbb4e 2005-07-12 devnull [
 25 be7cbb4e 2005-07-12 devnull .B -t
 26 be7cbb4e 2005-07-12 devnull .I type
 27 be7cbb4e 2005-07-12 devnull ]
 28 be7cbb4e 2005-07-12 devnull .br
 29 be7cbb4e 2005-07-12 devnull .B venti/copy
 30 be7cbb4e 2005-07-12 devnull [
 31 be7cbb4e 2005-07-12 devnull .B -fir
 32 be7cbb4e 2005-07-12 devnull ]
 33 be7cbb4e 2005-07-12 devnull [
 34 be7cbb4e 2005-07-12 devnull .B -t
 35 be7cbb4e 2005-07-12 devnull .I type
 36 be7cbb4e 2005-07-12 devnull ]
 37 be7cbb4e 2005-07-12 devnull .I srchost
 38 be7cbb4e 2005-07-12 devnull .I dsthost
 39 be7cbb4e 2005-07-12 devnull .I score
 40 be7cbb4e 2005-07-12 devnull .SH DESCRIPTION
 41 be7cbb4e 2005-07-12 devnull Venti is a SHA1-addressed block storage server.
 42 be7cbb4e 2005-07-12 devnull See 
 43 be7cbb4e 2005-07-12 devnull .IR venti (7)
 44 be7cbb4e 2005-07-12 devnull for a full introduction.
 45 be7cbb4e 2005-07-12 devnull .PP
 46 be7cbb4e 2005-07-12 devnull .I Read
 47 be7cbb4e 2005-07-12 devnull reads a block with the given
 48 be7cbb4e 2005-07-12 devnull .I score
 49 be7cbb4e 2005-07-12 devnull and numeric
 50 be7cbb4e 2005-07-12 devnull .I type 
 51 be7cbb4e 2005-07-12 devnull from the server
 52 be7cbb4e 2005-07-12 devnull .I host
 53 be7cbb4e 2005-07-12 devnull and prints the block to standard output.
 54 be7cbb4e 2005-07-12 devnull If the
 55 be7cbb4e 2005-07-12 devnull .B -h
 56 be7cbb4e 2005-07-12 devnull option is omitted,
 57 be7cbb4e 2005-07-12 devnull .I read
 58 be7cbb4e 2005-07-12 devnull consults the environment variable
 59 be7cbb4e 2005-07-12 devnull .B $venti
 60 be7cbb4e 2005-07-12 devnull for the name of the Venti server.
 61 be7cbb4e 2005-07-12 devnull If the
 62 be7cbb4e 2005-07-12 devnull .B -t
 63 be7cbb4e 2005-07-12 devnull option is omitted,
 64 be7cbb4e 2005-07-12 devnull .I read
 65 be7cbb4e 2005-07-12 devnull will try each type, one at a time, until it finds
 66 be7cbb4e 2005-07-12 devnull one that works.
 67 be7cbb4e 2005-07-12 devnull It prints the corresponding
 68 be7cbb4e 2005-07-12 devnull .B read
 69 be7cbb4e 2005-07-12 devnull .B -t
 70 be7cbb4e 2005-07-12 devnull command to standard error
 71 be7cbb4e 2005-07-12 devnull to indicate the type of the block.
 72 be7cbb4e 2005-07-12 devnull .PP
 73 be7cbb4e 2005-07-12 devnull .I Write
 74 be7cbb4e 2005-07-12 devnull writes at most 56 kilobytes of data from standard input 
 75 be7cbb4e 2005-07-12 devnull to the server
 76 be7cbb4e 2005-07-12 devnull .I host
 77 be7cbb4e 2005-07-12 devnull and prints the resulting score to standard output.
 78 be7cbb4e 2005-07-12 devnull If the
 79 be7cbb4e 2005-07-12 devnull .B -t
 80 be7cbb4e 2005-07-12 devnull option is omitted,
 81 be7cbb4e 2005-07-12 devnull .I write
 82 be7cbb4e 2005-07-12 devnull uses type 0,
 83 be7cbb4e 2005-07-12 devnull denoting a data block.
 84 be7cbb4e 2005-07-12 devnull If the
 85 be7cbb4e 2005-07-12 devnull .B -z
 86 be7cbb4e 2005-07-12 devnull option is given,
 87 be7cbb4e 2005-07-12 devnull .I write
 88 3aec33fe 2005-07-18 devnull zero truncates the block before writing it to the server.
 89 be7cbb4e 2005-07-12 devnull .PP
 90 be7cbb4e 2005-07-12 devnull .I Copy
 91 be7cbb4e 2005-07-12 devnull expects
 92 be7cbb4e 2005-07-12 devnull .I score
 93 be7cbb4e 2005-07-12 devnull to be the score of a 
 94 be7cbb4e 2005-07-12 devnull .B VtRoot
 95 be7cbb4e 2005-07-12 devnull block.
 96 be7cbb4e 2005-07-12 devnull It copies the entire tree of blocks reachable from
 97 be7cbb4e 2005-07-12 devnull the root block from the server
 98 be7cbb4e 2005-07-12 devnull .I srchost
 99 be7cbb4e 2005-07-12 devnull to the server
100 be7cbb4e 2005-07-12 devnull .IR dsthost .
101 be7cbb4e 2005-07-12 devnull .PP
102 be7cbb4e 2005-07-12 devnull The
103 be7cbb4e 2005-07-12 devnull .B -f
104 be7cbb4e 2005-07-12 devnull option causes
105 be7cbb4e 2005-07-12 devnull .I copy
106 be7cbb4e 2005-07-12 devnull to run in `fast' mode,
107 be7cbb4e 2005-07-12 devnull assuming that if a block already exists on the
108 be7cbb4e 2005-07-12 devnull destination Venti server, all its children also
109 be7cbb4e 2005-07-12 devnull exist and need not be checked.
110 be7cbb4e 2005-07-12 devnull .PP
111 be7cbb4e 2005-07-12 devnull The
112 be7cbb4e 2005-07-12 devnull .B -i
113 be7cbb4e 2005-07-12 devnull and
114 be7cbb4e 2005-07-12 devnull .B -r
115 be7cbb4e 2005-07-12 devnull option control
116 be7cbb4e 2005-07-12 devnull .IR copy 's
117 3aec33fe 2005-07-18 devnull reaction to errors reading
118 3aec33fe 2005-07-18 devnull from
119 3aec33fe 2005-07-18 devnull .IR srchost .
120 be7cbb4e 2005-07-12 devnull .I Copy
121 be7cbb4e 2005-07-12 devnull always prints information to standard error
122 be7cbb4e 2005-07-12 devnull about each read error.
123 be7cbb4e 2005-07-12 devnull By default,
124 be7cbb4e 2005-07-12 devnull .I copy
125 3aec33fe 2005-07-18 devnull exits after printing the first error.
126 be7cbb4e 2005-07-12 devnull If the
127 be7cbb4e 2005-07-12 devnull .B -i
128 be7cbb4e 2005-07-12 devnull option is given, read errors are ignored.
129 be7cbb4e 2005-07-12 devnull This is dangerous behavior because it breaks the 
130 be7cbb4e 2005-07-12 devnull assumption made by `fast' mode.
131 be7cbb4e 2005-07-12 devnull If the
132 be7cbb4e 2005-07-12 devnull .B -r
133 be7cbb4e 2005-07-12 devnull option is given, 
134 be7cbb4e 2005-07-12 devnull .I copy
135 be7cbb4e 2005-07-12 devnull replaces pointers to unreadable blocks with
136 be7cbb4e 2005-07-12 devnull pointers to the zero block.
137 be7cbb4e 2005-07-12 devnull It writes the new root score to standard output.
138 be7cbb4e 2005-07-12 devnull .SH SOURCE
139 e5e159fd 2005-07-18 devnull .B \*9/src/cmd/venti
140 be7cbb4e 2005-07-12 devnull .SH SEE ALSO
141 be7cbb4e 2005-07-12 devnull .IR vac (1),
142 be7cbb4e 2005-07-12 devnull .IR venti (3),
143 be7cbb4e 2005-07-12 devnull .IR vacfs (4),
144 be7cbb4e 2005-07-12 devnull .IR venti (7),
145 3aec33fe 2005-07-18 devnull .IR vbackup (8),
146 be7cbb4e 2005-07-12 devnull .IR venti (8)
147 be7cbb4e 2005-07-12 devnull .SH BUGS
148 be7cbb4e 2005-07-12 devnull There should be programs to read and write
149 3aec33fe 2005-07-18 devnull venti files and directories.