# HG changeset patch # User Pascal Volk # Date 1319599537 0 # Node ID 3ca31d080432816ffb28b19d86fd5f08692c6233 # Parent c2543ddde9f503e715cf96b3d0a42b1e9a8a4af5 man: Removed reStructuredText files. diff -r c2543ddde9f5 -r 3ca31d080432 man/de/man1/vmm.1.rst --- 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 -: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 diff -r c2543ddde9f5 -r 3ca31d080432 man/de/man5/vmm.cfg.5.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 -: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 diff -r c2543ddde9f5 -r 3ca31d080432 man/substitute_links.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 - diff -r c2543ddde9f5 -r 3ca31d080432 man/substitute_links_1.rst --- 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 diff -r c2543ddde9f5 -r 3ca31d080432 man/substitute_links_5.rst --- 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