man/de/man5/vmm.cfg.5
branchv0.6.x
changeset 433 c2543ddde9f5
parent 170 d9ca5c46c1fa
child 460 e57dd007d69a
--- a/man/de/man5/vmm.cfg.5	Tue Oct 25 15:36:38 2011 +0000
+++ b/man/de/man5/vmm.cfg.5	Wed Oct 26 03:20:40 2011 +0000
@@ -1,458 +1,602 @@
-.\" Man page generated from reStructeredText.
-.
-.TH VMM.CFG 5 "2010-01-18" "vmm-0.6.0" "vmm Manual"
+.TH "VMM.CFG" "5" "2011-10-26" "vmm 0.6" "vmm"
 .SH NAME
 vmm.cfg \- Konfigurationsdatei für vmm
-.
-.nr rst2man-indent-level 0
-.
-.de1 rstReportMargin
-\\$1 \\n[an-margin]
-level \\n[rst2man-indent-level]
-level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
--
-\\n[rst2man-indent0]
-\\n[rst2man-indent1]
-\\n[rst2man-indent2]
-..
-.de1 INDENT
-.\" .rstReportMargin pre:
-. RS \\$1
-. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
-. nr rst2man-indent-level +1
-.\" .rstReportMargin post:
-..
-.de UNINDENT
-. RE
-.\" indent \\n[an-margin]
-.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.nr rst2man-indent-level -1
-.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
-..
-.SH SYNOPSIS
-.sp
+.\" -----------------------------------------------------------------------
+.SH ÜBERSICHT
 vmm.cfg
+.\" -----------------------------------------------------------------------
 .SH BESCHREIBUNG
-.sp
-\fBvmm\fP(1) liest seine Konfigurationsparameter aus der Datei \fIvmm.cfg\fP.
-.sp
-Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt
-wird mit dem, in eckigen Klammern \(aq\fB[\fP\(aq und \(aq\fB]\fP\(aq eingefassten, Namen des
-Abschnitts eingeleitet, gefolgt von \(aq\fIOption\fP = \fIWert\fP\(aq Einträgen:
-.sp
-.nf
-.ft C
-[database]
-host = 127.0.0.1
-.ft P
-.fi
-.sp
-Leerräume um das Gleichheitszeichen \(aq=\(aq und am Ende eines Wertes werden
+.BR vmm (1)
+liest seine Konfigurationsparameter aus der Datei
+.IR vmm.cfg .
+.PP
+Die Konfigurationsdatei ist in mehrere Sektionen unterteilt.
+Jede Sektion wird mit dem in eckigen Klammern
+.RB ' [ "' und '" ] '
+eingefassten Namen der Sektion eingeleitet, gefolgt von
+.RI ' Option " = " Wert '
+Einträgen.
+.PP
+Leerräume um das Gleichheitszeichen '=' und am Ende eines Wertes werden
 ignoriert.
-.sp
-Leerzeilen und Zeilen, die mit einer \(aq#\(aq oder einem \(aq;\(aq anfangen, werden
+Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden
 ignoriert.
-.sp
+.PP
 Jeder Wert ist von einem der folgenden Datentypen:
-.INDENT 0.0
-.IP \(bu 2
-.
-\fIBoolean\fP um zu bestimmen, ob etwas eingeschaltet/aktiviert (true) oder
+.PP
+.TP 8
+.I Boolean
+um festzulegen, ob etwas eingeschaltet/aktiviert (true) oder
 ausgeschaltet/deaktiviert (false) ist.
-.nf
-Mögliche Werte für \fItrue\fP sind: \fB1\fP, \fByes\fP, \fBtrue\fP und \fBon\fP.
-Mögliche Werte für \fIfalse\fP sind: \fB0\fP, \fBno\fP, \fBfalse\fP und \fBoff\fP.
-.fi
-.sp
-.IP \(bu 2
-.
-\fIInt\fP eine Integer\-Zahl, geschrieben ohne eine gebrochene oder dezimale
+.br
+Mögliche Werte für
+.I true
+sind:
+.BR 1 , " yes" , " true" " und " on .
+.br
+Mögliche Werte für
+.I false
+sind:
+.BR 0 , " no" , " false" " und " off .
+.TP
+.I Int
+eine Integer\-Zahl, geschrieben ohne eine gebrochene oder dezimale
 Komponente.
-.nf
-Beispielsweise \fB1\fP, \fB50\fP oder \fB321\fP sind Integer\-Zahlen.
-.fi
-.sp
-.IP \(bu 2
-.
-\fIString\fP eine Folge von Buchstaben und Zahlen.
-.nf
-Zum Beispiel: \(aq\fBWort\fP\(aq, \(aq\fBHallo Welt\fP\(aq oder \(aq\fB/usr/bin/strings\fP\(aq
-.fi
-.sp
-.UNINDENT
-.SS SUCHREIHENFOLGE
-.sp
-Standardmäßig sucht \fBvmm\fP(1) die \fIvmm.cfg\fP in folgenden Verzeichnissen,
-in der angegebenen Reihenfolge:
-.INDENT 0.0
-.INDENT 3.5
+.br
+Beispielsweise
+.BR 1 , " 50" " oder " 321
+sind Integer\-Zahlen.
+.TP
+.I String
+eine Folge von Buchstaben und Zahlen.
+.br
+Zum Beispiel:
+.RB ' Wort "', '" "Hallo Welt" "' oder '" /usr/bin/strings '
+.PP
+Die meisten Optionen haben einen Vorgabewert.
+Dieser ist nach dem Namen der Option in Klammern angegebenen.
+Um den Vorgabewert einer Option zu verwenden, wird die entsprechende Zeile
+entweder mit
+.BR # " oder " ;
+auskommentiert oder die Zeile wird einfach aus der
+.I vmm.cfg
+entfernt.
+.PP
+Eine minimale
+.I vmm.cfg
+könnte so aussehen:
+.PP
 .nf
-\fI/root\fP
-\fI/usr/local/etc\fP
-\fI/etc\fP
+[database]
+user = ich
+pass = xxxxxxxx
+
+[misc]
+dovecot_version = 1.2.16
 .fi
-.sp
-.UNINDENT
-.UNINDENT
-.sp
+.\" -----------------------------------------------------------------------
+.SH SUCHREIHENFOLGE
+Standardmäßig sucht
+.BR vmm (1)
+die
+.I vmm.cfg
+in folgenden Verzeichnissen, in der angegebenen Reihenfolge:
+.RS
+.PD 0
+.TP
+.I
+/root
+.TP
+.I
+/usr/local/etc
+.TP
+.I
+/etc
+.PD
+.RE
+.PP
 Die zuerst gefundene Datei wird verwendet.
-.SH ABSCHNITTE
-.sp
-Im Folgenden werden die Abschnitte der \fIvmm.cfg\fP und deren Optionen
-beschrieben.
-.SS ACCOUNT
-.sp
-Die Optionen des Abschnitts \fBaccount\fP legen Konto\-spezifische
-Einstellungen fest.
-.INDENT 0.0
-.TP
-.B \fCdelete_directory\fP
-\fIBoolean\fP
-.sp
-Bestimmt das Verhalten von \fBvmm\fP(1) beim Löschen eines Kontos.
-Wenn der Wert dieser Option \fItrue\fP ist, wird das Home\-Verzeichnis des
-zu löschenden Anwenders rekursiv gelöscht.
-.TP
-.B \fCdirectory_mode\fP
-\fIInt\fP
-.sp
+.\" -----------------------------------------------------------------------
+.SH SEKTION ACCOUNT
+Die Optionen der Sektion
+.B account
+legen Konto\-spezifische Einstellungen fest.
+.SS account.delete_directory
+.BR delete_directory " (Vorgabe: false) :"
+.I Boolean
+.PP
+Bestimmt das Verhalten von
+.BR vmm (1)
+beim Löschen eines Kontos (userdelete).
+Wenn der Wert dieser Option
+.I true
+ist, wird das Home\-Verzeichnis des zu löschenden Anwenders rekursiv
+gelöscht.
+.\" ------------------------------------
+.SS account.directory_mode
+.BR directory_mode " (Vorgabe: 448) :"
+.I Int
+.PP
 Zugriffsbits des Home\-Verzeichnisses, sowie aller enthaltenen
 Verzeichnisse, in Dezimal\-Schreibweise (Basis 10).
-.nf
-Beispiel: \(aqdrwx\-\-\-\-\-\-\(aq \-> oktal 0700 \-> dezimal 448
-.fi
-.sp
-.TP
-.B \fCdisk_usage\fP
-\fIBoolean\fP
-.sp
+.br
+Beispiel: 'drwx\-\-\-\-\-\-' \(-> oktal 0700 \(-> dezimal 448
+.\" ------------------------------------
+.SS account.disk_usage
+.BR disk_usage " (Vorgabe: false) :"
+.I Boolean
+.PP
 Legt fest, ob die Festplattenbelegung des Maildirs eines Benutzers jedes
-Mal mit \fBdu\fP(1) ermittelt und mit den Konto\-Informationen ausgegeben
-werden soll.
-.sp
-Bei umfangreichen Maildirs kann das langsam sein. Falls Sie Quotas
-aktiviert haben, wird der \fBvmm\fP\-Unterbefehl \fBuserinfo\fP ebenfalls
-die aktuelle Quota\-Nutzung des Kontos mit ausgegeben. Sie können auch
-eines der optionalen Argumente \fBdu\fP oder \fBfull\fP an \fBuserinfo\fP
-übergeben, um sich die aktuelle Festplattenbelegung anzeigen zu lassen.
-.TP
-.B \fCimap\fP
-\fIBoolean\fP
-.sp
-Bestimmt, ob sich neu angelegte Benutzer per IMAP anmelden können sollen.
-.TP
-.B \fCpassword_length\fP
-\fIInt\fP
-.sp
+Mal mit
+.BR du (1)
+ermittelt und mit den Konto\-Informationen ausgegeben werden soll.
+.PP
+Bei umfangreichen Maildirs kann das langsam sein.
+Falls Sie Quotas aktiviert haben, wird der
+.BR vmm -Unterbefehl
+userinfo ebenfalls die aktuelle Quota\-Nutzung des Kontos mit ausgegeben.
+Sie können auch eines der optionalen Argumente
+.BR du " oder " full
+an userinfo übergeben, um sich die aktuelle Festplattenbelegung anzeigen zu
+lassen.
+.\" ------------------------------------
+.SS account.imap
+.BR imap " (Vorgabe: true) :"
+.I Boolean
+.PP
+Legt fest, ob sich neu angelegte Benutzer per IMAP anmelden können sollen.
+.\" ------------------------------------
+.SS account.password_length
+.BR password_length " (Vorgabe: 8) :"
+.I Int
+.PP
 Diese Option legt die Anzahl der Zeichen für automatisch erzeugte
-Passwörter fest. Alle Werte kleiner als 8 werden auf 8 erhöht.
-.TP
-.B \fCpop3\fP
-.sp
-Bestimmt, ob sich neu angelegte Benutzer per POP3 anmelden können sollen.
-.TP
-.B \fCrandom_password\fP
-\fIBoolean\fP
-.sp
-Mit dieser Option wird bestimmt , ob \fBvmm\fP(1) ein zufälliges Passwort
-generieren soll, wenn kein Passwort an den \fBuseradd\fP Unterbefehl
-übergeben wurde. Ist der Wert dieser Option \fIfalse\fP, wird \fBvmm\fP Sie
-auffordern, ein Passwort für den neun Account einzugeben.
-.sp
-Sie können die Länge für automatisch generierte Passwörter mit der
-Option \fBpassword_length\fP konfigurieren.
-.TP
-.B \fCsieve\fP
-\fIBoolean\fP
-.sp
-Bestimmt, ob sich neu angelegte Benutzer per ManageSieve anmelden
-können sollen.
-.TP
-.B \fCsmtp\fP
-\fIBoolean\fP
-.sp
-Bestimmt, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmelden
+Passwörter fest.
+Alle Werte kleiner als 8 werden auf 8 erhöht.
+.\" ------------------------------------
+.SS account.pop3
+.BR pop3 " (Vorgabe: true) :"
+.I Boolean
+.PP
+Legt fest, ob sich neu angelegte Benutzer per POP3 anmelden können sollen.
+.\" ------------------------------------
+.SS account.random_password
+.BR random_password " (Vorgabe: false) :"
+.I Boolean
+.PP
+Mit dieser Option wird bestimmt, ob
+.BR vmm (1)
+ein zufälliges Passwort generieren soll, wenn kein Passwort an den
+Unterbefehl useradd übergeben wurde.
+Ist der Wert dieser Option
+.IR false ,
+wird
+.B vmm
+Sie auffordern, ein Passwort für den neuen Account einzugeben.
+.PP
+Sie können die Länge für automatisch generierte Passwörter mit der Option
+.I account.password_length
+konfigurieren.
+.\" ------------------------------------
+.SS account.sieve
+.BR sieve " (Vorgabe: true) :"
+.I Boolean
+.PP
+Legt fest, ob sich neu angelegte Benutzer per ManageSieve anmelden können
+sollen.
+.\" ------------------------------------
+.SS account.smtp
+.BR smtp " (Vorgabe: true) :"
+.I Boolean
+.PP
+Legt fest, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmelden
 können sollen.
-.UNINDENT
-.sp
-Beispiel:
-.sp
-.nf
-.ft C
-[account]
-delete_directory = false
-directory_mode = 448
-disk_usage = false
-random_password = true
-password_length = 10
-smtp = true
-pop3 = true
-imap = true
-sieve = true
-.ft P
-.fi
-.SS BIN
-.sp
-Im \fBbin\fP\-Abschnitt werden Pfade zu Binaries angegeben, die von
-\fBvmm\fP(1) benötigt werden.
-.INDENT 0.0
-.TP
-.B \fCdovecotpw\fP
-\fIString\fP
-.sp
-Der absolute Pfad zum dovecotpw Binary. Dieses Binary wird zur
-Hash\-Erzeugung verwendet, wenn \fBmisc.password_scheme\fP einen der
-nachfolgenden Werte hat: \(aqSMD5\(aq, \(aqSSHA\(aq, \(aqCRAM\-MD5\(aq, \(aqHMAC\-MD5\(aq,
-\(aqLANMAN\(aq, \(aqNTLM\(aq oder \(aqRPA\(aq.
-.TP
-.B \fCdu\fP
-\fIString\fP
-.sp
-Der absolute Pfad zu \fBdu\fP(1). Dieses Binary wird verwendet, wenn
-die Festplattenbelegung eines Kontos ermittelt wird.
-.TP
-.B \fCpostconf\fP
-\fIString\fP
-.sp
-Der absolute Pfad zu Postfix\(aq \fBpostconf\fP(1). Dieses Binary wird
-verwendet, wenn \fBvmm\fP(1) diverse Postfix\-Einstellungen prüft, zum
-Beispiel das \fIvirtual_alias_expansion_limit\fP.
-.UNINDENT
-.sp
-Beispiel:
-.sp
-.nf
-.ft C
-[bin]
-dovecotpw = /usr/sbin/dovecotpw
-du = /usr/bin/du
-postconf = /usr/sbin/postconf
-.ft P
-.fi
-.SS CONFIG
-.sp
-Beim \fBconfig\fP\-Abschnitt handelt es sich um einen internen
-Steuerungs\-Abschnitt.
-.INDENT 0.0
+.\" -----------------------------------------------------------------------
+.SH SEKTION BIN
+In der
+.BR bin \-Sektion
+werden die Pfade zu den von 
+.BR vmm (1)
+benötigten Binaries angegeben.
+.SS bin.dovecotpw
+.BR dovecotpw " (Vorgabe: /usr/sbin/dovecotpw) :"
+.I String
+.PP
+Der absolute Pfad zum dovecotpw Binary.
+Geben Sie den absoluten Pfad zum
+.BR doveadm (1)
+Binary an, falls Sie Dovecot v2.0 verwenden.
+.PP
+Dieses Binary wird zur Hash\-Erzeugung verwendet, wenn
+.I misc.password_scheme
+einen der nachfolgenden Werte hat: 'CRAM\-MD5', 'HMAC\-MD5', 'LANMAN',
+\(aqOTP', 'RPA' oder 'SKEY'.
+Dieses Binary wird auch benötigt, wenn Ihre Python\-Installation einen der
+folgenden Hash\-Algorithmen nicht unterstützt:
+.IP \(bu 4
+md4: (hashlib + OpenSSL oder PyCrypto) verwendet für die Passwort\-Schemen:
+\(aqPLAIN\-MD4' und 'NTLM'
+.IP \(bu
+sha256: (hashlib oder PyCrypto \(>= 2.1.0alpha1) verwendet für die
+Passwort\-Schemen: 'SHA256' und 'SSHA256'
+.IP \(bu
+sha512: (hashlib) verwendet für die Passwort\-Schemen: 'SHA512' und
+\(aqSSHA512'
+.PP
+Das
+.BR doveadm (1)
+Binary wird auch gebraucht, um die INBOX und zusätzliche Mailboxen
+.RI ( mailbox.folders )
+für einen neuen Account zu erstellen, wenn die Option
+.I mailbox.format
+den Wert
+.BR mdbox " oder " sdbox
+hat.
+.\" ------------------------------------
+.SS bin.du
+.BR du " (Vorgabe: /usr/bin/du) :"
+.I String
+.PP
+Der absolute Pfad zu
+.BR du (1).
+Dieses Binary wird verwendet, wenn die Festplattenbelegung eines Kontos
+ermittelt wird.
+.\" ------------------------------------
+.SS bin.postconf
+.BR postconf " (Vorgabe: /usr/sbin/postconf) :"
+.I String
+.PP
+Der absolute Pfad zu Postfix'
+.BR postconf (1).
+Dieses Binary wird verwendet, wenn
+.BR vmm (1)
+diverse Postfix\-Einstellungen prüft, zum Beispiel das
+.IR virtual_alias_expansion_limit .
+.\" -----------------------------------------------------------------------
+.SH SEKTION DATABASE
+Die
+.BR database \-Sektion
+wird verwendet, um die für den Datenbankzugriff erforderlichen Optionen
+festzulegen.
+.SS database.host
+.BR host " (Vorgabe: localhost) :"
+.I String
+.PP
+Der Hostname oder die IP\-Adresse des Datenbankservers.
+.\" ------------------------------------
+.SS database.module
+.BR module " (Vorgabe: psycopg2) :"
+.I String
+.PP
+Das für den Datenbankzugriff zu verwendende Python PostgreSQL Adapter
+Modul.
+Unterstützte Module sind
+.BR psycopg2 " und " pyPgSQL .
+.\" ------------------------------------
+.SS database.name
+.BR name " (Vorgabe: mailsys) :"
+.I String
+.PP
+Der Name der zu verwendenden Datenbank.
+.\" ------------------------------------
+.SS database.pass
+.BR pass " (Vorgabe: " None ") :"
+.I String
+.PP
+Das Passwort des Datenbank\-Benutzers.
+.\" ------------------------------------
+.SS database.port
+.BR port " (Vorgabe: 5432) :"
+.I Int
+.PP
+Der TCP\-Port, auf dem der Datenbankserver Verbindungen annimmt.
+.\" ------------------------------------
+.SS database.sslmode
+.BR sslmode " (Vorgabe: prefer) :"
+.I String
+.PP
+Bestimmt, ob und mit welcher Priorität eine SSL\-Verbindung mit dem
+Datenbankserver ausgehandelt wird.
+Mögliche Werte sind:
+.BR disabled ", " allow ", " prefer ", " require ", " verify\-ca " und "
+.BR verify\-full .
+Die Modi
+.BR verify\-ca " und " verify\-full
+stehen seit PostgreSQL 8.4 zur Verfügung.
+.PP
+Diese Option wird ignoriert, wenn das
+.I database.module
+.B pyPgSQL
+verwendet wird.
+.\" ------------------------------------
+.SS database.user
+.BR user " (Vorgabe: " None ") :"
+.I String
+.PP
+Der Name des Datenbank\-Benutzers.
+.\" -----------------------------------------------------------------------
+.SH SEKTION DOMAIN
+In der
+.BR domain \-Sektion
+werden Domain\-spezifische Einstellungen hinterlegt.
+.SS domain.auto_postmaster
+.BR auto_postmaster " (Vorgabe: true) :"
+.I Boolean
+.PP
+Ist der Wert dieser Option
+.IR true ,
+wird
+.BR vmm (1)
+beim Anlegen einer Domain (domainadd) automatisch einen postmaster\-Account
+erstellen.
+.\" ------------------------------------
+.SS domain.delete_directory
+.BR delete_directory " (Vorgabe: false) :"
+.I Boolean
+.PP
+Legt fest, ob beim Löschen einer Domain (domaindelete) das Verzeichnis der
+zu löschenden Domain, inklusive aller Anwender\-Verzeichnisse, rekursiv
+gelöscht werden soll.
+.\" ------------------------------------
+.SS domain.directory_mode
+.BR directory_mode " (Vorgabe: 504) :"
+.I Int
+.PP
+Zugriffsbits des Domain\-Verzeichnisses in Dezimal\-Schreibweise
+(Basis 10).
+.br
+Beispiel: 'drwxrwx\-\-\-' \(-> oktal 0770 \(-> dezimal 504
+.\" ------------------------------------
+.SS domain.force_deletion
+.BR force_deletion " (Vorgabe: false) :"
+.I Boolean
+.PP
+Erzwingt das Löschen aller zugeordneten Konten und Aliase beim Löschen
+einer Domain (domaindelete).
+.\" -----------------------------------------------------------------------
+.SH SEKTION MAILBOX
+In der
+.BR mailbox \-Sektion
+werden die für die Erstellung von Mailboxen erforderlichen Optionen
+festgelegt.
+Die INBOX wird in jedem Fall erstellt.
+.SS mailbox.folders
+.BR folders " (Vorgabe: Drafts:Sent:Templates:Trash) :"
+.I String
+.PP
+Eine durch Doppelpunkte getrennte Liste mit Namen der zu erstellenden
+Mailboxen.
+Sollen keine zusätzlichen Mailboxen angelegt werden, ist dieser Option ein
+einzelner Doppelpunkt
+.RB (' : ')
+als Wert zuzuweisen.
+.PP
+Sollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist ein
+einzelner Punkt
+.RB (' . ')
+als Separator zu verwenden.
+.PP
+Sollen Mailboxen mit internationalisierten Namen erstellt werden (zum
+Beispiel: 'Wysłane' oder 'Gelöschte Objekte'), ist der Name UTF\-8 kodiert
+anzugeben.
+.BR vmm (1)
+wird die internationalisierten Mailboxnamen in eine modifizierten Variante
+des UTF\-7\-Zeichensatzes (siehe auch: RFC 3501, Sektion 5.1.3)
+konvertieren.
+.\" ------------------------------------
+.SS mailbox.format
+.BR format " (Vorgabe: maildir) :"
+.I String
+.PP
+Das zu verwendende Mailbox\-Format für die Mailboxen der Benutzer.
+Abhängig von der verwendeten Dovecot\-Version
+.RI ( misc.dovecot_version ),
+unterstützt
+.BR vmm (1)
+bis zu drei Formate:
+.TP 8
+.B maildir
+Dovecot \(>= v1.0.0
 .TP
-.B \fCdone\fP
-\fIBoolean\fP
-.sp
-Diese Option hat den Wert \fIfalse\fP, wenn \fBvmm\fP(1) zum ersten Mal
-installiert wurde. Wenn Sie die Datei \fIvmm.cfg\fP von Hand editieren,
-weisen Sie dieser Option abschließend den Wert \fItrue\fP zu. Wird die
-Konfiguration über das Kommando \fBvmm configure\fP angepasst, wird der
-Wert dieser Option automatisch auf \fItrue\fP gesetzt.
-.sp
-Ist der Wert dieser Option  \fIfalse\fP, so startet \fBvmm\fP(1) beim
-nächsten Aufruf im interaktiven Konfigurations\-Modus.
-.UNINDENT
-.sp
-Beispiel:
-.sp
-.nf
-.ft C
-[config]
-done = true
-.ft P
-.fi
-.SS DATABASE
-.sp
-Der \fBdatabase\fP\-Abschnitt wird verwendet, um die für den Datenbankzugriff
-benötigten Optionen festzulegen.
-.INDENT 0.0
-.TP
-.B \fChost\fP
-\fIString\fP
-.sp
-Der Hostname oder die IP\-Adresse des Datenbank\-Servers.
-.TP
-.B \fCname\fP
-\fIString\fP
-.sp
-Der Name der zu verwendenden Datenbank.
-.TP
-.B \fCpass\fP
-\fIString\fP
-.sp
-Das Passwort des Datenbank\-Benutzers.
-.TP
-.B \fCuser\fP
-\fIString\fP
-.sp
-Der Name des Datenbank\-Benutzers.
-.UNINDENT
-.sp
-Beispiel:
-.sp
-.nf
-.ft C
-[database]
-host = localhost
-user = vmm
-pass = PY_SRJ}L/0p\-oOk
-name = mailsys
-.ft P
-.fi
-.SS DOMAIN
-.sp
-Im \fBdomain\fP\-Abschnitt werden Domain\-spezifische Informationen konfiguriert.
-.INDENT 0.0
-.TP
-.B \fCauto_postmaster\fP
-\fIBoolean\fP
-.sp
-Ist der Wert dieser Option \fItrue\fP, wird \fBvmm\fP(1) beim Anlegen einer
-Domain automatisch einen postmaster\-Account erstellen.
+.B mdbox
+Dovecot \(>= v2.0.beta5
 .TP
-.B \fCdelete_directory\fP
-\fIBoolean\fP
-.sp
-Bestimmt, ob beim Löschen einer Domain das Verzeichnis einer Domain,
-inklusive aller Anwender\-Verzeichnisse, rekursiv gelöscht werden soll.
-.TP
-.B \fCdirectory_mode\fP
-\fIInt\fP
-.sp
-Zugriffsbits des Domain\-Verzeichnisses in Dezimal\-Schreibweise (Basis
-10).
-.nf
-Beispiel: \(aqdrwxrwx\-\-\-\(aq \-> oktal 0770 \-> dezimal 504
-.fi
-.sp
-.TP
-.B \fCforce_deletion\fP
-\fIBoolean\fP
-.sp
-Erzwingt das Löschen von Konten und Aliase beim Löschen einer Domain.
-.UNINDENT
-.sp
-Beispiel:
-.sp
-.nf
-.ft C
-[domain]
-auto_postmaster = true
-delete_directory = false
-directory_mode = 504
-force_deletion = false
-.ft P
-.fi
-.SS MAILDIR
-.sp
-Im \fBmaildir\fP\-Abschnitt werden die für die Maildirs erforderlichen Optionen
-festgelegt.
-.INDENT 0.0
-.TP
-.B \fCfolders\fP
-\fIString\fP
-.sp
-Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die
-innerhalb des Maildirs erstellt werden sollen. Sollen innerhalb des
-Maildirs keine Verzeichnisse angelegt werden, ist dieser Optionen ein
-einzelner Doppelpunkt (\(aq\fB:\fP\(aq) als Wert zuzuweisen.
-.sp
-Sollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist ein
-einzelner Punkt (\(aq\fB.\fP\(aq) als Separator zu verwenden.
-.TP
-.B \fCname\fP
-\fIString\fP
-.sp
-Der Standard\-Name des Maildir\-Verzeichnisses im Verzeichnis des
-jeweiligen Anwenders.
-.UNINDENT
-.sp
-Beispiel:
-.sp
-.nf
-.ft C
-[maildir]
-folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
-name = Maildir
-.ft P
-.fi
-.SS MISC
-.sp
-Im \fBmisc\fP\-Abschnitt werden verschiedene Einstellungen festgelegt.
-.INDENT 0.0
-.TP
-.B \fCbase_directory\fP
-\fIString\fP
-.sp
+.B sdbox
+Dovecot \(>= v2.0.rc3
+.\" ------------------------------------
+.SS mailbox.root
+.BR root " (Vorgabe: Maildir) :"
+.I String
+.PP
+Name des Mailbox\-Wurzelverzeichnisses im Home\-Verzeichnis des jeweiligen
+Benutzers.
+Übliche Namen, je nach verwendetem
+.IR mailbox.format ,
+sind
+.BR Maildir ", " mdbox " or " sdbox .
+.\" ------------------------------------
+.SS mailbox.subscribe
+.BR subscribe " (Vorgabe: true) :"
+.I Boolean
+.PP
+Wenn dieser Option der Wert
+.B true
+zugewiesen wurde, werden die, gemäß
+.IR mailbox.folders ,
+erstellen Mailboxen in der subscriptions\-Datei des Benutzers gelistet.
+Sollen die erstellen Mailboxen nicht nicht in der subscriptions\-Datei
+gelistet werden, weisen Sie dieser Option den Wert
+.B false
+zu.
+.\" -----------------------------------------------------------------------
+.SH SEKTION MISC
+In der
+.BR misc \-Sektion
+werden Einstellungen für verschiedene Bereiche festgelegt.
+.SS misc.base_directory
+.BR base_directory " (Vorgabe: /srv/mail) :"
+.I String
+.PP
 Alle Domain\-Verzeichnisse werden innerhalb dieses Basis\-Verzeichnisses
 angelegt.
-.TP
-.B \fCpassword_scheme\fP
-\fIString\fP
-.sp
-Das zu verwendende Passwort\-Schema (siehe auch: \fBdovecotpw \-l\fP).
-.TP
-.B \fCgid_mail\fP
-\fIInt\fP
-.sp
-Die numerische Gruppen\-ID der Gruppe mail, bzw. der Gruppe aus
-\fImail_privileged_group\fP der Datei \fIdovecot.conf\fP.
-.TP
-.B \fCtransport\fP
-\fIString\fP
-.sp
-Der Standard\-Transport aller Domains und Konten. Siehe auch:
-\fBtransport\fP(5)
-.TP
-.B \fCdovecot_version\fP
-\fIInt\fP
-.sp
-Die verketteten Major\- und Minor\-Teile der eingesetzten Dovecot\-Version
-(siehe: \fBdovecot \-\-version\fP).
-.sp
-Wenn das Kommando \fBdovecot \-\-version\fP zum Beispiel \fI1.1.18\fP ausgibt,
-ist dieser Option der Wert \fB11\fP zuzuweisen.
-.UNINDENT
-.sp
-Beispiel:
-.sp
+.\" ------------------------------------
+.SS misc.crypt_blowfish_rounds
+.BR crypt_blowfish_rounds " (Vorgabe: 5) :"
+.I Int
+.PP
+Anzahl der Verschlüsselungsdurchgänge für das
+.I password_scheme
+.BR BLF\-CRYPT .
+.PP
+Der Wert muss im Bereich von
+.BR 4 " \- " 31
+liegen.
+.\" ------------------------------------
+.SS misc.crypt_sha256_rounds
+.BR crypt_sha256_rounds " (Vorgabe: 5000) :"
+.I Int
+.PP
+Anzahl der Verschlüsselungdurchgänge für das
+.I password_scheme
+.BR SHA256\-CRYPT .
+.PP
+Der Wert muss im Bereich von
+.BR 1000 " \- " 999999999
+liegen.
+.\" ------------------------------------
+.SS misc.crypt_sha512_rounds
+.BR crypt_sha512_rounds " (Vorgabe: 5000) :"
+.I Int
+.PP
+Anzahl der Verschlüsselungdurchgänge für das
+.I password_scheme
+.BR SHA512\-CRYPT .
+.PP
+Der Wert muss im Bereich von
+.BR 1000 " \- " 999999999
+liegen.
+.\" ------------------------------------
+.SS misc.dovecot_version
+.BR dovecot_version " (Vorgabe: " None ") :"
+.I String
+.PP
+Die aktuell eingesetzte Dovecot\-Version.
+(siehe:
+.BR "dovecot \-\-version" ).
+
+Wenn das Kommando
+.B dovecot \-\-version
+zum Beispiel
+.I 2.0.beta4 (8818db00d347)
+ausgibt, ist dieser Option der Wert
+.B 2.0.beta4
+zuzuweisen.
+.\" ------------------------------------
+.SS misc.password_scheme
+.BR password_scheme " (Vorgabe: CRAM\-MD5) :"
+.I String
+.PP
+Das zu verwendende Passwort\-Schema.
+Um eine Liste aller verfügbaren Passwort\-Schemata zu erhalten, führen Sie
+das Kommando
+.B dovecotpw -l
+(Dovecot v1.x) oder
+.B doveadm pw \-l
+(Dovecot v2.0) aus.
+.PP
+Seit Dovecot \(>= v1.1.alpha1 ist es möglich,
+dem
+.I password_scheme
+ein Encoding\-Suffix anzufügen.
+Unterstützte Encoding\-Suffixe:
+.BR .b64 ", " .base64 " und " .hex .
+Beispiel: PLAIN.BASE64
+.\" ------------------------------------
+.SS misc.quota_bytes
+.BR quota_bytes " (Vorgabe: 0) :"
+.I String
+.PP
+Quota Limit in Bytes.
+0 bedeutet unbegrenzt.
+Dieses Limit wird bei allen neu angelegten Domains angewendet.
+.PP
+Der Wert dieser Option kann als Integer\-Wert, zum Beispiel
+.B 20480
+geschrieben werden.
+Es ist auch möglich dem Wert eines der folgenden
+Suffixe anzuhängen:
+.BR b " (Bytes), " k " (Kilobytes), " M " (Megabytes) oder " G
+(Gigabytes).
+.br
+1024 entspricht 1024b oder 1k.
+.\" ------------------------------------
+.SS misc.quota_messages
+.BR quota_messages " (Vorgabe: 0) :"
+.I Int
+.PP
+Quota Limit als Anzahl von Nachrichten.
+0 bedeutet unbegrenzt.
+Dieses Limit wird bei allen neu angelegten Domains angewendet.
+.\" ------------------------------------
+.SS misc.transport
+.BR transport " (Vorgabe: dovecot:) :"
+.I String
+.PP
+Der Standard\-Transport aller Domains und Konten.
+Siehe auch:
+.BR transport (5).
+.\" -----------------------------------------------------------------------
+.SH BEISPIEL
+Eine Beispiel\-Konfiguration.
+Alle Optionen, die nicht in der Konfigurationsdatei gelistet sind, haben
+ihren Vorgabewert.
+.PP
 .nf
-.ft C
+[account]
+password_length = 10
+random_password = true
+
+[bin]
+dovecotpw = /usr/bin/doveadm
+
+[database]
+host = dbsrv8.example.net
+pass = PY_SRJ}L/0p\-oOk
+port = 5433
+sslmode = require
+user = vmm
+
+[mailbox]
+folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
+
 [misc]
-base_directory = /srv/mail
-password_scheme = CRAM\-MD5
-gid_mail = 8
-transport = dovecot:
-dovecot_version = 11
-.ft P
-.fi
-.SH DATEIEN
-.INDENT 0.0
-.TP
-.B \fI/root/vmm.cfg\fP
-.nf
-Wird verwendet, falls vorhanden.
-.fi
-.sp
-.TP
-.B \fI/usr/local/etc/vmm.cfg\fP
-.nf
-Wird verwendet, sollte obige Datei nicht gefunden werden.
+crypt_sha512_rounds = 10000
+dovecot_version = 2.0.beta4
+password_scheme = SHA512\-CRYPT.hex
+quota_bytes = 500M
+quota_messages = 10000
+transport = lmtp:unix:private/dovecot\-lmtp
 .fi
-.sp
-.TP
-.B \fI/etc/vmm.cfg\fP
-.nf
-Wird verwendet, falls obengenannte Dateien nicht existieren.
-.fi
-.sp
-.UNINDENT
+.\" -----------------------------------------------------------------------
 .SH SIEHE AUCH
-.sp
-vmm(1), Programm für die Kommandozeile, um E\-Mail\-Domains, \-Konten und \-Aliase
-zu verwalten.
+.BR doveadm\-pw (1),
+.BR dovecotpw (1),
+.BR postconf (1),
+.BR vmm (1),
+.BR transport (5)
+.\" -----------------------------------------------------------------------
+.SH INTERNET RESSOURCEN
+.TP
+Wiki
+http://de.vmm.localdomain.org/
+.TP
+Projekt\-Seite
+http://sf.net/projects/vmm/
+.TP
+Bugtracker
+http://sf.net/tracker/?group_id=213727&atid=1026862
+.\" -----------------------------------------------------------------------
 .SH COPYING
-.sp
-vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschrieben
-und sind unter den Bedingungen der BSD Lizenz lizenziert.
-.SH AUTHOR
-Pascal Volk <neverseen@users.sourceforge.net>
-.\" Generated by docutils manpage writer.
-.\" 
-.
+vmm und die dazugehörigen Manualseiten wurden von Pascal Volk <neverseen AT
+users.sourceforge.net> geschrieben und sind unter den Bedingungen der BSD
+Lizenz lizenziert.
\ No newline at end of file