xref: /plan9/sys/man/6/venti.conf (revision d4a396f97aabf7f5cc848472b96e15867a00d28b)
1.TH VENTI.CONF 6
2.SH NAME
3venti.conf  \- a venti configuration file
4.SH DESCRIPTION
5A venti configuration file enumerates the various index sections and
6arenas that constitute a venti system.
7The components are indicated by the name of the file, typically
8a disk partition, in which they reside.  The configuration
9file is the only location that file names are used.  Internally,
10venti uses the names assigned when the components were formatted
11with
12.I fmtarenas
13or
14.I fmtisect
15(see
16.IR venti-fmt (8)).
17In particular, by changing the configuration a
18component can be copied to a different file.
19.PP
20The configuration file consists of lines in the form described below.
21Lines starting with
22.B #
23are comments.
24.TP
25.BI index " name
26Names the index for the system.
27.TP
28.BI arenas " file
29.I File
30contains a collection of arenas, formatted using
31.IR fmtarenas .
32.TP
33.BI isect " file
34.I File
35contains an index section, formatted using
36.IR fmtisect .
37.PP
38After formatting a venti system using
39.IR fmtindex ,
40the order of arenas and index sections should not be changed.
41Additional arenas can be appended to the configuration.
42.PP
43The configuration file optionally holds configuration parameters
44for the venti server itself.
45These are:
46.TP
47.BI mem " cachesize
48.TP
49.BI bcmem " blockcachesize
50.TP
51.BI icmem " indexcachesize
52.TP
53.BI addr " ventiaddress
54.TP
55.BI httpaddr " httpaddress
56.TP
57.B queuewrites
58.PD
59See
60.IR venti (8)
61for descriptions of these variables.
62.SH EXAMPLE
63.EX
64# a sample venti configuration file
65#
66# formatted with
67#	venti/fmtarenas arena. /tmp/disks/arenas
68# 	venti/fmtisect isect0 /tmp/disks/isect0
69# 	venti/fmtisect isect1 /tmp/disks/isect1
70#	venti/fmtindex venti.conf
71#
72# server is started with
73#	venti/venti
74
75# the name of the index
76index main
77
78# the index sections
79isect /tmp/disks/isect0
80isect /tmp/disks/isect1
81
82# the arenas
83arenas /tmp/disks/arenas
84.EE
85.SH "SEE ALSO"
86.IR fs (3),
87.IR venti (8),
88.IR venti-fmt (8)
89