--- a/man/de/man1/vmm.1.rst	Wed Oct 26 03:20:40 2011 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,550 +0,0 @@
-=====
- vmm
-=====
-
------------------------------------------------------------------------------
-Kommandozeilenprogramm zur Verwaltung von E-Mail-Domains, -Konten und -Aliase
------------------------------------------------------------------------------
-
-:Author:         Pascal Volk <neverseen@users.sourceforge.net>
-:Date:           |today|
-:Version:        vmm-0.6.0
-:Manual group:   vmm Manual
-:Manual section: 1
-
-.. contents::
-  :backlinks: top
-  :class: htmlout
-
-SYNOPSIS
-========
-vmm *Unterbefehl* *Objekt* [ *Argumente* ]
-
-
-BESCHREIBUNG
-============
-**vmm** (a virtual mail manager) ist ein Kommandozeilenprogramm für
-Administratoren/Postmaster zur Verwaltung von (Alias-) Domains, Konten und
-Alias-Adressen. Es wurde entwickelt für Dovecot und Postfix mit einem
-PostgreSQL-Backend.
-
-
-UNTERBEFEHLE
-============
-Von jedem Unterbefehl gibt es jeweils eine lange und kurze Variante. Die
-Kurzform ist in Klammern geschrieben. Bei beiden Formen ist die
-Groß-/Kleinschreibung zu berücksichtigen.
-
-
-ALLGEMEINE UNTERBEFEHLE
------------------------
-.. _configget:
-
-``configget (cg) Option``
- Dieser Unterbefehl wird verwendet, um den aktuellen Wert der übergebenen
- *Option* anzuzeigen. Die *Option* wird in der Form *Sektion*\ **.**\ *Option*
- angegeben. Zum Beispiel: **misc.transport**.
-
-.. _configset:
-
-``configset (cs) Option Wert``
-  Verwenden Sie diesen Unterbefehl, um einer einzelnen Konfigurations-*Option*
-  einen neuen *Wert* zuzuweisen. Die *Option* wird dabei in der Form
-  *Sektion*\ **.**\ *Option* angegeben. *Wert* ist der neue Wert der *Option*.
-
-  Beispiel::
-
-    vmm configget misc.transport
-    misc.transport = dovecot:
-    vmm configset misc.transport lmtp:unix:private/dovecot-lmtp
-    vmm cg misc.transport
-    misc.transport = lmtp:unix:private/dovecot-lmtp
-
-.. _configure:
-
-``configure (cf) [ Sektion ]``
-  Startet den interaktiven Konfiguration-Modus für alle Sektionen der
-  Konfiguration.
-
-  Dabei wird der aktuell konfigurierte Wert einer jeden Option in eckigen
-  Klammern ausgegeben. Sollte kein Wert konfiguriert sein, wird der
-  Vorgabewert der jeweiligen Option in in eckigen Klammern angezeigt. Um den
-  angezeigten Wert unverändert zu übernehmen, ist dieser mit der
-  Eingabe-Taste zu bestätigen.
-
-  Wurde das optionale Argument *Sektion* angegeben, werden nur die Optionen
-  der angegebenen Sektion angezeigt und können geändert werden. Folgende
-  Sektionen sind vorhanden:
-
-  | - **account**
-  | - **bin**
-  | - **database**
-  | - **domain**
-  | - **maildir**
-  | - **misc**
-
-  Beispiel::
-
-    vmm configure domain
-    Verwende Konfigurationsdatei: /usr/local/etc/vmm.cfg
-
-    * Konfigurations Sektion: „domain“
-    Neuer Wert für Option directory_mode [504]:
-    Neuer Wert für Option delete_directory [False]: 1
-    Neuer Wert für Option auto_postmaster [True]:
-    Neuer Wert für Option force_deletion [False]: on
-
-.. _getuser:
-
-``getuser (gu) userid``
-  Wenn nur eine UserID vorhanden ist, zum Beispiel aus der Prozessliste,
-  kann mit dem Unterbefehl **getuser** die E-Mail-Adresse des Users
-  ermittelt werden.
-
-  Beispiel::
-
-    vmm getuser 70004
-    Account Informationen
-    ---------------------
-            UID............: 70004
-            GID............: 70000
-            Address........: c.user@example.com
-
-.. _listdomains:
-
-``listdomains (ld) [ Muster ]``
-  Dieser Unterbefehl listet alle verfügbaren Domains auf. Allen Domains wird
-  ein Präfix vorangestellt. Entweder ein '[+]', falls es sich um eine
-  primäre Domain handelt, oder ein '[-]', falls es sich um eine Alias-Domain
-  handelt. Die Ausgabe kann reduziert werden, indem ein optionales *Muster*
-  angegeben wird.
-
-  Um eine Wildcard-Suche durchzuführen kann das **%**-Zeichen am Anfang
-  und/oder Ende des *Musters* verwendet werden.
-
-  Beispiel::
-
-    vmm listdomains %example%
-    Übereinstimmende Domains
-    ------------------------
-            [+] example.com
-            [-]     e.g.example.com
-            [-]     example.name
-            [+] example.net
-            [+] example.org
-
-.. _help:
-
-``help (h)``
-  Dieser Unterbefehl gibt alle verfügbaren Kommandos auf der Standardausgabe
-  (stdout) aus. Danach beendet sich **vmm**.
-
-.. _version:
-
-``version (v)``
-  Gibt Versionsinformationen zu **vmm** aus.
-
-DOMAIN UNTERBEFEHLE
--------------------
-.. _domainadd:
-
-``domainadd (da) Domain [ Transport ]``
-  Fügt eine neue *Domain* in die Datenbank ein und erstellt das
-  Domain-Verzeichnis.
-
-  Ist das optionale Argument *Transport* angegeben, wird der
-  Vorgabe-Transport (|misc.transport|_) aus |vmm.cfg(5)|_ für diese *Domain*
-  ignoriert und der angegebene *Transport* verwendet. Der angegebene
-  *Transport* ist gleichzeitig der Vorgabe-Transport für alle neuen Konten,
-  die unter dieser Domain eingerichtet werden.
-
-  Wenn der Wert der Konfigurations-Option |domain.auto_postmaster|_ **true**
-  ist, wird **vmm** auch ein Konto für **postmaster@**\ *Domain* erstellen.
-
-  Beispiele::
-
-    vmm domainadd support.example.com smtp:mx1.example.com
-    vmm domainadd sales.example.com
-
-.. _domaininfo:
-
-``domaininfo (di) Domain [ Details ]``
-  Dieser Unterbefehl zeigt Information zur angegeben *Domain* an.
-
-  Um detaillierte Informationen über die *Domain* zu erhalten, kann das
-  optionale Argument *Details* angegeben werden. Ein möglicher Wert für
-  *Details* kann eines der folgenden fünf Schlüsselwörter sein:
-
-  ``accounts``
-    um alle existierenden Konten aufzulisten
-  ``aliasdomains``
-    um alle zugeordneten Alias-Domains aufzulisten
-  ``aliases``
-    um alle verfügbaren Alias-Adressen aufzulisten
-  ``relocated``
-    um alle Adressen der relocated Users aufzulisten
-  ``full``
-    um alle oben genannten Informationen aufzulisten
-
-  Beispiel::
-
-    vmm domaininfo sales.example.com
-    Domain Informationen
-    --------------------
-            Domainname.....: sales.example.com
-            GID............: 70002
-            Transport......: dovecot:
-            Domaindir......: /home/mail/5/70002
-            Aliasdomains...: 0
-            Accounts.......: 0
-            Aliases........: 0
-            Relocated......: 0
-
-.. _domainquota:
-
-``domainquota (dq) Domain Speicher [Nachrichten] [force]``
-  Dieser Unterbefehl wird verwendet, um für die Konten der *Domain* ein
-  neues Quota-Limit festzulegen.
-
-  Standardmäßig gilt für Konten das Quota-Limit der *vmm.cfg*
-  (|misc.quota_bytes|_ und |misc.quota_messages|_). Das neue Quota-Limit
-  wird für alle zukünftig angelegte Konten gelten. Soll das neue Quota
-  Limit auch auf bestehende Konten der *Domain* angewendet werden, ist das
-  optionale Schlüsselwort **force** anzugeben.
-
-  ``Speicher``
-    Bestimmt das Quota-Limit in Bytes. Eines der Präfixe **b** (Bytes),
-    **k** (Kilobytes), **M** (Megabytes), oder **G** (Gigabytes) kann an das
-    ganzzahlige Limit angehängt werden. **0** steht für unbegrenzt - kein
-    Quota-Limit in Bytes.
-  ``Nachrichten``
-    Legt das Quota-Limit als Anzahl von Nachrichten fest. Wurde dieses
-    optionale Argument ausgelassen, wird das Nachrichten Limit auf 0 gesetzt.
-    **0** steht für unbegrenzt - kein Quota-Limit als Anzahl von Nachrichten.
-
-  Beispiel::
-
-    vmm domainquota example.com 1g force
-
-.. _domaintransport:
-
-``domaintransport (dt) Domain Transport [ force ]``
-  Ein neuer *Transport* für die angegebene *Domain* kann mit diesem
-  Unterbefehl festgelegt werden.
-
-  Wurde das optionale Schlüsselwort **force** angegeben, so werden alle
-  bisherigen Transport-Einstellungen, der in dieser Domain vorhandenen
-  Konten, mit dem neuen *Transport* überschrieben.
-
-  Andernfalls gilt der neue *Transport* nur für Konten, die zukünftig
-  erstellt werden.
-
-  Beispiel::
-
-    vmm domaintransport support.example.com dovecot:
-
-.. _domaindelete:
-
-``domaindelete (dd) Domain [ force ]``
-  Mit diesem Unterbefehl wird die angegebene *Domain* gelöscht.
-
-  Sollten der *Domain* Konten, Aliase und/oder relocated User  zugeordnet
-  sein, wird **vmm** die Ausführung des Befehls mit einer entsprechenden
-  Fehlermeldung beenden.
-
-  Sollten Sie sich Ihres Vorhabens sicher sein, so kann optional das
-  Schlüsselwort **force** angegeben werden.
-
-  Sollten Sie wirklich immer wissen was Sie tun, so editieren Sie Ihre
-  *vmm.cfg* und setzen den Wert der Option |domain.force_deletion|_ auf
-  true. Dann werden Sie beim Löschen von Domains nicht mehr wegen vorhanden
-  Konten, Aliase und/oder relocated User gewarnt.
-
-
-ALIAS-DOMAIN UNTERBEFEHLE
--------------------------
-.. _aliasdomainadd:
-
-``aliasdomainadd (ada) Aliasdomain Zieldomain``
-  Mit diesem Unterbefehl wird der *Zieldomain* die Alias-Domain
-  *Aliasdomain* zugewiesen.
-
-  Beispiel::
-
-    vmm aliasdomainadd example.name example.com
-
-.. _aliasdomaininfo:
-
-``aliasdomaininfo (adi) Aliasdomain``
-  Dieser Unterbefehl informiert darüber, welcher Domain die Alias-Domain
-  *Aliasdomain* zugeordnet ist.
-
-  Beispiel::
-
-    vmm aliasdomaininfo example.name
-    Alias-Domain Informationen
-    --------------------------
-            Die Alias-Domain example.name gehört zu:
-                * example.com
-
-.. _aliasdomainswitch:
-
-``aliasdomainswitch (ads) Aliasdomain Zieldomain``
-  Wenn das Ziel der vorhandenen *Aliasdomain* auf eine andere *Zieldomain*
-  geändert werden soll, ist dieser Unterbefehl zu verwenden.
-
-  Beispiel::
-
-    vmm aliasdomainswitch example.name example.org
-
-.. _aliasdomaindelete:
-
-``aliasdomaindelete (add) Aliasdomain``
-  Wenn die Alias-Domain mit dem Namen *Aliasdomain* gelöscht werden soll,
-  ist dieser Unterbefehl zu verwenden.
-
-  Beispiel::
-
-    vmm aliasdomaindelete e.g.example.com
-
-
-KONTO UNTERBEFEHLE
-------------------
-.. _useradd:
-
-``useradd (ua) Adresse [ Passwort ]``
-  Mit diesem Unterbefehl wird ein neues Konto für die angegebene *Adresse*
-  angelegt.
-
-  Wurde kein *Passwort* angegeben wird **vmm** dieses im interaktiven Modus
-  erfragen. Falls kein *Passwort* angegeben wurde und
-  |account.random_password|_ den Wert **true** hat, wird **vmm** ein
-  zufälliges Passwort generieren und auf stdout ausgeben, nachdem das Konto
-  angelegt wurde.
-
-  Beispiele::
-
-    vmm ua d.user@example.com 'A 5ecR3t P4s5\\/\\/0rd'
-    vmm ua e.user@example.com
-    Neues Passwort eingeben:
-    Neues Passwort wiederholen:
-
-.. _userinfo:
-
-``userinfo (ui) Adresse [ Details ]``
-  Dieser Unterbefehl zeigt einige Informationen über das Konto mit der
-  angegebenen *Adresse* an.
-
-  Wurde das optionale Argument *Details* angegeben, werden weitere
-  Informationen ausgegeben. Mögliche Werte für *Details* sind:
-
-  ``aliases``
-    um alle Alias-Adressen, mit dem Ziel *Adresse*, aufzulisten
-  ``du``
-    um zusätzlich die Festplattenbelegung des Maildirs eines Kontos
-    anzuzeigen. Soll die Festplattenbelegung jedes Mal mit der **userinfo**
-    ermittelt werden, ist in der *vmm.cfg* der Wert der Option
-    |account.disk_usage|_ auf true zu setzen.
-  ``full``
-    um alle oben genannten Informationen anzuzeigen
-
-.. _username:
-
-``username (un) Adresse 'Bürgerlicher Name'``
-  Der Bürgerliche Name des Konto-Inhabers mit der angegebenen *Adresse* kann
-  mit diesem Unterbefehl gesetzt/aktualisiert werden.
-
-  Beispiel::
-
-    vmm un d.user@example.com 'John Doe'
-
-.. _userpassword:
-
-``userpassword (up) Adresse [ Passwort ]``
-  Das *Passwort* eines Kontos kann mit diesem Unterbefehl aktualisiert
-  werden.
-
-  Wurde kein *Passwort* angegeben wird **vmm** dieses im interaktiven Modus
-  erfragen.
-
-  Beispiel::
-
-    vmm up d.user@example.com 'A |\\/|0r3 5ecur3 P4s5\\/\\/0rd?'
-
-.. _userquota:
-
-``userquota (uq) Adresse Speicher [Nachrichten]``
-  Um ein neues Quota-Limit für das Konto mit der angegebenen *Adresse*
-  festzulegen wird dieser Unterbefehl verwendet.
-
-  ``Speicher``
-    Bestimmt das Quota-Limit in Bytes. Eines der Präfixe **b** (Bytes),
-    **k** (Kilobytes), **M** (Megabytes), oder **G** (Gigabytes) kann an das
-    ganzzahlige Limit angehängt werden. **0** steht für unbegrenzt - kein
-    Quota-Limit in Bytes.
-  ``Nachrichten``
-    Legt das Quota-Limit als Anzahl von Nachrichten fest. Wurde dieses
-    optionale Argument ausgelassen, wird das Nachrichten Limit auf 0 gesetzt.
-    **0** steht für unbegrenzt - kein Quota-Limit als Anzahl von Nachrichten.
-
-  Beispiel::
-
-    vmm userquota d.user@example.com 750m
-
-.. _usertransport:
-
-``usertransport (ut) Adresse Transport``
-  Mit diesem Unterbefehl kann ein abweichender *Transport* für das Konto mit
-  der angegebenen *Adresse* bestimmt werden.
-
-  Beispiel::
-
-    vmm ut d.user@example.com smtp:pc105.it.example.com
-
-.. _userdisable:
-
-``userdisable (u0) Adresse [ Service ... ]``
-  Soll ein Anwender keinen Zugriff auf bestimmte oder alle Service haben, kann
-  der Zugriff mit diesem Unterbefehl beschränkt werden.
-
-  Wurde kein *Service* angegeben, werden alle Services (**smtp**, **pop3**,
-  **imap**, und **sieve**) für das Konto mit der angegebenen *Adresse*
-  deaktiviert.
-
-  Andernfalls wird nur der Zugriff auf den/die angegebenen *Service*/s
-  gesperrt.
-
-  Beispiele::
-
-    vmm u0 b.user@example.com imap pop3
-    vmm userdisable c.user@example.com
-
-.. _userenable:
-
-``userenable (u1) Adresse [ Service ... ]``
-  Um den Zugriff auf bestimmte oder alle gesperrten Service zu gewähren,
-  wird dieser Unterbefehl verwendet.
-
-  Wurde kein *Service* angegeben, werden alle Services (**smtp**, **pop3**,
-  **imap**, und **sieve**) für das Konto mit der angegebenen  *Adresse*
-  aktiviert.
-
-  Andernfalls wird nur der Zugriff auf den/die angegebenen *Service*/s
-  aktiviert.
-
-.. _userdelete:
-
-``userdelete (ud) Adresse [ force ]``
-  Verwenden Sie diesen Unterbefehl um, das Konto mit der angegebenen
-  *Adresse* zu löschen.
-
-  Sollte es einen oder mehrere Aliase geben, deren Zieladresse mit der
-  *Adresse* des zu löschenden Kontos identisch ist, wird **vmm** die
-  Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden. Um
-  dieses zu umgehen, kann das optionale Schlüsselwort **force**
-  angegebenen werden.
-
-
-ALIAS UNTERBEFEHLE
-------------------
-.. _aliasadd:
-
-``aliasadd (aa) Alias Ziel ...``
-  Mit diesem Unterbefehl werden neue *Alias*\ -Adressen, mit einer oder
-  mehren  *Ziel*\ -Adressen, erstellt.
-
-  Beispiele::
-
-    vmm aliasadd john.doe@example.com d.user@example.com
-    vmm aa support@example.com d.user@example.com e.user@example.com
-
-.. _aliasinfo:
-
-``aliasinfo (ai) Alias``
-  Informationen zu einem Alias können mit diesem Unterbefehl ausgegeben
-  werden.
-
-  Beispiel::
-
-    vmm aliasinfo support@example.com
-    Alias Informationen
-    -------------------
-            E-Mails für support@example.com werden weitergeleitet an:
-                 * d.user@example.com
-                 * e.user@example.com
-
-.. _aliasdelete:
-
-``aliasdelete (ad) Alias [ Ziel ]``
-  Verwenden Sie diesen Unterbefehl um den angegebenen *Alias* zu löschen.
-
-  Wurde die optionale Zieladresse *Ziel* angegeben, so wird nur diese
-  Zieladresse vom angegebenen *Alias* entfernt.
-
-  Beispiel::
-
-    vmm ad support@example.com d.user@example.com
-
-
-RELOCATED UNTERBEFEHLE
-----------------------
-.. _relocatedadd:
-
-``relocatedadd (ra) alte_adresse neue_adresse``
-  Um einen neuen relocated User anzulegen kann dieser Unterbefehl verwendet
-  werden.
-
-  Dabei ist *alte_adresse* die ehemalige Adresse des Benutzers, zum Beispiel
-  b.user@example.com, und *neue_adresse* die neue Adresse, unter der
-  Benutzer erreichbar ist.
-
-  Beispiel::
-
-    vmm relocatedadd b.user@example.com b-user@company.tld
-
-.. _relocatedinfo:
-
-``relocatedinfo (ri) alte_adresse``
-  Dieser Unterbefehl zeigt die neue Adresse des relocated Users mit
-  *alte_adresse*.
-
-  Beispiel::
-
-    vmm relocatedinfo b.user@example.com
-    Relocated Informationen
-    -----------------------
-    Der Benutzer „b.user@example.com“ ist erreichbar unter „b-user@company.tld“
-
-.. _relocateddelete:
-
-``relocateddelete (rd) alte_adresse``
-  Mit diesem Unterbefehl kann der relocated User mit *alte_adresse*
-  gelöscht werden.
-
-  Beispiel::
-
-    vmm relocateddelete b.user@example.com
-
-
-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.cfg(5)|_
-
-
-COPYING
-=======
-vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschrieben
-und sind unter den Bedingungen der BSD Lizenz lizenziert.
-
-.. include:: ../../substitute_links.rst
-.. include:: ../../substitute_links_1.rst

--- a/man/de/man5/vmm.cfg.5.rst	Wed Oct 26 03:20:40 2011 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,481 +0,0 @@
-=========
- vmm.cfg
-=========
-
----------------------------
-Konfigurationsdatei für vmm
----------------------------
-
-:Author:         Pascal Volk <neverseen@users.sourceforge.net>
-:Date:           |today|
-: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 Sektionen unterteilt. Jede Sektion
-wird mit dem in eckigen Klammern '**[**' und '**]**' eingefassten Namen der
-Sektion eingeleitet, gefolgt von '*Option* = *Wert*' Einträgen.
-
-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**'
-
-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 **#** oder **;**
-auskommentiert oder die Zeile wird einfach aus der *vmm.cfg* entfernt.
-
-Eine minimale *vmm.cfg* könnte so aussehen::
-
-  [database]
-  user = ich
-  pass = xxxxxxxx
-
-  [misc]
-  dovecot_version = 1.2.11
-
-
-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.
-
-
-SEKTIONEN
-=========
-Im Folgenden werden die Sektionen der *vmm.cfg* und deren Optionen
-beschrieben.
-
-
-ACCOUNT
--------
-Die Optionen der Sektion **account** legen Konto-spezifische Einstellungen
-fest.
-
-.. _account.delete_directory:
-
-``delete_directory (Vorgabe: false)`` : *Boolean*
-  Bestimmt das Verhalten von |vmm(1)|_ beim Löschen eines Kontos
-  (|userdelete|_). Wenn der Wert dieser Option *true* ist, wird das
-  Home-Verzeichnis des zu löschenden Anwenders rekursiv gelöscht.
-
-.. _account.directory_mode:
-
-``directory_mode (Vorgabe: 448)`` : *Int*
-  Zugriffsbits des Home-Verzeichnisses, sowie aller enthaltenen
-  Verzeichnisse, in Dezimal-Schreibweise (Basis 10).
-
-  | Beispiel: 'drwx------' -> oktal 0700 -> dezimal 448
-
-.. _account.disk_usage:
-
-``disk_usage (Vorgabe: false)`` : *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.
-
-.. _account.imap:
-
-``imap (Vorgabe: true)`` : *Boolean*
-  Bestimmt, ob sich neu angelegte Benutzer per IMAP anmelden können sollen.
-
-.. _account.password_length:
-
-``password_length (Vorgabe: 8)`` : *Int*
-  Diese Option legt die Anzahl der Zeichen für automatisch erzeugte
-  Passwörter fest. Alle Werte kleiner als 8 werden auf 8 erhöht.
-
-.. _account.pop3:
-
-``pop3 (Vorgabe: true)`` : *Boolean*
-  Bestimmt, ob sich neu angelegte Benutzer per POP3 anmelden können sollen.
-
-.. _account.random_password:
-
-``random_password (Vorgabe: false)`` : *Boolean*
-  Mit dieser Option wird bestimmt , ob **vmm** ein zufälliges Passwort
-  generieren soll, wenn kein Passwort an den Unterbefehl |useradd|_
-  ü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
-  |account.password_length|_ konfigurieren.
-
-.. _account.sieve:
-
-``sieve (Vorgabe: true)`` : *Boolean*
-  Bestimmt, ob sich neu angelegte Benutzer per ManageSieve anmelden können
-  sollen.
-
-.. _account.smtp:
-
-``smtp (Vorgabe: true)`` : *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
----
-In der **bin**-Sektion werden die Pfade zu den von |vmm(1)|_ benötigten
-Binaries angegeben.
-
-.. _bin.dovecotpw:
-
-``dovecotpw (Vorgabe: /usr/sbin/dovecotpw)`` : *String*
-  Der absolute Pfad zum dovecotpw Binary. Geben Sie den absoluten Pfad zum
-  **doveadm**\(1) Binary an, falls Sie Dovecot v2.0 verwenden. Dieses Binary
-  wird zur Hash-Erzeugung verwendet, wenn |misc.password_scheme|_ einen der
-  nachfolgenden Werte hat: 'CRAM-MD5', 'HMAC-MD5', 'LANMAN', 'OTP' 'RPA'
-  oder 'SKEY'. Dieses Binary wird auch benötigt, wenn Ihre
-  Python-Installation einen der folgenden Hash-Algorithmen nicht
-  unterstützt:
-
-  * md4 (hashlib + OpenSSL oder PyCrypto) verwendet für die
-    Passwort-Schemen: 'PLAIN-MD4' und 'NTLM'
-  * sha256 (hashlib oder PyCrypto >= 2.1.0alpha1) verwendet für die
-    Passwort-Schemen: 'SHA256' und 'SSHA256'
-  * sha512 (hashlib) verwendet für die Passwort-Schemen: 'SHA512' und
-    'SSHA512'
-
-.. _bin.du:
-
-``du (Vorgabe: /usr/bin/du)`` : *String*
-  Der absolute Pfad zu **du**\(1). Dieses Binary wird verwendet, wenn die
-  Festplattenbelegung eines Kontos ermittelt wird.
-
-.. _bin.postconf:
-
-``postconf (Vorgabe: /usr/sbin/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
-
-
-DATABASE
---------
-Die **database**-Sektion wird verwendet, um die für den Datenbankzugriff
-benötigten Optionen festzulegen.
-
-.. _database.host:
-
-``host (Vorgabe: localhost)`` : *String*
-  Der Hostname oder die IP-Adresse des Datenbankservers.
-
-.. _database.module:
-
-``module (Vorgabe: psycopg2)`` : *String*
-  Das für den Datenbankzugriff zu verwendende Python PostgreSQL Adapter
-  Module. Unterstützte Module sind **psycopg2** und **pyPgSQL**.
-
-.. _database.name:
-
-``name (Vorgabe: mailsys)`` : *String*
-  Der Name der zu verwendenden Datenbank.
-
-.. _database.pass:
-
-``pass (Vorgabe: Nichts)`` : *String*
-  Das Passwort des Datenbank-Benutzers.
-
-.. _database.port:
-
-``port (Vorgabe: 5432)`` : *Int*
-  Der TCP-Port, auf dem der Datenbankserver Verbindungen annimmt.
-
-.. _database.sslmode:
-
-``sslmode (Vorgabe: prefer)`` : *String*
-  Bestimmt, ob und mit welcher Priorität eine SSL-Verbindung mit dem
-  Datenbankserver ausgehandelt wird. Mögliche Werte sind: **disabled**,
-  **allow**, **prefer**, **require**, **verify-ca**, and **verify-full**.
-  Die Modi **verify-ca** und **verify-full** stehen seit PostgreSQL 8.4 zur
-  Verfügung.
-
-  Diese Option wird ignoriert, wenn das *modul* pyPgSQL verwendet wird.
-
-.. _database.user:
-
-``user (Vorgabe: Nichts)`` : *String*
-  Der Name des Datenbank-Benutzers.
-
-Beispiel::
-
-  [database]
-  host = dbsrv8.example.net
-  port 5433
-  sslmode = require
-  user = vmm
-  pass = PY_SRJ}L/0p-oOk
-  name = mailsys
-
-
-DOMAIN
-------
-In der **domain**-Sektion werden Domain-spezifische Informationen
-konfiguriert.
-
-.. _domain.auto_postmaster:
-
-``auto_postmaster (Vorgabe: true)`` : *Boolean*
-  Ist der Wert dieser Option *true*, wird |vmm(1)|_ beim Anlegen einer
-  Domain (|domainadd|_) automatisch einen postmaster-Account erstellen.
-
-.. _domain.delete_directory:
-
-``delete_directory (Vorgabe: false)`` : *Boolean*
-  Bestimmt, ob beim Löschen einer Domain (|domaindelete|_) das Verzeichnis
-  der zu löschenden Domain, inklusive aller Anwender-Verzeichnisse, rekursiv
-  gelöscht werden soll.
-
-.. _domain.directory_mode:
-
-``directory_mode (Vorgabe: 504)`` : *Int*
-  Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis 10).
-
-  | Beispiel: 'drwxrwx---' -> oktal 0770 -> dezimal 504
-
-.. _domain.force_deletion:
-
-``force_deletion (Vorgabe: false)`` : *Boolean*
-  Erzwingt das Löschen aller zugeordneten Konten und Aliase beim Löschen
-  einer Domain (|domaindelete|_).
-
-Beispiel::
-
-  [domain]
-  auto_postmaster = true
-  delete_directory = false
-  directory_mode = 504
-  force_deletion = false
-
-
-MAILBOX
--------
-In der **mailbox**-Sektion werden die für die Erstellung von Mailboxen
-erforderlichen Optionen festgelegt. Die INBOX wird in jedem Fall erstellt.
-
-.. _mailbox.folders:
-
-``folders (Vorgabe: Drafts:Sent:Templates:Trash)`` : *String*
-  Eine durch Doppelpunkten getrennte Liste mit Mailboxnamen die
-  erstellt werden sollen. Sollen keine zusätzlichen Mailboxen angelegt werden,
-  ist dieser Optionen ein einzelner Doppelpunkt ('**:**') als Wert zuzuweisen.
-
-  Sollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist ein
-  einzelner Punkt ('**.**') als Separator zu verwenden.
-
-  Sollen Mailboxen mit internationalisierten Namen erstellt werden (zum
-  Beispiel: 'Wysłane' oder 'Gelöschte Objekte'), ist der Name UTF-8 kodiert
-  anzugeben. |vmm(1)|_ wird die internationalisierten Mailboxnamen in eine
-  modifizierten Variante des UTF-7-Zeichensatzes (siehe auch: :RFC:`3501`,
-  Sektion 5.1.3) konvertieren.
-
-.. _mailbox.format:
-
-``format (Vorgabe: maildir)`` : *String*
-  Das zu verwendende Format der Mailbox der Benutzer. Abhängig von der
-  verwendeten Dovecot-Version, stehen bis zu drei Formate zur Verfügung:
-
-    ``maildir``
-      seit Dovecot v1.0.0
-    ``mdbox``
-      seit Dovecot v2.0.beta5
-    ``sdbox``
-      seit Dovecot v2.0.rc3
-
-.. _mailbox.root:
-
-``root (Vorgabe: Maildir)`` : *String*
-  Name des Mailbox-Wurzelverzeichnisses im Home-Verzeichnis des jeweiligen
-  Benutzers. Übliche Namen, je nach verwendetem |mailbox.format|_, sind:
-  **Maildir**, **mdbox** oder **sdbox**.
-
-.. _mailbox.subscribe:
-
-``subscribe (Vorgabe: true)`` : *Boolean*
-  Wenn dieser Option der Wert **true** zugewiesen wurde, werden die, gemäß
-  |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
-  **false** zu.
-
-Beispiel::
-
-  [mailbox]
-  folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
-  format = maildir
-  root = Maildir
-  subscribe = false
-
-
-MISC
-----
-In der **misc**-Sektion werden verschiedene Einstellungen festgelegt.
-
-.. _misc.base_directory:
-
-``base_directory (Vorgabe: /srv/mail)`` : *String*
-  Alle Domain-Verzeichnisse werden innerhalb dieses Basis-Verzeichnisses
-  angelegt.
-
-.. _misc.crypt_blowfish_rounds:
-
-``crypt_blowfish_rounds (Vorgabe: 5)`` : *Int*
-  Anzahl der Verschlüsselungsdurchgänge für das *password_scheme*
-  **BLF-CRYPT**.
-
-  Der Wert muss im Bereich von **4** - **31** liegen.
-
-.. _misc.crypt_sha256_rounds:
-
-``crypt_sha256_rounds (Vorgabe: 5000)`` : *Int*
-  Anzahl der Verschlüsselungdurchgänge für das *password_scheme*
-  **SHA256-CRYPT**.
-
-  Der Wert muss im Bereich von **1000** - **999999999** liegen.
-
-.. _misc.crypt_sha512_rounds:
-
-``crypt_sha512_rounds (Vorgabe: 5000)`` : *Int*
-  Anzahl der Verschlüsselungsdurchgänge für das *password_scheme*
-  **SHA256-CRYPT**.
-
-  Der Wert muss im Bereich von **1000** - **999999999** liegen.
-
-.. _misc.password_scheme:
-
-``password_scheme (Vorgabe: CRAM-MD5)`` : *String*
-  Das zu verwendende Passwort-Schema. Um eine Liste aller verfügbaren
-  Passwort-Schemata zu erhalten, für Sie das Kommando **dovecotpw -l**
-  (Dovecot v1.x) oder **doveadm pw -l** (Dovecot v2.0) aus.
-
-.. _misc.quota_bytes:
-
-``quota_bytes (Vorgabe: 0)`` : *String*
-  Quota Limit in Bytes. 0 bedeutet unbegrenzt. Dieses Limit wird bei allen
-  neu angelegten Domains angewendet.
-
-  Der Wert dieser Option kann als Integer-Wert, zum Beispiel **20480**
-  geschrieben werden. Es ist auch möglich dem Wert eines der folgenden
-  Suffixe anzuhängen: **b** (Bytes), **k** (Kilobytes), **M** (Megabytes)
-  oder **G** (Gigabytes).
-  **1024** entspricht **1024b** oder **1k**.
-
-.. _misc.quota_messages:
-
-``quota_messages (Vorgabe: 0)`` : *Int*
-  Quota Limit als Anzahl von Nachrichten. 0 bedeutet unbegrenzt. Dieses
-  Limit wird bei allen neu angelegten Domains angewendet.
-
-.. _misc.transport:
-
-``transport (Vorgabe: dovecot:)`` : *String*
-  Der Standard-Transport aller Domains und Konten. Siehe auch:
-  |transport(5)|_
-
-.. _misc.dovecot_version:
-
-``dovecot_version (Vorgabe: Nichts)`` : *String*
-  Die eingesetzten Dovecot-Version. (siehe: **dovecot --version**).
-
-  Wenn das Kommando **dovecot --version** zum Beispiel
-  *2.0.beta4 (8818db00d347)* ausgibt, ist dieser Option der Wert
-  **2.0.beta4** zuzuweisen.
-
-Beispiel::
-
-  [misc]
-  base_directory = /srv/mail
-  crypt_sha512_rounds = 10000
-  password_scheme = SHA512-CRYPT
-  transport = dovecot:
-  dovecot_version = 2.0.beta4
-  quota_bytes = 100M
-  quota_messages = 10000
-
-
-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)|_
-
-
-COPYING
-=======
-vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschrieben
-und sind unter den Bedingungen der BSD Lizenz lizenziert.
-
-.. include:: ../../substitute_links.rst
-.. include:: ../../substitute_links_5.rst

--- a/man/substitute_links.rst	Wed Oct 26 03:20:40 2011 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,20 +0,0 @@
-.. set references to other manpages and set links in the html output
-
-.. |vmm(1)| replace:: **vmm**\(1)
-.. _vmm(1): vmm.1
-
-.. |vmm.cfg(5)| replace:: **vmm.cfg**\(5)
-.. _vmm.cfg(5): vmm.cfg.5
-
-
-.. non vmm
-
-.. |postconf(1)| replace:: **postconf**\(1)
-.. _postconf(1): http://www.postfix.org/postconf.1.html
-
-.. |transport(5)| replace:: **transport**\(5)
-.. _transport(5): http://www.postfix.org/transport.5.html
-
-.. |today| date::
-.. #EOF
-

--- a/man/substitute_links_1.rst	Wed Oct 26 03:20:40 2011 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,20 +0,0 @@
-.. Substitutions in section 1
-
-.. |account.disk_usage| replace:: `account.disk_usage`
-.. _account.disk_usage: vmm.cfg.5#account-disk-usage
-.. |account.random_password| replace:: `account.random_password`
-.. _account.random_password: vmm.cfg.5#account-random-password
-
-.. |domain.auto_postmaster| replace:: `domain.auto_postmaster`
-.. _domain.auto_postmaster: vmm.cfg.5#domain-auto-postmaster
-.. |domain.force_deletion| replace:: `domain.force_deletion`
-.. _domain.force_deletion: vmm.cfg.5#domain-force-deletion
-
-.. |misc.quota_bytes| replace:: `misc.quota_bytes`
-.. _misc.quota_bytes: vmm.cfg.5#misc-quota-bytes
-.. |misc.quota_messages| replace:: `misc.quota_messages`
-.. _misc.quota_messages: vmm.cfg.5#misc-quota-messages
-.. |misc.transport| replace:: `misc.transport`
-.. _misc.transport: vmm.cfg.5#misc-transport
-
-.. #EOF

--- a/man/substitute_links_5.rst	Wed Oct 26 03:20:40 2011 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,33 +0,0 @@
-.. Substitutions in section 5
-
-.. |account.password_length| replace:: **password_length**
-.. |mailbox.folders| replace:: **folders**
-.. |mailbox.format| replace:: **format**
-.. |misc.crypt_sha256_rounds| replace:: **crypt_sha256_rounds**
-.. |misc.crypt_sha512_rounds| replace:: **crypt_sha512_rounds**
-.. |misc.password_scheme| replace:: **misc.password_scheme**
-
-.. |vmm configure| replace:: **vmm configure**
-.. _`vmm configure`: vmm.1#configure
-
-.. |domainadd| replace:: **domainadd**
-.. _domainadd: vmm.1#domainadd
-
-.. |domaindelete| replace:: **domaindelete**
-.. _domaindelete: vmm.1#domaindelete
-
-.. |useradd| replace:: **useradd**
-.. _useradd: vmm.1#useradd
-
-.. |userdelete| replace:: **userdelete**
-.. _userdelete: vmm.1#userdelete
-
-.. |userinfo| replace:: **userinfo**
-.. _userinfo: vmm.1#userinfo
-
-.. non vmm
-.. |virtual_alias_expansion_limit| replace:: `virtual_alias_expansion_limit`
-.. _virtual_alias_expansion_limit: 
-   http://www.postfix.org/postconf.5.html#virtual_alias_expansion_limit
-
-.. #EOF