diff -r fd496561acc6 -r a72908248153 man/de/man5/vmm.cfg.5.rst --- /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 +: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. +