1 .TH VENTI.CONF 6
2 .SH NAME
3 venti.conf  \- a venti configuration file
4 .SH DESCRIPTION
5 A venti configuration file enumerates the various index sections and
6 arenas that constitute a venti system.
7 The components are indicated by the name of the file, typically
8 a disk partition, in which they reside.  The configuration
9 file is the only location that file names are used.  Internally,
10 venti uses the names assigned when the components were formatted
11 with 
12 .I fmtarenas
13 or 
14 .I fmtisect
15 (see
16 .IR ventiaux (8)).
17 In particular, by changing the configuration a
18 component can be copied to a different file.
19 .PP
20 The configuration file consists of lines in the form described below.
21 Lines starting with
22 .B #
23 are comments.
24 .TP
25 .BI index " name
26 Names the index for the system.
27 .TP
28 .BI arenas " file
29 .I File
30 contains a collection of arenas, formatted using
31 .IR fmtarenas .
32 .TP
33 .BI isect " file
34 .I File
35 contains an index section, formatted using
36 .IR fmtisect .
37 .PP
38 After formatting a venti system using
39 .IR fmtindex ,
40 the order of arenas and index sections should not be changed.
41 Additional arenas can be appended to the configuration.
42 .PP
43 The configuration file optionally holds configuration parameters
44 for the venti server itself.
45 These 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
59 See 
60 .IR venti (8)
61 for 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
76 index main
77 
78 # the index sections
79 isect /tmp/disks/isect0
80 isect /tmp/disks/isect1
81 
82 # the arenas
83 arenas /tmp/disks/arenas
84 .EE
85 .SH "SEE ALSO"
86 .IR venti (8),
87 .IR ventiaux (8)