man/de/man5/vmm.cfg.5
changeset 571 a4aead244f75
parent 554 a93671970617
child 588 dcde0010cdf8
equal deleted inserted replaced
465:c0e1fb1b0145 571:a4aead244f75
     1 .TH vmm.cfg 5 "17 Aug 2009" "Pascal Volk"
     1 .TH "VMM.CFG" "5" "2011-11-12" "vmm 0.6" "vmm"
     2 .SH NAME
     2 .SH NAME
     3 vmm.cfg \- Konfigurationsdatei für vmm
     3 vmm.cfg \- Konfigurationsdatei für vmm
     4 .SH SYNOPSIS
     4 .\" -----------------------------------------------------------------------
       
     5 .SH ÜBERSICHT
     5 vmm.cfg
     6 vmm.cfg
       
     7 .\" -----------------------------------------------------------------------
     6 .SH BESCHREIBUNG
     8 .SH BESCHREIBUNG
     7 \fBvmm\fR(1) liest Konfigurationsparameter aus der Datei \fIvmm.cfg\fP.
     9 .BR vmm (1)
     8 .br
    10 liest seine Konfigurationsparameter aus der Datei
     9 Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt
    11 .IR vmm.cfg .
    10 wird mit dem, in eckigen Klammern '[' und ']' eingefassten, Namen des Abschnitts
    12 .PP
    11 eingeleitet (z. B. \fB[database]\fP), gefolgt von \'Option = Wert\' Einträgen
    13 Die Konfigurationsdatei ist in mehrere Sektionen unterteilt.
    12 (Z. B. \fBhost = 127.0.0.1\fP).
    14 Jede Sektion wird mit dem in eckigen Klammern
    13 .br
    15 .RB ' [ "' und '" ] '
    14 Leerräume um das Gleichheitszeichen '=' und am Ende eine Wertes werden
    16 eingefassten Namen der Sektion eingeleitet, gefolgt von
       
    17 .RI ' Option " = " Wert '
       
    18 Einträgen.
       
    19 .PP
       
    20 Leerräume um das Gleichheitszeichen '=' und am Ende eines Wertes werden
    15 ignoriert.
    21 ignoriert.
    16 .PP
       
    17 Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden
    22 Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden
    18 ignoriert.
    23 ignoriert.
    19 .PP
    24 .PP
    20 Jeder Wert ist von einem der folgenden Datentypen:
    25 Jeder Wert ist von einem der folgenden Datentypen:
    21 .IP \(bu
    26 .PP
    22 .I Boolean
    27 .TP 8
    23 um zu bestimmen, ob etwas eingeschaltet/aktiviert (true) oder
    28 .I Boolean
       
    29 um festzulegen, ob etwas eingeschaltet/aktiviert (true) oder
    24 ausgeschaltet/deaktiviert (false) ist.
    30 ausgeschaltet/deaktiviert (false) ist.
    25 .br
    31 .br
    26 Mögliche Werte für \fBtrue\fP sind: \fB1\fP, \fByes\fP, \fBtrue\fP und \fBon\fP.
    32 Mögliche Werte für
       
    33 .I true
       
    34 sind:
       
    35 .BR 1 , " yes" , " true" " und " on .
    27 .br
    36 .br
    28 Mögliche Werte für \fBfalse\fP sind: \fB0\fP, \fBno\fP, \fBfalse\fP und
    37 Mögliche Werte für
    29 \fBoff\fP.
    38 .I false
    30 .IP \(bu
    39 sind:
    31 .I Int
    40 .BR 0 , " no" , " false" " und " off .
    32 eine Integer-Zahl, geschrieben ohne eine gebrochene oder dezimale Komponente.
    41 .TP
       
    42 .I Int
       
    43 eine Integer\-Zahl, geschrieben ohne eine gebrochene oder dezimale
       
    44 Komponente.
    33 .br
    45 .br
    34 Beispielsweise sind \fB1\fP, \fB50\fP oder \fB321\fP Integer-Zahlen.
    46 Beispielsweise
    35 .IP \(bu
    47 .BR 1 , " 50" " oder " 321
       
    48 sind Integer\-Zahlen.
       
    49 .TP
    36 .I String
    50 .I String
    37 eine Folge von Buchstaben und Zahlen.
    51 eine Folge von Buchstaben und Zahlen.
    38 .br
    52 .br
    39 Zum Beispiel: '\fBWort\fP', '\fBHallo Welt\fP', oder '\fB/usr/bin/strings\fP'
    53 Zum Beispiel:
    40 .SS SUCHREIHENFOLGE
    54 .RB ' Wort "', '" "Hallo Welt" "' oder '" /usr/bin/strings '
    41 Standardmäßig sucht vmm die \fIvmm.cfg\fP in folgenden Verzeichnissen, in dieser
    55 .PP
    42 Reihenfolge:
    56 Die meisten Optionen haben einen Vorgabewert.
       
    57 Dieser ist nach dem Namen der Option in Klammern angegebenen.
       
    58 Um den Vorgabewert einer Option zu verwenden, wird die entsprechende Zeile
       
    59 entweder mit
       
    60 .BR # " oder " ;
       
    61 auskommentiert oder die Zeile wird einfach aus der
       
    62 .I vmm.cfg
       
    63 entfernt.
       
    64 .PP
       
    65 Eine minimale
       
    66 .I vmm.cfg
       
    67 könnte so aussehen:
       
    68 .PP
       
    69 .nf
       
    70 [database]
       
    71 user = ich
       
    72 pass = xxxxxxxx
       
    73 
       
    74 [misc]
       
    75 dovecot_version = 1.2.16
       
    76 .fi
       
    77 .\" -----------------------------------------------------------------------
       
    78 .SH SUCHREIHENFOLGE
       
    79 Standardmäßig sucht
       
    80 .BR vmm (1)
       
    81 die
       
    82 .I vmm.cfg
       
    83 in folgenden Verzeichnissen, in der angegebenen Reihenfolge:
    43 .RS
    84 .RS
    44 .PD 0
    85 .PD 0
    45 .TP
    86 .TP
    46 .I
    87 .I
    47 /root
    88 /root
    53 /etc
    94 /etc
    54 .PD
    95 .PD
    55 .RE
    96 .RE
    56 .PP
    97 .PP
    57 Die zuerst gefundene Datei wird verwendet.
    98 Die zuerst gefundene Datei wird verwendet.
    58 .\" -----
    99 .\" -----------------------------------------------------------------------
    59 .SH DATABASE ABSCHNITT
   100 .SH SEKTION ACCOUNT
    60 Der \fBdatabase\fP-Abschnitt wird verwendet, um die für den Datenbankzugriff
   101 Die Optionen der Sektion
    61 benötigten Optionen festzulegen.
   102 .B account
    62 .TP
   103 legen Konto\-spezifische Einstellungen fest.
    63 \fBhost\fP (\fIString\fP)
   104 .SS account.delete_directory
    64 Der Hostname oder die IP-Adresse des Datenbank-Servers.
   105 .BR delete_directory " (Vorgabe: false) :"
    65 .TP
   106 .I Boolean
    66 \fBuser\fP (\fIString\fP)
   107 .PP
    67 Der Name des Datenbank-Benutzers.
   108 Bestimmt das Verhalten von
    68 .TP
   109 .BR vmm (1)
    69 \fBpass\fP (\fIString\fP)
   110 beim Löschen eines Kontos (userdelete).
    70 Das Passwort des Datenbank-Benutzers
   111 Wenn der Wert dieser Option
    71 .TP
   112 .I true
    72 \fBname\fP (\fIString\fP)
   113 ist, wird das Home\-Verzeichnis des zu löschenden Anwenders rekursiv
    73 Name der zu verwendenden Datenbank.
   114 gelöscht.
    74 .TP
   115 .\" ------------------------------------
    75 \fBBeispiel\fP:
   116 .SS account.directory_mode
       
   117 .BR directory_mode " (Vorgabe: 448) :"
       
   118 .I Int
       
   119 .PP
       
   120 Zugriffsbits des Home\-Verzeichnisses, sowie aller enthaltenen
       
   121 Verzeichnisse, in Dezimal\-Schreibweise (Basis 10).
       
   122 .br
       
   123 Beispiel: 'drwx\-\-\-\-\-\-' \(-> oktal 0700 \(-> dezimal 448
       
   124 .\" ------------------------------------
       
   125 .SS account.disk_usage
       
   126 .BR disk_usage " (Vorgabe: false) :"
       
   127 .I Boolean
       
   128 .PP
       
   129 Legt fest, ob die Festplattenbelegung des Maildirs eines Benutzers jedes
       
   130 Mal mit
       
   131 .BR du (1)
       
   132 ermittelt und mit den Konto\-Informationen ausgegeben werden soll.
       
   133 .PP
       
   134 Bei umfangreichen Maildirs kann das langsam sein.
       
   135 Falls Sie Quotas aktiviert haben, wird der
       
   136 .BR vmm\-Unterbefehl
       
   137 userinfo ebenfalls die aktuelle Quota\-Nutzung des Kontos mit ausgegeben.
       
   138 Sie können auch eines der optionalen Argumente
       
   139 .BR du " oder " full
       
   140 an userinfo übergeben, um sich die aktuelle Festplattenbelegung anzeigen zu
       
   141 lassen.
       
   142 .\" ------------------------------------
       
   143 .SS account.password_length
       
   144 .BR password_length " (Vorgabe: 8) :"
       
   145 .I Int
       
   146 .PP
       
   147 Diese Option legt die Anzahl der Zeichen für automatisch erzeugte
       
   148 Passwörter fest.
       
   149 Alle Werte kleiner als 8 werden auf 8 erhöht.
       
   150 .\" ------------------------------------
       
   151 .SS account.random_password
       
   152 .BR random_password " (Vorgabe: false) :"
       
   153 .I Boolean
       
   154 .PP
       
   155 Mit dieser Option wird bestimmt, ob
       
   156 .BR vmm (1)
       
   157 ein zufälliges Passwort generieren soll, wenn kein Passwort an den
       
   158 Unterbefehl useradd übergeben wurde.
       
   159 Ist der Wert dieser Option
       
   160 .IR false ,
       
   161 wird
       
   162 .B vmm
       
   163 Sie auffordern, ein Passwort für den neuen Account einzugeben.
       
   164 .PP
       
   165 Sie können die Länge für automatisch generierte Passwörter mit der Option
       
   166 .I account.password_length
       
   167 konfigurieren.
       
   168 .\" -----------------------------------------------------------------------
       
   169 .SH SEKTION BIN
       
   170 In der
       
   171 .BR bin \-Sektion
       
   172 werden die Pfade zu den von
       
   173 .BR vmm (1)
       
   174 benötigten Binaries angegeben.
       
   175 .SS bin.dovecotpw
       
   176 .BR dovecotpw " (Vorgabe: /usr/sbin/dovecotpw) :"
       
   177 .I String
       
   178 .PP
       
   179 Der absolute Pfad zum dovecotpw Binary.
       
   180 Geben Sie den absoluten Pfad zum
       
   181 .BR doveadm (1)
       
   182 Binary an, falls Sie Dovecot v2.0 verwenden.
       
   183 .PP
       
   184 Dieses Binary wird zur Hash\-Erzeugung verwendet, wenn
       
   185 .I misc.password_scheme
       
   186 einen der nachfolgenden Werte hat: 'CRAM\-MD5', 'HMAC\-MD5', 'LANMAN',
       
   187 \(aqOTP', 'RPA' oder 'SKEY'.
       
   188 Dieses Binary wird auch benötigt, wenn Ihre Python\-Installation einen der
       
   189 folgenden Hash\-Algorithmen nicht unterstützt:
       
   190 .IP \(bu 4
       
   191 md4: (hashlib + OpenSSL oder PyCrypto) verwendet für die Passwort\-Schemen:
       
   192 \(aqPLAIN\-MD4' und 'NTLM'
       
   193 .IP \(bu
       
   194 sha256: (hashlib oder PyCrypto \(>= 2.1.0alpha1) verwendet für die
       
   195 Passwort\-Schemen: 'SHA256' und 'SSHA256'
       
   196 .IP \(bu
       
   197 sha512: (hashlib) verwendet für die Passwort\-Schemen: 'SHA512' und
       
   198 \(aqSSHA512'
       
   199 .PP
       
   200 Das
       
   201 .BR doveadm (1)
       
   202 Binary wird auch gebraucht, um die INBOX und zusätzliche Mailboxen
       
   203 .RI ( mailbox.folders )
       
   204 für einen neuen Account zu erstellen, wenn die Option
       
   205 .I mailbox.format
       
   206 den Wert
       
   207 .BR mdbox " oder " sdbox
       
   208 hat.
       
   209 .\" ------------------------------------
       
   210 .SS bin.du
       
   211 .BR du " (Vorgabe: /usr/bin/du) :"
       
   212 .I String
       
   213 .PP
       
   214 Der absolute Pfad zu
       
   215 .BR du (1).
       
   216 Dieses Binary wird verwendet, wenn die Festplattenbelegung eines Kontos
       
   217 ermittelt wird.
       
   218 .\" ------------------------------------
       
   219 .SS bin.postconf
       
   220 .BR postconf " (Vorgabe: /usr/sbin/postconf) :"
       
   221 .I String
       
   222 .PP
       
   223 Der absolute Pfad zu Postfix'
       
   224 .BR postconf (1).
       
   225 Dieses Binary wird verwendet, wenn
       
   226 .BR vmm (1)
       
   227 diverse Postfix\-Einstellungen prüft, zum Beispiel das
       
   228 .IR virtual_alias_expansion_limit .
       
   229 .\" -----------------------------------------------------------------------
       
   230 .SH SEKTION DATABASE
       
   231 Die
       
   232 .BR database \-Sektion
       
   233 wird verwendet, um die für den Datenbankzugriff erforderlichen Optionen
       
   234 festzulegen.
       
   235 .SS database.host
       
   236 .BR host " (Vorgabe: localhost) :"
       
   237 .I String
       
   238 .PP
       
   239 Der Hostname oder die IP\-Adresse des Datenbankservers.
       
   240 .\" ------------------------------------
       
   241 .SS database.module
       
   242 .BR module " (Vorgabe: psycopg2) :"
       
   243 .I String
       
   244 .PP
       
   245 Das für den Datenbankzugriff zu verwendende Python PostgreSQL Adapter
       
   246 Modul.
       
   247 Unterstützte Module sind
       
   248 .BR psycopg2 " und " pyPgSQL .
       
   249 .\" ------------------------------------
       
   250 .SS database.name
       
   251 .BR name " (Vorgabe: mailsys) :"
       
   252 .I String
       
   253 .PP
       
   254 Der Name der zu verwendenden Datenbank.
       
   255 .\" ------------------------------------
       
   256 .SS database.pass
       
   257 .BR pass " (Vorgabe: " None ") :"
       
   258 .I String
       
   259 .PP
       
   260 Das Passwort des Datenbank\-Benutzers.
       
   261 .\" ------------------------------------
       
   262 .SS database.port
       
   263 .BR port " (Vorgabe: 5432) :"
       
   264 .I Int
       
   265 .PP
       
   266 Der TCP\-Port, auf dem der Datenbankserver Verbindungen annimmt.
       
   267 .\" ------------------------------------
       
   268 .SS database.sslmode
       
   269 .BR sslmode " (Vorgabe: prefer) :"
       
   270 .I String
       
   271 .PP
       
   272 Bestimmt, ob und mit welcher Priorität eine SSL\-Verbindung mit dem
       
   273 Datenbankserver ausgehandelt wird.
       
   274 Mögliche Werte sind:
       
   275 .BR disabled ", " allow ", " prefer ", " require ", " verify\-ca " und "
       
   276 .BR verify\-full .
       
   277 Die Modi
       
   278 .BR verify\-ca " und " verify\-full
       
   279 stehen seit PostgreSQL 8.4 zur Verfügung.
       
   280 .PP
       
   281 Diese Option wird ignoriert, wenn das
       
   282 .I database.module
       
   283 .B pyPgSQL
       
   284 verwendet wird.
       
   285 .\" ------------------------------------
       
   286 .SS database.user
       
   287 .BR user " (Vorgabe: " None ") :"
       
   288 .I String
       
   289 .PP
       
   290 Der Name des Datenbank\-Benutzers.
       
   291 .\" -----------------------------------------------------------------------
       
   292 .SH SEKTION DOMAIN
       
   293 In der
       
   294 .BR domain \-Sektion
       
   295 werden Domain\-spezifische Einstellungen hinterlegt.
       
   296 .PP
       
   297 Das Quota\-Limit (quota_bytes und quota_messages), Service\-Einstellungen
       
   298 (imap,  pop3, sieve und smtp) und der Transport werden angewendet, wenn
       
   299 eine Domain angelegt wird.
       
   300 Um die Einstellungen einer vorhandenen Domain zu ändern, verwenden Sie
       
   301 einen der folgenden
       
   302 .BR vmm (1)
       
   303 Unterbefehle:
       
   304 .PP
       
   305 .TP
       
   306 .B domainquota
       
   307 um das Quota\-Limit einer Domain zu ändern
       
   308 .TP
       
   309 .B domainservices
       
   310 um einer Domain einen abweichenden Satz von nutzbaren Services zuzuweisen
       
   311 .TP
       
   312 .B domaintransport
       
   313 um einen neuen Vorgabe\-Transport für eine Domain festzulegen
       
   314 .PP
       
   315 Wenn ein Account angelegt wird, erbt er alle Einstellungen von der Domain,
       
   316 zu der er hinzugefügt wird.
       
   317 Abweichende Einstellungen für einen vorhandenen Account nehmen Sie mit
       
   318 einem der Unterbefehle
       
   319 .BR userquota ", " userservices " und " usertransport
       
   320 vor.
       
   321 .\" ------------------------------------
       
   322 .SS domain.auto_postmaster
       
   323 .BR auto_postmaster " (Vorgabe: true) :"
       
   324 .I Boolean
       
   325 .PP
       
   326 Ist der Wert dieser Option
       
   327 .IR true ,
       
   328 wird
       
   329 .BR vmm (1)
       
   330 beim Anlegen einer Domain (domainadd) automatisch einen postmaster\-Account
       
   331 erstellen.
       
   332 .\" ------------------------------------
       
   333 .SS domain.delete_directory
       
   334 .BR delete_directory " (Vorgabe: false) :"
       
   335 .I Boolean
       
   336 .PP
       
   337 Legt fest, ob beim Löschen einer Domain (domaindelete) das Verzeichnis der
       
   338 zu löschenden Domain, inklusive aller Anwender\-Verzeichnisse, rekursiv
       
   339 gelöscht werden soll.
       
   340 .\" ------------------------------------
       
   341 .SS domain.directory_mode
       
   342 .BR directory_mode " (Vorgabe: 504) :"
       
   343 .I Int
       
   344 .PP
       
   345 Zugriffsbits des Domain\-Verzeichnisses in Dezimal\-Schreibweise
       
   346 (Basis 10).
       
   347 .br
       
   348 Beispiel: 'drwxrwx\-\-\-' \(-> oktal 0770 \(-> dezimal 504
       
   349 .\" ------------------------------------
       
   350 .SS domain.force_deletion
       
   351 .BR force_deletion " (Vorgabe: false) :"
       
   352 .I Boolean
       
   353 .PP
       
   354 Erzwingt das Löschen aller zugeordneten Konten und Aliase beim Löschen
       
   355 einer Domain (domaindelete).
       
   356 .\" ------------------------------------
       
   357 .SS domain.imap
       
   358 .BR imap " (Vorgabe: true) :"
       
   359 .I Boolean
       
   360 .PP
       
   361 Legt fest, ob sich neu angelegte Benutzer per IMAP anmelden können sollen.
       
   362 .\" ------------------------------------
       
   363 .SS domain.pop3
       
   364 .BR pop3 " (Vorgabe: true) :"
       
   365 .I Boolean
       
   366 .PP
       
   367 Legt fest, ob sich neu angelegte Benutzer per POP3 anmelden können sollen.
       
   368 .\" ------------------------------------
       
   369 .SS domain.quota_bytes
       
   370 .BR quota_bytes " (Vorgabe: 0) :"
       
   371 .I String
       
   372 .PP
       
   373 Quota Limit in Bytes.
       
   374 0 bedeutet unbegrenzt.
       
   375 Dieses Limit wird beim Anlegen von Domains angewendet.
       
   376 .PP
       
   377 Der Wert dieser Option kann als Integer\-Wert, zum Beispiel
       
   378 .B 20480
       
   379 geschrieben werden.
       
   380 Es ist auch möglich dem Wert eines der folgenden
       
   381 Suffixe anzuhängen:
       
   382 .BR b " (Bytes), " k " (Kilobytes), " M " (Megabytes) oder " G
       
   383 (Gigabytes).
       
   384 .br
       
   385 1024 entspricht 1024b oder 1k.
       
   386 .\" ------------------------------------
       
   387 .SS domain.quota_messages
       
   388 .BR quota_messages " (Vorgabe: 0) :"
       
   389 .I Int
       
   390 .PP
       
   391 Quota Limit als Anzahl von Nachrichten.
       
   392 0 bedeutet unbegrenzt.
       
   393 Dieses Limit wird beim Anlegen neuer Domains angewendet.
       
   394 .\" ------------------------------------
       
   395 .SS domain.sieve
       
   396 .BR sieve " (Vorgabe: true) :"
       
   397 .I Boolean
       
   398 .PP
       
   399 Legt fest, ob sich neu angelegte Benutzer per SIEVE (ManageSieve) anmelden
       
   400 können sollen.
       
   401 .\" ------------------------------------
       
   402 .SS domain.smtp
       
   403 .BR smtp " (Vorgabe: true) :"
       
   404 .I Boolean
       
   405 .PP
       
   406 Legt fest, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmelden
       
   407 können sollen.
       
   408 .\" ------------------------------------
       
   409 .SS domain.transport
       
   410 .BR transport " (Vorgabe: dovecot:) :"
       
   411 .I String
       
   412 .PP
       
   413 Der Standard\-Transport aller neuen Domains.
       
   414 Siehe auch:
       
   415 .BR transport (5).
       
   416 .\" -----------------------------------------------------------------------
       
   417 .SH SEKTION MAILBOX
       
   418 In der
       
   419 .BR mailbox \-Sektion
       
   420 werden die für die Erstellung von Mailboxen erforderlichen Optionen
       
   421 festgelegt.
       
   422 Die INBOX wird in jedem Fall erstellt.
       
   423 .SS mailbox.folders
       
   424 .BR folders " (Vorgabe: Drafts:Sent:Templates:Trash) :"
       
   425 .I String
       
   426 .PP
       
   427 Eine durch Doppelpunkte getrennte Liste mit Namen der zu erstellenden
       
   428 Mailboxen.
       
   429 Sollen keine zusätzlichen Mailboxen angelegt werden, ist dieser Option ein
       
   430 einzelner Doppelpunkt
       
   431 .RB (' : ')
       
   432 als Wert zuzuweisen.
       
   433 .PP
       
   434 Sollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist ein
       
   435 einzelner Punkt
       
   436 .RB (' . ')
       
   437 als Separator zu verwenden.
       
   438 .PP
       
   439 Sollen Mailboxen mit internationalisierten Namen erstellt werden (zum
       
   440 Beispiel: 'Wysłane' oder 'Gelöschte Objekte'), ist der Name UTF\-8 kodiert
       
   441 anzugeben.
       
   442 .BR vmm (1)
       
   443 wird die internationalisierten Mailboxnamen in eine modifizierten Variante
       
   444 des UTF\-7\-Zeichensatzes (siehe auch: RFC 3501, Sektion 5.1.3)
       
   445 konvertieren.
       
   446 .\" ------------------------------------
       
   447 .SS mailbox.format
       
   448 .BR format " (Vorgabe: maildir) :"
       
   449 .I String
       
   450 .PP
       
   451 Das zu verwendende Mailbox\-Format für die Mailboxen der Benutzer.
       
   452 Abhängig von der verwendeten Dovecot\-Version
       
   453 .RI ( misc.dovecot_version ),
       
   454 unterstützt
       
   455 .BR vmm (1)
       
   456 bis zu drei Formate:
       
   457 .TP 8
       
   458 .B maildir
       
   459 Dovecot \(>= v1.0.0
       
   460 .TP
       
   461 .B mdbox
       
   462 Dovecot \(>= v2.0.beta5
       
   463 .TP
       
   464 .B sdbox
       
   465 Dovecot \(>= v2.0.rc3
       
   466 .\" ------------------------------------
       
   467 .SS mailbox.root
       
   468 .BR root " (Vorgabe: Maildir) :"
       
   469 .I String
       
   470 .PP
       
   471 Name des Mailbox\-Wurzelverzeichnisses im Home\-Verzeichnis des jeweiligen
       
   472 Benutzers.
       
   473 Übliche Namen, je nach verwendetem
       
   474 .IR mailbox.format ,
       
   475 sind
       
   476 .BR Maildir ", " mdbox " or " sdbox .
       
   477 .\" ------------------------------------
       
   478 .SS mailbox.subscribe
       
   479 .BR subscribe " (Vorgabe: true) :"
       
   480 .I Boolean
       
   481 .PP
       
   482 Wenn dieser Option der Wert
       
   483 .B true
       
   484 zugewiesen wurde, werden die, gemäß
       
   485 .IR mailbox.folders ,
       
   486 erstellen Mailboxen in der subscriptions\-Datei des Benutzers gelistet.
       
   487 Sollen die erstellen Mailboxen nicht nicht in der subscriptions\-Datei
       
   488 gelistet werden, weisen Sie dieser Option den Wert
       
   489 .B false
       
   490 zu.
       
   491 .\" -----------------------------------------------------------------------
       
   492 .SH SEKTION MISC
       
   493 In der
       
   494 .BR misc \-Sektion
       
   495 werden Einstellungen für verschiedene Bereiche festgelegt.
       
   496 .SS misc.base_directory
       
   497 .BR base_directory " (Vorgabe: /srv/mail) :"
       
   498 .I String
       
   499 .PP
       
   500 Alle Domain\-Verzeichnisse werden innerhalb dieses Basis\-Verzeichnisses
       
   501 angelegt.
       
   502 .\" ------------------------------------
       
   503 .SS misc.crypt_blowfish_rounds
       
   504 .BR crypt_blowfish_rounds " (Vorgabe: 5) :"
       
   505 .I Int
       
   506 .PP
       
   507 Anzahl der Verschlüsselungsdurchgänge für das
       
   508 .I password_scheme
       
   509 .BR BLF\-CRYPT .
       
   510 .PP
       
   511 Der Wert muss im Bereich von
       
   512 .BR 4 " \- " 31
       
   513 liegen.
       
   514 .\" ------------------------------------
       
   515 .SS misc.crypt_sha256_rounds
       
   516 .BR crypt_sha256_rounds " (Vorgabe: 5000) :"
       
   517 .I Int
       
   518 .PP
       
   519 Anzahl der Verschlüsselungdurchgänge für das
       
   520 .I password_scheme
       
   521 .BR SHA256\-CRYPT .
       
   522 .PP
       
   523 Der Wert muss im Bereich von
       
   524 .BR 1000 " \- " 999999999
       
   525 liegen.
       
   526 .\" ------------------------------------
       
   527 .SS misc.crypt_sha512_rounds
       
   528 .BR crypt_sha512_rounds " (Vorgabe: 5000) :"
       
   529 .I Int
       
   530 .PP
       
   531 Anzahl der Verschlüsselungdurchgänge für das
       
   532 .I password_scheme
       
   533 .BR SHA512\-CRYPT .
       
   534 .PP
       
   535 Der Wert muss im Bereich von
       
   536 .BR 1000 " \- " 999999999
       
   537 liegen.
       
   538 .\" ------------------------------------
       
   539 .SS misc.dovecot_version
       
   540 .BR dovecot_version " (Vorgabe: " None ") :"
       
   541 .I String
       
   542 .PP
       
   543 Die aktuell eingesetzte Dovecot\-Version.
       
   544 (siehe:
       
   545 .BR "dovecot \-\-version" ).
       
   546 
       
   547 Wenn das Kommando
       
   548 .B dovecot \-\-version
       
   549 zum Beispiel
       
   550 .I 2.0.beta4 (8818db00d347)
       
   551 ausgibt, ist dieser Option der Wert
       
   552 .B 2.0.beta4
       
   553 zuzuweisen.
       
   554 .\" ------------------------------------
       
   555 .SS misc.password_scheme
       
   556 .BR password_scheme " (Vorgabe: CRAM\-MD5) :"
       
   557 .I String
       
   558 .PP
       
   559 Das zu verwendende Passwort\-Schema.
       
   560 Um eine Liste aller verwendbaren Passwort\-Schemen zu erhalten, führen Sie
       
   561 das Kommando
       
   562 .B vmm lp
       
   563 aus.
       
   564 .PP
       
   565 Seit Dovecot \(>= v1.1.alpha1 ist es möglich, dem
       
   566 .I password_scheme
       
   567 ein Encoding\-Suffix anzufügen.
       
   568 Unterstützte Encoding\-Suffixe:
       
   569 .BR .b64 ", " .base64 " und " .hex .
       
   570 Beispiel: PLAIN.BASE64
       
   571 .\" -----------------------------------------------------------------------
       
   572 .SH BEISPIEL
       
   573 Eine Beispiel\-Konfiguration.
       
   574 Alle Optionen, die nicht in der Konfigurationsdatei gelistet sind, haben
       
   575 ihren Vorgabewert.
       
   576 .PP
       
   577 .nf
       
   578 [account]
       
   579 password_length = 10
       
   580 random_password = true
       
   581 
       
   582 [bin]
       
   583 dovecotpw = /usr/bin/doveadm
       
   584 
    76 [database]
   585 [database]
    77 .br
   586 host = dbsrv8.example.net
    78 host = localhost
   587 pass = PY_SRJ}L/0p\-oOk
    79 .br
   588 port = 5433
       
   589 sslmode = require
    80 user = vmm
   590 user = vmm
    81 .br
   591 
    82 pass = T~_:L4OYyl]TU?)
   592 [domain]
    83 .br
   593 quota_bytes = 500M
    84 name = mailsys
   594 quota_messages = 10000
    85 .\" -----
   595 transport = lmtp:unix:private/dovecot\-lmtp
    86 .SH MAILDIR ABSCHNITT
   596 
    87 Im \fBmaildir\fP-Abschnitt werden die für die Maildirs erforderlichen Optionen
   597 [mailbox]
    88 festgelegt.
   598 folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
    89 .TP
   599 
    90 \fBname\fP (\fIString\fP)
       
    91 Standard-Name des Maildir-Verzeichnisses im Verzeichnis des jeweiligen
       
    92 Anwenders.
       
    93 .TP
       
    94 \fBfolders\fP (\fIString\fP)
       
    95 Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die innerhalb des
       
    96 Maildirs erstellt werden sollen.
       
    97 .br
       
    98 Sollen innerhalb des Maildirs keine Verzeichnisse angelegt werden, ist dieser
       
    99 Optionen ein einzelner Doppelpunkt (':') als Wert zuzuweisen.
       
   100 .TP
       
   101 \fBmode\fP (\fIInt\fP)
       
   102 Zugriffsbits des Maildirs in Dezimal-Schreibweise (Basis 10).
       
   103 .br
       
   104 Beispiel: \'drwx------' -> oktal 0700 -> dezimal 448
       
   105 .TP
       
   106 \fBdiskusage\fP (\fIBoolean\fP)
       
   107 Legt fest, ob die Festplattenbelegung des Maildirs jedes Mal, wenn
       
   108 Konto-Informationen ausgegeben werden, ermittelt und mit ausgegeben werden
       
   109 sollen.
       
   110 .TP
       
   111 \fBdelete\fP (\fIBoolean\fP)
       
   112 Bestimmt, ob das Maildir rekursiv gelöscht werden soll, wenn ein Konto gelöscht
       
   113 wird.
       
   114 .TP
       
   115 \fBBeispiel\fP:
       
   116 [maildir]
       
   117 .br
       
   118 name = Maildir
       
   119 .br
       
   120 folders = Drafts:Sent:Templates:Trash:INBOX.News
       
   121 .br
       
   122 mode = 448
       
   123 .br
       
   124 diskusage = false
       
   125 .br
       
   126 delete = false
       
   127 .\" -----
       
   128 .SH SERVICES ABSCHNITT
       
   129 Im \fBservices\fP-Abschnitt werden die Standard-Beschränkungen für alle Konten
       
   130 festgelegt.
       
   131 .TP
       
   132 \fBsmtp\fP (\fIBoolean\fP)
       
   133 Legt fest, ob sich ein Anwender standardmäßig per SMTP einloggen kann.
       
   134 .TP
       
   135 \fBpop3\fP (\fIBoolean\fP)
       
   136 Legt fest, ob sich ein Anwender standardmäßig per POP3 einloggen kann.
       
   137 .TP
       
   138 \fBimap\fP (\fIBoolean\fP)
       
   139 Legt fest, ob sich ein Anwender standardmäßig per IMAP einloggen kann.
       
   140 .TP
       
   141 \fBsieve\fP (\fIBoolean\fP)
       
   142 Legt fest, ob sich ein Anwender standardmäßig per MANAGESIEVE einloggen kann.
       
   143 .TP
       
   144 \fBBeispiel\fP:
       
   145 [services]
       
   146 .br
       
   147 smtp = true
       
   148 .br
       
   149 pop3 = true
       
   150 .br
       
   151 imap = false
       
   152 .br
       
   153 sieve = false
       
   154 .\" -----
       
   155 .SH DOMDIR ABSCHNITT
       
   156 Im \fBdomdir\fP-Abschnitt werden die Optionen der Domain-Verzeichnisse bestimmt.
       
   157 .TP
       
   158 \fBbase\fP (\fIString\fP)
       
   159 Alle Domain-Verzeichnisse werden unterhalb dieses Basis-Verzeichnisses angelegt.
       
   160 .TP
       
   161 \fBmode\fP (\fIInt\fP)
       
   162 Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis 10).
       
   163 .br
       
   164 Beispiel: 'drwxrwx---' -> oktal 0770 -> dezimal 504
       
   165 .TP
       
   166 \fBdelete\fP (\fIBoolean\fP)
       
   167 Bestimmt, ob beim Löschen einer Domain das Verzeichnis einer Domain, inklusive
       
   168 aller Anwender-Verzeichnisse, rekursiv gelöscht werden soll.
       
   169 .TP
       
   170 \fBBeispiel\fP:
       
   171 [domdir]
       
   172 .br
       
   173 base = /srv/mail
       
   174 .br
       
   175 mode = 504
       
   176 .br
       
   177 delete = false
       
   178 .\" -----
       
   179 .SH BIN ABSCHNITT
       
   180 Der \fBbin\fP-Abschnitt wird verwendet, um Pfade zu Binaries, die von \fBvmm\fP
       
   181 benötigt werden, anzugeben.
       
   182 .TP
       
   183 \fBdovecotpw\fP (\fIString\fP)
       
   184 Der absolute Pfad zum dovecotpw-Binary. Dieses wird verwendet, wenn als
       
   185 Passwort-Schema eines der folgenden verwendet wird: 'SMD5', 'SSHA', 'CRAM-MD5',
       
   186 \'HMAC-MD5', 'LANMAN', 'NTLM' oder 'RPA'.
       
   187 .TP
       
   188 \fBdu\fP (\fIString\fP)
       
   189 Der absolute Pfad zu \fBdu\fR(1). Dieses Binary wird verwendet, wenn die
       
   190 Festplattenbelegung eines Kontos ermittelt wird.
       
   191 .TP
       
   192 \fBpostconf\fP (\fIString\fP)
       
   193 Der absolute Pfad zu Postfix' \fBpostconf\fR(1).
       
   194 .br
       
   195 Dieses Binary wird verwendet, wenn \fBvmm\fR(1) diverse Postfix-Einstellungen
       
   196 prüft, zum Beispiel virtual_alias_expansion_limit.
       
   197 .TP
       
   198 \fBBeispiel\fP:
       
   199 [bin]
       
   200 .br
       
   201 dovecotpw = /usr/sbin/dovecotpw
       
   202 .br
       
   203 du = /usr/bin/du
       
   204 .br
       
   205 postconf = /usr/sbin/postconf
       
   206 .\" -----
       
   207 .SH MISC ABSCHNITT
       
   208 Im \fBmisc\fP-Abschnitt werden verschiedene Einstellungen festgelegt.
       
   209 .TP
       
   210 \fBpasswdscheme\fP (\fIString\fP)
       
   211 Das zu verwendende Passwort-Schema (siehe auch: dovecotpw -l)
       
   212 .TP
       
   213 \fBgid_mail\fP (\fIInt\fP)
       
   214 Die numerische Gruppen-ID der Gruppe mail, bzw. der Gruppe aus
       
   215 mail_privileged_group der Datei dovecot.conf.
       
   216 .TP
       
   217 \fBforcedel\fP (\fIBoolean\fP)
       
   218 Legt fest, ob beim Löschen einer Domain alle vorhanden Konten und/oder Aliase,
       
   219 ohne Nachfrage, gelöscht werden sollen.
       
   220 .TP
       
   221 \fBtransport\fP (\fIString\fP)
       
   222 Der Standard-Transport aller Domains und Konten.
       
   223 .TP
       
   224 \fBdovecotvers\fP (\fIInt\fP)
       
   225 Die verketteten Major- und Minor-Teile der eingesetzten Dovecot-Version
       
   226 (siehe: dovecot --version).
       
   227 .br
       
   228 Diese Option beeinflusst diverse Datenbankzugriffe. Da es zwischen Dovecot
       
   229 v1.1.x und v1.2.x einige Änderungen gab. Zum Beispiel \fB11\fP, falls
       
   230 \fBdovecot --version\fP den Wert \fB1.1\fP.18 ausgibt.
       
   231 .TP
       
   232 \fBBeispiel\fP:
       
   233 [misc]
   600 [misc]
   234 .br
   601 crypt_sha512_rounds = 10000
   235 passwdscheme = CRAM-MD5
   602 dovecot_version = 2.0.beta4
   236 .br
   603 password_scheme = SHA512\-CRYPT.hex
   237 gid_mail = 8
   604 .fi
   238 .br
   605 .\" -----------------------------------------------------------------------
   239 forcedel = false
       
   240 .br
       
   241 transport = dovecot:
       
   242 .br
       
   243 dovecotvers = 11
       
   244 .\" -----
       
   245 .SH CONFIG ABSCHNITT
       
   246 Beim \fBconfig\fP-Abschnitt handelt es sich um einen internen
       
   247 Steuerungs-Abschnitt.
       
   248 .TP
       
   249 \fBdone\fP (\fIBoolean\fP)
       
   250 Diese Option hat den den Wert \fIfalse\fP, wenn vmm zum ersten Mal installiert
       
   251 wurde. Wenn die Datei \fIvmm.cfg\fP von Hand editiert wird, weisen Sie dieser
       
   252 Option abschließend den Wert \fItrue\fP zu.
       
   253 .br
       
   254 Wird die Konfiguration über das Kommando \fBvmm configure\fP angepasst, wird der
       
   255 Wert dieser Option automatisch auf \fItrue\fP gesetzt.
       
   256 .br
       
   257 Sollte diese Option den Wert \fIfalse\fP zugewiesen haben, so startet \fBvmm\fP
       
   258 beim nächsten Aufruf im interaktiven Konfigurations-Modus.
       
   259 .TP
       
   260 \fBBeispiel\fP:
       
   261 [config]
       
   262 .br
       
   263 done = true
       
   264 .\" -----
       
   265 .SH DATEIEN
       
   266 vmm.cfg
       
   267 .SH SIEHE AUCH
   606 .SH SIEHE AUCH
   268 vmm(1), Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase
   607 .BR postconf (1),
   269 zu verwalten.
   608 .BR vmm (1),
   270 .SH AUTOR
   609 .BR transport (5)
   271 \fBvmm\fP und die dazugehörigen Manualseiten wurden von Pascal Volk
   610 .\" -----------------------------------------------------------------------
   272 <\fIneverseen@users.sourceforge.net\fP> geschrieben und sind unter den
   611 .SH INTERNET RESSOURCEN
   273 Bedingungen der BSD Lizenz lizenziert.
   612 .TP
       
   613 Wiki
       
   614 http://de.vmm.localdomain.org/
       
   615 .TP
       
   616 Projekt\-Seite
       
   617 http://sf.net/projects/vmm/
       
   618 .TP
       
   619 Bugtracker
       
   620 https://bitbucket.org/pvo/vmm/issues
       
   621 .\" -----------------------------------------------------------------------
       
   622 .SH COPYING
       
   623 vmm und die dazugehörigen Manualseiten wurden von Pascal Volk <user+vmm AT
       
   624 localhost.localdomain.org> geschrieben und sind unter den Bedingungen der
       
   625 BSD Lizenz lizenziert.