1 be7cbb4e 2005-07-12 devnull .TH VENTI 1
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
16 be7cbb4e 2005-07-12 devnull .B venti/write
29 be7cbb4e 2005-07-12 devnull .B venti/copy
37 be7cbb4e 2005-07-12 devnull .I srchost
38 be7cbb4e 2005-07-12 devnull .I dsthost
40 be7cbb4e 2005-07-12 devnull .SH DESCRIPTION
41 be7cbb4e 2005-07-12 devnull Venti is a SHA1-addressed block storage server.
43 be7cbb4e 2005-07-12 devnull .IR venti (7)
44 be7cbb4e 2005-07-12 devnull for a full introduction.
47 be7cbb4e 2005-07-12 devnull reads a block with the given
49 be7cbb4e 2005-07-12 devnull and numeric
51 be7cbb4e 2005-07-12 devnull from the server
53 be7cbb4e 2005-07-12 devnull and prints the block to standard output.
56 be7cbb4e 2005-07-12 devnull option is omitted,
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.
63 be7cbb4e 2005-07-12 devnull option is omitted,
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
70 be7cbb4e 2005-07-12 devnull command to standard error
71 be7cbb4e 2005-07-12 devnull to indicate the type of the block.
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
77 be7cbb4e 2005-07-12 devnull and prints the resulting score to standard output.
80 be7cbb4e 2005-07-12 devnull option is omitted,
82 be7cbb4e 2005-07-12 devnull uses type 0,
83 be7cbb4e 2005-07-12 devnull denoting a data block.
86 be7cbb4e 2005-07-12 devnull option is given,
88 3aec33fe 2005-07-18 devnull zero truncates the block before writing it to the server.
93 be7cbb4e 2005-07-12 devnull to be the score of a
94 be7cbb4e 2005-07-12 devnull .B VtRoot
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 .
104 be7cbb4e 2005-07-12 devnull option causes
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.
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
119 3aec33fe 2005-07-18 devnull .IR srchost .
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,
125 3aec33fe 2005-07-18 devnull exits after printing the first error.
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.
133 be7cbb4e 2005-07-12 devnull option is given,
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.