--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/man/de/man5/vmm.cfg.5.rst Mon Jan 18 03:23:50 2010 +0000
@@ -0,0 +1,323 @@
+=========
+ vmm.cfg
+=========
+
+---------------------------
+Konfigurationsdatei für vmm
+---------------------------
+
+:Author: Pascal Volk <neverseen@users.sourceforge.net>
+:Date: 2010-01-18
+:Version: vmm-0.6.0
+:Manual group: vmm Manual
+:Manual section: 5
+
+.. contents::
+ :backlinks: top
+ :class: htmlout
+
+SYNOPSIS
+========
+vmm.cfg
+
+BESCHREIBUNG
+============
+**vmm**\(1) liest seine Konfigurationsparameter aus der Datei *vmm.cfg*.
+
+Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt
+wird mit dem, in eckigen Klammern '**[**' und '**]**' eingefassten, Namen des
+Abschnitts eingeleitet, gefolgt von '*Option* = *Wert*' Einträgen::
+
+ [database]
+ host = 127.0.0.1
+
+Leerräume um das Gleichheitszeichen '=' und am Ende eines Wertes werden
+ignoriert.
+
+Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden
+ignoriert.
+
+Jeder Wert ist von einem der folgenden Datentypen:
+
+* *Boolean* um zu bestimmen, ob etwas eingeschaltet/aktiviert (true) oder
+ ausgeschaltet/deaktiviert (false) ist.
+
+ | Mögliche Werte für *true* sind: **1**, **yes**, **true** und **on**.
+ | Mögliche Werte für *false* sind: **0**, **no**, **false** und **off**.
+
+* *Int* eine Integer-Zahl, geschrieben ohne eine gebrochene oder dezimale
+ Komponente.
+
+ | Beispielsweise **1**, **50** oder **321** sind Integer-Zahlen.
+
+* *String* eine Folge von Buchstaben und Zahlen.
+
+ | Zum Beispiel: '**Wort**', '**Hallo Welt**' oder '**/usr/bin/strings**'
+
+
+SUCHREIHENFOLGE
+---------------
+Standardmäßig sucht **vmm**\(1) die *vmm.cfg* in folgenden Verzeichnissen,
+in der angegebenen Reihenfolge:
+
+ | */root*
+ | */usr/local/etc*
+ | */etc*
+
+Die zuerst gefundene Datei wird verwendet.
+
+ABSCHNITTE
+==========
+Dieser Abschnitt beschreibt alle Abschnitte, sowie deren Optionen, der
+*vmm.cfg*.
+
+ACCOUNT
+-------
+Die Optionen des Abschnitts **account** legen Konto-spezifische
+Einstellungen fest.
+
+``delete_directory`` : *Boolean*
+ Bestimmt das Verhalten von **vmm**\(1) beim Löschen eines Kontos.
+ Wenn der Wert dieser Option *true* ist, wird das Home-Verzeichnis des
+ zu löschenden Anwenders rekursiv gelöscht.
+
+``directory_mode`` : *Int*
+ Zugriffsbits des Home-Verzeichnisses, sowie aller enthaltenen
+ Verzeichnisse, in Dezimal-Schreibweise (Basis 10).
+
+ | Beispiel: 'drwx------' -> oktal 0700 -> dezimal 448
+
+``disk_usage`` : *Boolean*
+ Legt fest, ob die Festplattenbelegung des Maildirs eines Benutzers jedes
+ Mal mit **du**\(1) ermittelt und mit den Konto-Informationen ausgegeben
+ werden soll.
+
+ Bei umfangreichen Maildirs kann das langsam sein. Falls Sie Quotas
+ aktiviert haben, wird der **vmm**-Unterbefehl **userinfo** ebenfalls
+ die aktuelle Quota-Nutzung des Kontos mit ausgegeben. Sie können auch
+ eines der optionalen Argumente **du** oder **full** an **userinfo**
+ übergeben, um sich die aktuelle Festplattenbelegung anzeigen zu lassen.
+
+``imap`` : *Boolean*
+ Bestimmt, ob sich neu angelegte Benutzer per IMAP anmelden können sollen.
+
+``password_length`` : *Int*
+ Legt fest, wie viele Zahlen und/oder Buchstaben für ein automatisch
+ erzeugtes Passwort verwendet werden sollen. Alle Werte kleiner als 8
+ werden auf 8 erhöht.
+
+``pop3``
+ Bestimmt, ob sich neu angelegte Benutzer per POP3 anmelden können sollen.
+
+``random_password`` : *Boolean*
+ Mit dieser Option bestimmen Sie, ob **vmm**\(1) ein zufälliges Passwort
+ generieren soll, wenn kein Passwort an den **useradd** Unterbefehl
+ übergeben wurde. Ist der Wert dieser Option *false*, wird **vmm** Sie
+ auffordern, ein Passwort für den neun Account einzugeben.
+
+ Sie können die Länge für automatisch generierte Passwörter mit der
+ Option **password_length** konfigurieren.
+
+``sieve`` : *Boolean*
+ Bestimmt, ob sich neu angelegte Benutzer per ManageSieve anmelden
+ können sollen.
+
+``smtp`` : *Boolean*
+ Bestimmt, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmelden
+ können sollen.
+
+Beispiel::
+
+ [account]
+ delete_directory = false
+ directory_mode = 448
+ disk_usage = false
+ random_password = true
+ password_length = 10
+ smtp = true
+ pop3 = true
+ imap = true
+ sieve = true
+
+BIN
+---
+Im **bin**-Abschnitt werden Pfade zu Binaries angegeben, die von
+**vmm**\(1) benötigt werden.
+
+``dovecotpw`` : *String*
+ Der absolute Pfad zum dovecotpw Binary. Dieses Binary wird zur
+ Hash-Erzeugung verwendet, wenn **misc.password_scheme** einen der
+ nachfolgenden Werte hat: 'SMD5', 'SSHA', 'CRAM-MD5', 'HMAC-MD5',
+ 'LANMAN', 'NTLM' oder 'RPA'.
+
+``du`` : *String*
+ Der absolute Pfad zu **du**\(1). Dieses Binary wird verwendet, wenn
+ die Festplattenbelegung eines Kontos ermittelt wird.
+
+``postconf`` : *String*
+ Der absolute Pfad zu Postfix' **postconf**\(1). Dieses Binary wird
+ verwendet, wenn **vmm**\(1) diverse Postfix-Einstellungen prüft, zum
+ Beispiel das `virtual_alias_expansion_limit`.
+
+Beispiel::
+
+ [bin]
+ dovecotpw = /usr/sbin/dovecotpw
+ du = /usr/bin/du
+ postconf = /usr/sbin/postconf
+
+CONFIG
+------
+Beim **config**-Abschnitt handelt es sich um einen internen
+Steuerungs-Abschnitt.
+
+``done`` : *Boolean*
+ Diese Option hat den den Wert *false*, wenn **vmm**\(1) zum ersten Mal
+ installiert wurde. Wenn Sie die Datei *vmm.cfg* von Hand editieren,
+ weisen Sie dieser Option abschließend den Wert *true* zu. Wird die
+ Konfiguration über das Kommando **vmm configure** angepasst, wird der
+ Wert dieser Option automatisch auf *true* gesetzt.
+
+ Sollte diese Option den Wert *false* zugewiesen haben, so startet
+ **vmm**\(1) beim nächsten Aufruf im interaktiven Konfigurations-Modus.
+
+Beispiel::
+
+ [config]
+ done = true
+
+DATABASE
+--------
+Der **database**-Abschnitt wird verwendet, um die für den Datenbankzugriff
+benötigten Optionen festzulegen.
+
+``host`` : *String*
+ Der Hostname oder die IP-Adresse des Datenbank-Servers.
+
+``name`` : *String*
+ Name der zu verwendenden Datenbank.
+
+``pass`` : *String*
+ Das Passwort des Datenbank-Benutzers.
+
+``user`` : *String*
+ Der Name des Datenbank-Benutzers.
+
+Beispiel::
+
+ [database]
+ host = localhost
+ user = vmm
+ pass = PY_SRJ}L/0p-oOk
+ name = mailsys
+
+DOMAIN
+------
+Im **domain**-Abschnitt werden Domain-spezifische Informationen konfiguriert.
+
+``auto_postmaster`` : *Boolean*
+ Setzen Sie den Wert dieser Option auf *true*, wenn **vmm**\(1)
+ automatisch einen postmaster-Account erstellen soll, wenn Sie eine neue
+ Domain anlegen.
+
+``delete_directory`` : *Boolean*
+ Bestimmt, ob beim Löschen einer Domain das Verzeichnis einer Domain,
+ inklusive aller Anwender-Verzeichnisse, rekursiv gelöscht werden soll.
+
+``directory_mode`` : *Int*
+ Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis
+ 10).
+
+ | Beispiel: 'drwxrwx---' -> oktal 0770 -> dezimal 504
+
+``force_deletion`` : *Boolean*
+ Legt fest, ob beim Löschen einer Domain alle vorhanden Konten und/oder
+ Aliase, ohne Nachfrage, gelöscht werden sollen.
+
+Beispiel::
+
+ [domain]
+ auto_postmaster = true
+ delete_directory = false
+ directory_mode = 504
+ force_deletion = false
+
+MAILDIR
+-------
+Im **maildir**-Abschnitt werden die für die Maildirs erforderlichen Optionen
+festgelegt.
+
+``folders`` : *String*
+ 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 ('**:**') als Wert zuzuweisen.
+
+ Wenn Sie Verzeichnisse mit Unterverzeichnissen anlegen wollen,
+ verwendenden Sie einen einzelnen Punkt ('**.**') als Separator.
+
+``name`` : *String*
+ Standard-Name des Maildir-Verzeichnisses im Verzeichnis des jeweiligen
+ Anwenders.
+
+Beispiel::
+
+ [maildir]
+ folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
+ name = Maildir
+
+MISC
+----
+Im **misc**-Abschnitt werden verschiedene Einstellungen festgelegt.
+
+``base_directory`` : *String*
+ Alle Domain-Verzeichnisse werden innerhalb dieses Basis-Verzeichnisses
+ angelegt.
+
+``password_scheme`` : *String*
+ Das zu verwendende Passwort-Schema (siehe auch: **dovecotpw -l**).
+
+``gid_mail`` : *Int*
+ Die numerische Gruppen-ID der Gruppe mail, bzw. der Gruppe aus
+ `mail_privileged_group` der Datei *dovecot.conf*.
+
+``transport`` : *String*
+ Der Standard-Transport aller Domains und Konten. Siehe auch:
+ **transport**\(5)
+
+``dovecot_version`` : *Int*
+ Die verketteten Major- und Minor-Teile der eingesetzten Dovecot-Version
+ (siehe: **dovecot --version**).
+
+ Diese Option beeinflusst diverse Datenbankzugriffe. Da es zwischen
+ Dovecot v1.1.x und v1.2.x einige Änderungen gab. Zum Beispiel **11**,
+ falls **dovecot --version** den Wert 1.1.18 ausgibt.
+
+Beispiel::
+
+ [misc]
+ base_directory = /srv/mail
+ password_scheme = CRAM-MD5
+ gid_mail = 8
+ transport = dovecot:
+ dovecot_version = 11
+
+DATEIEN
+=======
+*/root/vmm.cfg*
+ | Wird verwendet, falls vorhanden.
+*/usr/local/etc/vmm.cfg*
+ | Wird verwendet, sollte obige Datei nicht gefunden werden.
+*/etc/vmm.cfg*
+ | Wird verwendet, falls obengenannte Dateien nicht existieren.
+
+SIEHE AUCH
+==========
+vmm(1), Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase
+zu verwalten.
+
+COPYING
+=======
+vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschrieben
+und sind unter den Bedingungen der BSD Lizenz lizenziert.
+