aboutsummaryrefslogtreecommitdiff
path: root/man/man8/venti.8
diff options
context:
space:
mode:
authorrsc <devnull@localhost>2005-01-03 06:41:38 +0000
committerrsc <devnull@localhost>2005-01-03 06:41:38 +0000
commita19c44b83b96fefad131ef324c3eb2916e8c604c (patch)
tree9fee0b867751c0b9fe63a2763067c2e37403a866 /man/man8/venti.8
parent058b0118a52061ad57694c01fc8763b22b789c4d (diff)
downloadplan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.tar.gz
plan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.tar.bz2
plan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.zip
Add mkfile to keep indices up to date.
Remove man pages for things we don't provide.
Diffstat (limited to 'man/man8/venti.8')
-rw-r--r--man/man8/venti.8232
1 files changed, 0 insertions, 232 deletions
diff --git a/man/man8/venti.8 b/man/man8/venti.8
deleted file mode 100644
index be112a6a..00000000
--- a/man/man8/venti.8
+++ /dev/null
@@ -1,232 +0,0 @@
-.TH VENTI 8
-.SH NAME
-venti \- an archival block storage server
-.SH SYNOPSIS
-.B venti/venti
-[
-.B -dsw
-]
-[
-.B -a
-.I ventiaddress
-]
-[
-.B -B
-.I blockcachesize
-]
-[
-.B -c
-.I config
-]
-[
-.B -C
-.I cachesize
-]
-[
-.B -h
-.I httpaddress
-]
-[
-.B -I
-.I icachesize
-]
-.PP
-.B venti/sync
-[
-.B -h
-.I host
-]
-.SH DESCRIPTION
-.I Venti
-is a block storage server intended for archival data.
-In a Venti server,
-the SHA1 hash of a block's contents acts as the block
-identifier for read and write operations.
-This approach enforces a write-once policy, preventing accidental or
-malicious destruction of data. In addition, duplicate copies of a
-block are coalesced, reducing the consumption of storage and
-simplifying the implementation of clients.
-.PP
-Storage for
-.I venti
-consists of a data log and an index, both of which
-can be spread across multiple files.
-The files containing the data log are themselves divided into self-contained sections called arenas.
-Each arena contains a large number of data blocks and is sized to
-facilitate operations such as copying to removable media.
-The index provides a mapping between the a Sha1 fingerprint and
-the location of the corresponding block in the data log.
-.PP
-The index and data log are typically stored on raw disk partitions.
-To improve the robustness, the data log should be stored on
-a device that provides RAID functionality. The index does
-not require such protection, since if necessary, it can
-can be regenerated from the data log.
-The performance of
-.I venti
-is typically limited to the random access performance
-of the index. This performance can be improved by spreading the
-index accross multiple disks.
-.PP
-The storage for
-.I venti
-is initialized using
-.IR fmtarenas ,
-.IR fmtisect ,
-and
-.I fmtindex
-(see
-.IR ventiaux (8)).
-A configuration file,
-.IR venti.conf (6),
-ties the index sections and data arenas together.
-.PP
-A Venti
-server is accessed via an undocumented network protocol.
-Two client applications are included in this distribution:
-.IR vac (1)
-and
-.IR vacfs (4).
-.I Vac
-copies files from a Plan 9 file system to Venti, creating an
-archive and returning the fingerprint of the root.
-This archive can be mounted in Plan 9 using
-.IR vacfs .
-These two commands enable a rudimentary backup system.
-A future release will include a Plan 9 file system that uses
-Venti as a replacement for the WORM device of
-.IR fs (4).
-.PP
-The
-.I venti
-server provides rudimentary status information via
-a built-in http server. The URL files it serves are:
-.TP
-.B stats
-Various internal statistics.
-.TP
-.B index
-An enumeration of the index sections and all non empty arenas, including various statistics.
-.TP
-.B storage
-A summary of the state of the data log.
-.TP
-.B xindex
-An enumeration of the index sections and all non empty arenas, in XML format.
-.PP
-Several auxiliary utilities (see
-.IR ventiaux (8))
-aid in maintaining the storage for Venti.
-With the exception of
-.I rdarena ,
-these utilities should generally be run after killing the
-.I venti
-server.
-The utilities are:
-.TP
-.I checkarenas
-Check the integrity, and optionally fix, Venti arenas.
-.TP
-.I checkindex
-Check the integrity, and optionally fix, a Venti index.
-.TP
-.I buildindex
-Rebuild a Venti index from scratch.
-.TP
-.I rdarena
-Extract a Venti arena and write to standard output.
-.PD
-.PP
-Options to
-.I venti
-are:
-.TP
-.BI -a " ventiaddress
-The network address on which the server listens for incoming connections.
-The default is
-.LR tcp!*!venti .
-.TP
-.BI -B " blockcachesize
-The size, in bytes, of memory allocated to caching raw disk blocks.
-.TP
-.BI -c " config
-Specifies the
-Venti
-configuration file.
-Defaults to
-.LR venti.conf .
-.TP
-.BI -C " cachesize
-The size, in bytes, of memory allocated to caching
-Venti
-blocks.
-.TP
-.BI -d
-Produce various debugging information on standard error.
-.TP
-.BI -h " httpaddress
-The network address of Venti's built-in
-http
-server.
-The default is
-.LR tcp!*!http .
-.TP
-.BI -I " icachesize
-The size, in bytes, of memory allocated to caching the index mapping fingerprints
-to locations in
-.IR venti 's
-data log.
-.TP
-.B -s
-Do not run in the background.
-Normally,
-the foreground process will exit once the Venti server
-is initialized and ready for connections.
-.TP
-.B -w
-Enable write buffering. This option increase the performance of writes to
-.I venti
-at the cost of returning success to the client application before the
-data has been written to disk.
-The server implements a
-.I sync
-rpc that waits for completion of all the writes buffered at the time
-the rpc was received.
-Applications such as
-.IR vac (1)
-and the
-.I sync
-command described below
-use this rpc to make sure that the data is correctly written to disk.
-Use of this option is recommended.
-.PD
-.PP
-The units for the various cache sizes above can be specified by appending a
-.LR k ,
-.LR m ,
-or
-.LR g
-to indicate kilobytes, megabytes, or gigabytes respectively.
-The command line options override options found in the
-.IR venti.conf (6)
-file.
-.PP
-.I Sync
-connects to a running Venti server and executes a sync rpc
-(described with the
-.B -w
-option above).
-If sync exits successfully, it means that all writes buffered at the
-time the command was issued are now on disk.
-.SH SOURCE
-.B /sys/src/cmd/venti
-.SH "SEE ALSO"
-.IR venti.conf (6),
-.IR ventiaux (8),
-.IR vac (1),
-.IR vacfs (4).
-.br
-Sean Quinlan and Sean Dorward,
-``Venti: a new approach to archival storage'',
-.I "Usenix Conference on File and Storage Technologies" ,
-2002.