|
1 .\" $Id$ |
|
2 .TH vmm.cfg 5 "11. Jun 2008" "Pascal Volk" |
|
3 .SH NAME |
|
4 vmm.cfg \- Konfigurationsdatei für vmm |
|
5 .SH SYNOPSIS |
|
6 /usr/local/etc/vmm.cfg |
|
7 .SH BESCHREIBUNG |
|
8 \fBvmm\fR(1) liest Konfigurationsparameter aus der Datei |
|
9 \fI/usr/local/etc/vmm.cfg\fP. |
|
10 .br |
|
11 Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt |
|
12 wird mit dem, in eckigen Klammern '[' und ']' eingefassten, Namen des Abschnitts |
|
13 eingeleitet (z. B. \fB[database]\fP), gefolgt von \'Option = Wert\' Einträgen |
|
14 (Z. B. \fBhost = 127.0.0.1\fP). |
|
15 .br |
|
16 Leerräume um das Gleichheitszeichen '=' und am Ende eine Wertes werden |
|
17 ignoriert. |
|
18 .PP |
|
19 Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden |
|
20 ignoriert. |
|
21 .PP |
|
22 Jeder Wert ist von einem der folgenden Datentypen: |
|
23 .IP \(bu |
|
24 .I Boolean |
|
25 um zu bestimmen, ob etwas eingeschaltet/aktiviert (true) oder |
|
26 ausgeschaltet/deaktiviert (false) ist. |
|
27 .br |
|
28 Mögliche Werte für \fBtrue\fP sind: \fB1\fP, \fByes\fP, \fBtrue\fP und \fBon\fP. |
|
29 .br |
|
30 Mögliche Werte für \fBfalse\fP sind: \fB0\fP, \fBno\fP, \fBfalse\fP und |
|
31 \fBoff\fP. |
|
32 .IP \(bu |
|
33 .I Int |
|
34 eine Integer-Zahl, geschrieben ohne eine gebrochene oder dezimale Komponente. |
|
35 .br |
|
36 Beispielsweise sind \fB1\fP, \fB50\fP oder \fB321\fP Integer-Zahlen. |
|
37 .IP \(bu |
|
38 .I String |
|
39 eine Folge von Buchstaben und Zahlen. |
|
40 .br |
|
41 Zum Beispiel: '\fBWort\fP', '\fBHallo Welt\fP', oder '\fB/usr/bin/strings\fP' |
|
42 .\" ----- |
|
43 .SH DATABASE ABSCHNITT |
|
44 Der \fBdatabase\fP-Abschnitt wird verwendet, um die für den Datenbankzugriff |
|
45 benötigten Optionen festzulegen. |
|
46 .TP |
|
47 \fBhost\fP (\fIString\fP) |
|
48 Der Hostname oder die IP-Adresse des Datenbank-Servers. |
|
49 .TP |
|
50 \fBuser\fP (\fIString\fP) |
|
51 Der Name des Datenbank-Benutzers. |
|
52 .TP |
|
53 \fBpass\fP (\fIString\fP) |
|
54 Das Passwort des Datenbank-Benutzers |
|
55 .TP |
|
56 \fBname\fP (\fIString\fP) |
|
57 Name der zu verwendenden Datenbank. |
|
58 .TP |
|
59 \fBBeispiel\fP: |
|
60 [database] |
|
61 .br |
|
62 host = localhost |
|
63 .br |
|
64 user = vmm |
|
65 .br |
|
66 pass = T~_:L4OYyl]TU?) |
|
67 .br |
|
68 name = mailsys |
|
69 .\" ----- |
|
70 .SH MAILDIR ABSCHNITT |
|
71 Im \fBmaildir\fP-Abschnitt werden die für die Maildirs erforderlichen Optionen |
|
72 festgelegt. |
|
73 .TP |
|
74 \fBfolder\fP (\fIString\fP) |
|
75 Standard-Name des Maildir-Verzeichnisses im Verzeichnis des jeweiligen |
|
76 Anwenders. |
|
77 .TP |
|
78 \fBmode\fP (\fIInt\fP) |
|
79 Zugriffsbits des Maildirs in Dezimal-Schreibweise (Basis 10). |
|
80 .br |
|
81 Beispiel: \'drwx------' -> oktal 0700 -> dezimal 448 |
|
82 .TP |
|
83 \fBdiskusage\fP (\fIBoolean\fP) |
|
84 Legt fest, ob die Festplattenbelegung des Maildirs jedes Mal, wenn |
|
85 Konto-Informationen ausgegeben werden, ermittelt und mit ausgegeben werden |
|
86 sollen. |
|
87 .TP |
|
88 \fBdelete\fP (\fIBoolean\fP) |
|
89 Bestimmt, ob das Maildir rekursiv gelöscht werden soll, wenn ein Konto gelöscht |
|
90 wird. |
|
91 .TP |
|
92 \fBBeispiel\fP: |
|
93 [maildir] |
|
94 .br |
|
95 folder = Maildir |
|
96 .br |
|
97 mode = 448 |
|
98 .br |
|
99 diskusage = false |
|
100 .br |
|
101 delete = false |
|
102 .\" ----- |
|
103 .SH SERVICES ABSCHNITT |
|
104 Im \fBservices\fP-Abschnitt werden die Standard-Beschränkungen für alle Konten |
|
105 festgelegt. |
|
106 .TP |
|
107 \fBsmtp\fP (\fIBoolean\fP) |
|
108 Legt fest, ob sich ein Anwender standardmäßig per SMTP einloggen kann. |
|
109 .TP |
|
110 \fBpop3\fP (\fIBoolean\fP) |
|
111 Legt fest, ob sich ein Anwender standardmäßig per POP3 einloggen kann. |
|
112 .TP |
|
113 \fBimap\fP (\fIBoolean\fP) |
|
114 Legt fest, ob sich ein Anwender standardmäßig per IMAP einloggen kann. |
|
115 .TP |
|
116 \fBmanagesieve\fP (\fIBoolean\fP) |
|
117 Legt fest, ob sich ein Anwender standardmäßig per MANAGESIEVE einloggen kann. |
|
118 .TP |
|
119 \fBBeispiel\fP: |
|
120 [services] |
|
121 .br |
|
122 smtp = true |
|
123 .br |
|
124 pop3 = true |
|
125 .br |
|
126 imap = false |
|
127 .br |
|
128 managesieve = false |
|
129 .\" ----- |
|
130 .SH DOMDIR ABSCHNITT |
|
131 Im \fBdomdir\fP-Abschnitt werden die Optionen der Domain-Verzeichnisse bestimmt. |
|
132 .TP |
|
133 \fBbase\fP (\fIString\fP) |
|
134 Alle Domain-Verzeichnisse werden unterhalb dieses Basis-Verzeichnisses angelegt. |
|
135 .TP |
|
136 \fBmode\fP (\fIInt\fP) |
|
137 Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis 10). |
|
138 .br |
|
139 Beispiel: 'drwxrwx---' -> oktal 0770 -> dezimal 504 |
|
140 .TP |
|
141 \fBdelete\fP (\fIBoolean\fP) |
|
142 Bestimmt ob beim Löschen einer Domain das Verzeichnis einer Domain, inklusive |
|
143 aller Anwender-Verzeichnisse, rekursiv gelöscht werden soll. |
|
144 .TP |
|
145 \fBBeispiel\fP: |
|
146 [domdir] |
|
147 .br |
|
148 base = /srv/mail |
|
149 .br |
|
150 mode = 504 |
|
151 .br |
|
152 delete = false |
|
153 .\" ----- |
|
154 .SH BIN ABSCHNITT |
|
155 Der \fBbin\fP-Abschnitt wird verwendet, um Pfade zu Binaries, die von \fBvmm\fP |
|
156 benötigt werden, anzugeben. |
|
157 .TP |
|
158 \fBdovecotpw\fP (\fIString\fP) |
|
159 Der absolute Pfad zum dovecotpw-Binary. Diese wird verwendet, wenn als |
|
160 Passwort-Schema eines der folgenden verwendet wird: 'SMD5', 'SSHA', 'CRAM-MD5', |
|
161 \'HMAC-MD5', 'LANMAN', 'NTLM' oder 'RPA'. |
|
162 .TP |
|
163 \fBdu\fP (\fIString\fP) |
|
164 Der absolute Pfad zu \fBdu\fR(1). Diese Binary wird verwendet, wenn die |
|
165 Festplattenbelegung eines Kontos ermittelt wird. |
|
166 .TP |
|
167 \fBBeispiel\fP: |
|
168 [bin] |
|
169 .br |
|
170 dovecotpw = /usr/sbin/dovecotpw |
|
171 .br |
|
172 du = /usr/bin/du |
|
173 .\" ----- |
|
174 .SH MISC ABSCHNITT |
|
175 Im \fBmisc\fP-Abschnitt werden verschiedene Einstellungen festgelegt. |
|
176 .TP |
|
177 \fBpasswdscheme\fP (\fIString\fP) |
|
178 Das zu verwende Passwort-Schema (siehe auch: dovecotpw -l) |
|
179 .TP |
|
180 \fBgid_mail\fP (\fIInt\fP) |
|
181 Die numerische Gruppen-ID der Gruppe mail, bzw. der Gruppe aus |
|
182 mail_privileged_group der Datei dovecot.conf. |
|
183 .TP |
|
184 \fBforcedel\fP (\fIBoolean\fP) |
|
185 Legt fest, ob beim Löschen einer Domain alle vorhanden Konten und/oder Aliase, |
|
186 ohne Nachfrage, gelöscht werden sollen. |
|
187 .TP |
|
188 \fBtransport\fP (\fIString\fP) |
|
189 Der Standard-Transport aller Domains und Konten. |
|
190 .TP |
|
191 \fBBeispiel\fP: |
|
192 [misc] |
|
193 .br |
|
194 passwdscheme = CRAM-MD5 |
|
195 .br |
|
196 gid_mail = 8 |
|
197 .br |
|
198 forcedel = false |
|
199 .br |
|
200 transport = dovecot: |
|
201 .\" ----- |
|
202 .SH CONFIG ABSCHNITT |
|
203 Beim \fBconfig\fP-Abschnitt handelt es sich um einen internen |
|
204 Steuerungs-Abschnitt. |
|
205 .TP |
|
206 \fBdone\fP (\fIBoolean\fP) |
|
207 Diese Option hat den den Wert \fIfalse\fP, wenn vmm zum ersten Mal installiert |
|
208 wurde. Wenn die Datei \fIvmm.cfg\fP von Hand editiert wird, weißen Sie dieser |
|
209 Option abschließend den Wert \fItrue\fP zu. |
|
210 .br |
|
211 Wird die Konfiguration über das Kommando \fBvmm configure\fP angepasst, wird der |
|
212 Wert dieser Option automatisch auf \fItrue\fP gesetzt. |
|
213 .br |
|
214 Sollte diese Option den Wert \fIfalse\fP zugewiesen haben, so startet \fBvmm\fP |
|
215 beim nächsten Aufruf im interaktiven Konfigurations-Modus. |
|
216 .TP |
|
217 \fBBeispiel\fP: |
|
218 [config] |
|
219 .br |
|
220 done = true |
|
221 .\" ----- |
|
222 .SH DATEIEN |
|
223 /usr/local/etc/vmm.cfg |
|
224 .SH SIEHE AUCH |
|
225 vmm(1), Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase |
|
226 zu verwalten. |
|
227 .SH AUTOR |
|
228 \fBvmm\fP und die dazugehörigen Manualseiten wurden von Pascal Volk |
|
229 <\fIp.volk@veb-it.de\fP> geschrieben und sind unter den Bedingungen der BSD |
|
230 Lizenz lizenziert. |