equal
deleted
inserted
replaced
5 --------------------------- |
5 --------------------------- |
6 Konfigurationsdatei für vmm |
6 Konfigurationsdatei für vmm |
7 --------------------------- |
7 --------------------------- |
8 |
8 |
9 :Author: Pascal Volk <neverseen@users.sourceforge.net> |
9 :Author: Pascal Volk <neverseen@users.sourceforge.net> |
10 :Date: 2010-01-25 |
10 :Date: 2010-01-26 |
11 :Version: vmm-0.6.0 |
11 :Version: vmm-0.6.0 |
12 :Manual group: vmm Manual |
12 :Manual group: vmm Manual |
13 :Manual section: 5 |
13 :Manual section: 5 |
14 |
14 |
15 .. contents:: |
15 .. contents:: |
22 |
22 |
23 BESCHREIBUNG |
23 BESCHREIBUNG |
24 ============ |
24 ============ |
25 **vmm**\(1) liest seine Konfigurationsparameter aus der Datei *vmm.cfg*. |
25 **vmm**\(1) liest seine Konfigurationsparameter aus der Datei *vmm.cfg*. |
26 |
26 |
27 Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt |
27 Die Konfigurationsdatei ist in mehrere Sektionen unterteilt. Jede Sektion |
28 wird mit dem, in eckigen Klammern '**[**' und '**]**' eingefassten, Namen des |
28 wird mit dem in eckigen Klammern '**[**' und '**]**' eingefassten Namen der |
29 Abschnitts eingeleitet, gefolgt von '*Option* = *Wert*' Einträgen:: |
29 Sektion eingeleitet, gefolgt von '*Option* = *Wert*' Einträgen. |
30 |
|
31 [database] |
|
32 host = 127.0.0.1 |
|
33 |
30 |
34 Leerräume um das Gleichheitszeichen '=' und am Ende eines Wertes werden |
31 Leerräume um das Gleichheitszeichen '=' und am Ende eines Wertes werden |
35 ignoriert. |
32 ignoriert. |
36 |
33 |
37 Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden |
34 Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden |
52 |
49 |
53 * *String* eine Folge von Buchstaben und Zahlen. |
50 * *String* eine Folge von Buchstaben und Zahlen. |
54 |
51 |
55 | Zum Beispiel: '**Wort**', '**Hallo Welt**' oder '**/usr/bin/strings**' |
52 | Zum Beispiel: '**Wort**', '**Hallo Welt**' oder '**/usr/bin/strings**' |
56 |
53 |
|
54 Die meisten Optionen haben einen Vorgabewert. Dieser ist nach dem Namen der |
|
55 Option in Klammern angegebenen. Um den Vorgabewert einer Option zu |
|
56 verwenden, wird die entsprechende Zeile entweder mit **#** oder **;** |
|
57 auskommentiert oder die Zeile wird einfach aus der *vmm.cfg* entfernt. |
|
58 |
|
59 Eine minimale *vmm.cfg* könnte so aussehen:: |
|
60 |
|
61 [database] |
|
62 user = ich |
|
63 pass = xxxxxxxx |
|
64 |
|
65 [config] |
|
66 done = true |
57 |
67 |
58 SUCHREIHENFOLGE |
68 SUCHREIHENFOLGE |
59 --------------- |
69 --------------- |
60 Standardmäßig sucht **vmm**\(1) die *vmm.cfg* in folgenden Verzeichnissen, |
70 Standardmäßig sucht **vmm**\(1) die *vmm.cfg* in folgenden Verzeichnissen, |
61 in der angegebenen Reihenfolge: |
71 in der angegebenen Reihenfolge: |
64 | */usr/local/etc* |
74 | */usr/local/etc* |
65 | */etc* |
75 | */etc* |
66 |
76 |
67 Die zuerst gefundene Datei wird verwendet. |
77 Die zuerst gefundene Datei wird verwendet. |
68 |
78 |
69 ABSCHNITTE |
79 SEKTIONEN |
70 ========== |
80 ========= |
71 Im Folgenden werden die Abschnitte der *vmm.cfg* und deren Optionen |
81 Im Folgenden werden die Sektionen der *vmm.cfg* und deren Optionen |
72 beschrieben. |
82 beschrieben. |
73 |
83 |
74 ACCOUNT |
84 ACCOUNT |
75 ------- |
85 ------- |
76 Die Optionen des Abschnitts **account** legen Konto-spezifische |
86 Die Optionen der Sektion **account** legen Konto-spezifische |
77 Einstellungen fest. |
87 Einstellungen fest. |
78 |
88 |
79 ``delete_directory (Vorgabe: false)`` : *Boolean* |
89 ``delete_directory (Vorgabe: false)`` : *Boolean* |
80 Bestimmt das Verhalten von **vmm**\(1) beim Löschen eines Kontos. |
90 Bestimmt das Verhalten von **vmm**\(1) beim Löschen eines Kontos. |
81 Wenn der Wert dieser Option *true* ist, wird das Home-Verzeichnis des |
91 Wenn der Wert dieser Option *true* ist, wird das Home-Verzeichnis des |
138 imap = true |
148 imap = true |
139 sieve = true |
149 sieve = true |
140 |
150 |
141 BIN |
151 BIN |
142 --- |
152 --- |
143 Im **bin**-Abschnitt werden Pfade zu Binaries angegeben, die von |
153 In der **bin**-Sektion werden die Pfade zu den von **vmm**\(1) benötigten |
144 **vmm**\(1) benötigt werden. |
154 Binaries angegeben. |
145 |
155 |
146 ``dovecotpw (Vorgabe: /usr/sbin/dovecotpw)`` : *String* |
156 ``dovecotpw (Vorgabe: /usr/sbin/dovecotpw)`` : *String* |
147 Der absolute Pfad zum dovecotpw Binary. Dieses Binary wird zur |
157 Der absolute Pfad zum dovecotpw Binary. Dieses Binary wird zur |
148 Hash-Erzeugung verwendet, wenn **misc.password_scheme** einen der |
158 Hash-Erzeugung verwendet, wenn **misc.password_scheme** einen der |
149 nachfolgenden Werte hat: 'SMD5', 'SSHA', 'CRAM-MD5', 'HMAC-MD5', |
159 nachfolgenden Werte hat: 'SMD5', 'SSHA', 'CRAM-MD5', 'HMAC-MD5', |
165 du = /usr/bin/du |
175 du = /usr/bin/du |
166 postconf = /usr/sbin/postconf |
176 postconf = /usr/sbin/postconf |
167 |
177 |
168 CONFIG |
178 CONFIG |
169 ------ |
179 ------ |
170 Beim **config**-Abschnitt handelt es sich um einen internen |
180 Bei der **config**-Sektion handelt es sich um einen internen |
171 Steuerungs-Abschnitt. |
181 Steuerungs-Sektion. |
172 |
182 |
173 ``done (Vorgabe: false)`` : *Boolean* |
183 ``done (Vorgabe: false)`` : *Boolean* |
174 Diese Option hat den Wert *false*, wenn **vmm**\(1) zum ersten Mal |
184 Diese Option hat den Wert *false*, wenn **vmm**\(1) zum ersten Mal |
175 installiert wurde. Wenn Sie die Datei *vmm.cfg* von Hand editieren, |
185 installiert wurde. Wenn Sie die Datei *vmm.cfg* von Hand editieren, |
176 weisen Sie dieser Option abschließend den Wert *true* zu. Wird die |
186 weisen Sie dieser Option abschließend den Wert *true* zu. Wird die |
185 [config] |
195 [config] |
186 done = true |
196 done = true |
187 |
197 |
188 DATABASE |
198 DATABASE |
189 -------- |
199 -------- |
190 Der **database**-Abschnitt wird verwendet, um die für den Datenbankzugriff |
200 Die **database**-Sektion wird verwendet, um die für den Datenbankzugriff |
191 benötigten Optionen festzulegen. |
201 benötigten Optionen festzulegen. |
192 |
202 |
193 ``host (Vorgabe: localhost)`` : *String* |
203 ``host (Vorgabe: localhost)`` : *String* |
194 Der Hostname oder die IP-Adresse des Datenbank-Servers. |
204 Der Hostname oder die IP-Adresse des Datenbank-Servers. |
195 |
205 |
210 pass = PY_SRJ}L/0p-oOk |
220 pass = PY_SRJ}L/0p-oOk |
211 name = mailsys |
221 name = mailsys |
212 |
222 |
213 DOMAIN |
223 DOMAIN |
214 ------ |
224 ------ |
215 Im **domain**-Abschnitt werden Domain-spezifische Informationen konfiguriert. |
225 In der **domain**-Sektion werden Domain-spezifische Informationen |
|
226 konfiguriert. |
216 |
227 |
217 ``auto_postmaster (Vorgabe: true)`` : *Boolean* |
228 ``auto_postmaster (Vorgabe: true)`` : *Boolean* |
218 Ist der Wert dieser Option *true*, wird **vmm**\(1) beim Anlegen einer |
229 Ist der Wert dieser Option *true*, wird **vmm**\(1) beim Anlegen einer |
219 Domain automatisch einen postmaster-Account erstellen. |
230 Domain automatisch einen postmaster-Account erstellen. |
220 |
231 |
240 directory_mode = 504 |
251 directory_mode = 504 |
241 force_deletion = false |
252 force_deletion = false |
242 |
253 |
243 MAILDIR |
254 MAILDIR |
244 ------- |
255 ------- |
245 Im **maildir**-Abschnitt werden die für die Maildirs erforderlichen Optionen |
256 In der **maildir**-Sektion werden die für die Maildirs erforderlichen |
246 festgelegt. |
257 Optionen festgelegt. |
247 |
258 |
248 ``folders (Vorgabe: Drafts:Sent:Templates:Trash)`` : *String* |
259 ``folders (Vorgabe: Drafts:Sent:Templates:Trash)`` : *String* |
249 Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die |
260 Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die |
250 innerhalb des Maildirs erstellt werden sollen. Sollen innerhalb des |
261 innerhalb des Maildirs erstellt werden sollen. Sollen innerhalb des |
251 Maildirs keine Verzeichnisse angelegt werden, ist dieser Optionen ein |
262 Maildirs keine Verzeichnisse angelegt werden, ist dieser Optionen ein |
264 folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix |
275 folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix |
265 name = Maildir |
276 name = Maildir |
266 |
277 |
267 MISC |
278 MISC |
268 ---- |
279 ---- |
269 Im **misc**-Abschnitt werden verschiedene Einstellungen festgelegt. |
280 In der **misc**-Sektion werden verschiedene Einstellungen festgelegt. |
270 |
281 |
271 ``base_directory (Vorgabe: /srv/mail)`` : *String* |
282 ``base_directory (Vorgabe: /srv/mail)`` : *String* |
272 Alle Domain-Verzeichnisse werden innerhalb dieses Basis-Verzeichnisses |
283 Alle Domain-Verzeichnisse werden innerhalb dieses Basis-Verzeichnisses |
273 angelegt. |
284 angelegt. |
274 |
285 |
292 |
303 |
293 Beispiel:: |
304 Beispiel:: |
294 |
305 |
295 [misc] |
306 [misc] |
296 base_directory = /srv/mail |
307 base_directory = /srv/mail |
297 password_scheme = CRAM-MD5 |
308 password_scheme = PLAIN |
298 gid_mail = 8 |
309 gid_mail = 8 |
299 transport = dovecot: |
310 transport = dovecot: |
300 dovecot_version = 11 |
311 dovecot_version = 11 |
301 |
312 |
302 DATEIEN |
313 DATEIEN |