# HG changeset patch # User Pascal Volk # Date 1357496120 0 # Node ID 5dba8063b70804dc20aef5e8792d77997fbe3dc2 # Parent 6287cf6c6447067711c4eee82baed12b620843fc man: Deleted German manual pages. diff -r 6287cf6c6447 -r 5dba8063b708 man/de/man1/vmm.1 --- a/man/de/man1/vmm.1 Sun Jan 06 18:11:49 2013 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1089 +0,0 @@ -.TH "VMM" "1" "2012-09-27" "vmm 0.6" "vmm" -.SH NAME -vmm \- Kommandozeilenprogramm zur Verwaltung von E\-Mail\-Domains/\-Konten -und \-Aliase. -.\" ----------------------------------------------------------------------- -.SH ÜBERSICHT -.B vmm -.IR Unterbefehl " [" "Argument ..." ] -.\" ----------------------------------------------------------------------- -.SH BESCHREIBUNG -.B vmm -(a virtual mail manager) ist das einfach zu bedienende -Kommandozeilenprogramm für Administratoren und Postmaster, zur Verwaltung -von (Alias\-) Domains, Konten, Alias\-Adressen und sogenannten Relocated -Users. -Es ermöglicht die schnelle und einfache Verwaltung des Mailservers. -.br -Es wurde für Dovecot und Postfix mit einem PostgreSQL\-Backend entwickelt. -.PP -Von jedem -.I 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. -.PP -Die meisten -.IR Unterbefehl e -erwarten ein oder mehrere -.IR Argument e. -.\" ----------------------------------------------------------------------- -.SH ARGUMENTE -.TP 12 -.I address -Die komplette E\-Mail\-Adresse -.RI ( local\-part @ fqdn ) -eines Kontos, Aliases oder Relocated Users. -.\" -------------------------- -.TP -.I destination -Ist entweder eine E\-Mail\-Adresse, wenn sie in Verbindung mit -.I "ALIAS UNTERBEFEHLEN" -verwendet wird, oder ein -.I fqdn -in Verbindung mit -.IR "ALIASDOMAIN UNTERBEFEHLEN" . -.\" -------------------------- -.TP -.I fqdn -Der voll qualifizierten Domain\-Namen \(em ohne den abschließenden Punkt -\(em einer Domain oder Alias\-Domain. -.\" -------------------------- -.TP -.I messages -Ein Integer\-Wert, der das maximal nutzbare Kontingent als Anzahl von -Nachrichten festlegt. -.br -Der Wert -.B 0 -(null) bedeutet unbegrenzt \(em kein Quota\-Limit als Anzahl von -Nachrichten. -.\" -------------------------- -.TP -.I option -ist der Name einer Konfigurationsoption mit vorangestellter -Konfigurations\-Sektion, getrennt durch einen Punkt. -Zum Beispiel: -.IB misc . transport -.br -Alle Konfigurationsoptionen werden in -.BR vmm.cfg (5) -beschrieben. -.\" -------------------------- -.TP -.I service -Der Name eines Services, der gewöhnlicherweise in Verbindung mit Dovecot -genutzt wird. -Folgende Services werden unterstützt: -.BR imap ", " pop3 ", " sieve " und " smtp . -.\" -------------------------- -.TP -.I storage -Bestimmt das maximal nutzbare Kontingent in Bytes. -Eines der folgenden Präfixe kann dem dem ganzzahligen Wert angehängt -werden: -.BR b " (Bytes), " k " (Kilobytes), " M " (Megabytes) oder " G -(Gigabytes). -.br -Der Wert -.B 0 -(null) bedeutet unbegrenzt \(em kein Quota\-Limit in Bytes. -.\" -------------------------- -.TP -.I transport -ein Transport für Postfix, angegeben in der Form: -.IB transport : -oder -.IB transport :\c -.IR nexthop . -Siehe -.BR transport (5) -für weitere Details. -.\" ----------------------------------------------------------------------- -.SH ALLGEMEINE UNTERBEFEHLE -.SS configget (cg) -.BI "vmm configget" " option" -.PP -Dieser Unterbefehl wird verwendet, um den aktuellen Wert der übergebenen -.I option -anzuzeigen. -.PP -Beispiel: -.PP -.nf -.B vmm configget misc.crypt_sha512_rounds -misc.crypt_sha512_rounds = 5000 -.fi -.\" -------------------------- -.SS configset (cs) -.B vmm configset -.I option value -.PP -Verwenden Sie diesen Unterbefehl, um einer einzelnen Konfigurationsoption -einen neuen Wert zuzuweisen. -.I option -ist der Name der Konfigurationsoption, -.I value -ist der Wert, der der Konfigurationsoption zugewiesen wird. -.IP Hinweis: -Diese Unterbefehl erstellt eine neue -.IR vmm.cfg , -ohne Kommentare. -Die aktuelle Konfigurationsdatei wird als -.IR vmm.cfg.bak -gesichert. -.PP -Beispiel: -.PP -.nf -.B vmm configget domain.transport -domain.transport = dovecot: -.B vmm configset domain.transport lmtp:unix:private/dovecot\-lmtp -.B vmm cg domain.transport -domain.transport = lmtp:unix:private/dovecot\-lmtp -.fi -.\" ------------------------------------ -.SS configure (cf) -.B vmm configure -.RI [ section ] -.PP -Startet die interaktiven Konfiguration für alle Konfigurationssektionen. -.PP -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. -.PP -Wurde das optionale Argument -.I section -angegeben, werden nur die Optionen der angegebenen Sektion angezeigt und -können geändert werden. -Folgende Sektionen sind vorhanden: -.RS -.TP 10 -.B account -Konto Einstellungen -.TP -.B bin -Pfade zu externen Binär\-Dateien -.TP -.B database -Datenbank Einstellungen -.TP -.B domain -Domain Einstellungen -.TP -.B mailbox -Mailbox Einstellungen -.TP -.B misc -Verschiedene Einstellungen -.RE -.PP -Die Konfigurationsoptionen werden in -.BR vmm.cfg (5) -beschrieben. -.IP Hinweis: -Diese Unterbefehl erstellt eine neue -.IR vmm.cfg , -ohne Kommentare. -Die aktuelle Konfigurationsdatei wird als -.IR vmm.cfg.bak -gesichert. -.PP -Beispiel: -.PP -.nf -.B vmm configure mailbox -Konfigurationsdatei wird verwendet: /root/vmm.cfg - -* Konfigurationsabschnitt: »mailbox« -Neuer Wert für Option folders [Drafts:Sent:Templates:Trash]: -Neuer Wert für Option format [maildir]: mdbox -Neuer Wert für Option subscribe [True]: -Neuer Wert für Option root [Maildir]: mdbox -.fi -.\" ------------------------------------ -.SS getuser (gu) -.BI "vmm getuser" " uid" -.PP -Wenn nur der -.I uid -eines Benutzers vorhanden ist, zum Beispiel aus der Prozessliste, kann mit -dem Unterbefehl -.B getuser -die E\-Mail\-Adresse des Benutzers ermittelt werden. -.PP -Beispiel: -.PP -.nf -.B vmm getuser 79876 -Konto Informationen -------------------- - UID............: 79876 - GID............: 70704 - Address........: a.user@example.com -.fi -.\" ------------------------------------ -.SS help (h) -.B vmm help -.RI [ subcommand ] -.PP -Gibt ein Liste aller vorhandenen Unterbefehle mit einer kurzen Beschreibung -aus. -Wurde ein -.I subcommand -angegeben, wird Hilfe zu diesem Unterbefehl ausgegeben. -Danach wird -.B vmm -beendet. -.\" ------------------------------------ -.SS listdomains (ld) -.B vmm listdomains -.RI [ pattern ] -.PP -Dieser Unterbefehl listet alle angelegten 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. -.PP -Um eine Wildcard\-Suche durchzuführen kann das %\-Zeichen am Anfang -und/oder Ende des Musters verwendet werden. -.PP -Beispiel: -.PP -.nf -.B vmm listdomains %example% -Übereinstimmende Domains ------------------------- - [+] example.com - [\-] e.g.example.com - [\-] example.name - [+] example.org - [+] sales.example.com -.fi -.\" ------------------------------------ -.SS listaddresses (ll) -.B vmm listaddresses -.RI [ pattern ] -.PP -Verwenden Sie diesen Unterbefehl, um alle Adressen anzuzeigen. -Einträge regulärer Domains werden mit einem '+' gekennzeichnet, Einträge -von Alias-Domains mit einem '-'. Zudem wird jedem Eintrag ein 'u', 'a', -oder 'r' vorangestellt, welche den Eintrag als Benutzerkonto, Alias oder -Relocated User identifizieren. -.PP -Mit dem optionalen Muster können Sie die Ausgabe einschränken. Akzeptiert -wird entweder eine Domain oder ein SQL-Muster (% als Wildcard). -.PP -Beispiel: -.PP -.nf -.B vmm listaddresses example.com -.B vmm listaddresses %master@% -.\" ------------------------------------ -.SS listaliases (la) -.B vmm listaliases -.RI [ pattern ] -.PP -Verwenden Sie diesen Unterbefehl, um alle Aliase anzuzeigen. Reguläre -Aliase werden mit einem '+' gekennzeichnet, Aliase in Alias-Domains mit -einem '-'. -.PP -Mit dem optionalen Muster können Sie die Ausgabe einschränken. Akzeptiert -wird entweder eine Domain oder ein SQL-Muster (% als Wildcard). -.PP -Beispiel: -.PP -.nf -.B vmm listaliases example.com -.B vmm listaliases %master@% -.\" ------------------------------------ -.SS listrelocated (lr) -.B vmm listrelocated -.RI [ pattern ] -.PP -Verwenden Sie diesen Unterbefehl, um alle Relocated Users anzuzeigen. -Einträge regulärer Domains werden mit einem '+' gekennzeichnet, Einträge -von Alias-Domains mit einem '-'. -.PP -Mit dem optionalen Muster können Sie die Ausgabe einschränken. Akzeptiert -wird entweder eine Domain oder ein SQL-Muster (% als Wildcard). -.PP -Beispiel: -.PP -.nf -.B vmm listrelocated example.com -.B vmm listrelocated %master@% -.\" ------------------------------------ -.SS listusers (lu) -.B vmm listusers -.RI [ pattern ] -.PP -Verwenden Sie diesen Unterbefehl, um alle Benutzerkonten anzuzeigen. -Reguläre Benutzerkonten werden mit einem '+' gekennzeichnet, Benutzerkonten -in Alias-Domains mit einem '-'. -.PP -Mit dem optionalen Muster können Sie die Ausgabe einschränken. Akzeptiert -wird entweder eine Domain oder ein SQL-Muster (% als Wildcard). -.PP -Beispiel: -.PP -.nf -.B vmm listusers example.com -.B vmm listusers %master@% -.\" ------------------------------------ -.SS listpwschemes (lp) -.B vmm listpwschemes -.PP -Dieser Unterbefehl listet alle unterstützte Passwort\-Schemen, die als Wert -für -.I misc.password_scheme -in der -.I vmm.cfg -verwendet werden können. -Die Ausgabe variiert, je nach eingesetzter Dovecot Version und der libc des -Systems. -.br -Sollte Ihre Dovecot\-Installation nicht zu alt sein, werden zusätzlich -die verwendbaren Encoding\-Suffixe ausgegeben. -Eines dieser Suffixe kann an das Passwort\-Schema angefügt werden. -.PP -Beispiel: -.PP -.nf -.B vmm listpwschemes -Verfügbare Passwort-Schemata ----------------------------- - CRYPT SHA512-CRYPT LDAP-MD5 DIGEST-MD5 SHA256 SHA512 SSHA512 - SKEY SSHA NTLM RPA MD5-CRYPT HMAC-MD5 SHA1 PLAIN SHA CRAM-MD5 - SSHA256 MD5 LANMAN CLEARTEXT PLAIN-MD5 PLAIN-MD4 OTP SMD5 - SHA256-CRYPT - -Verwendbare Encoding-Suffixe ----------------------------- - .B64 .BASE64 .HEX -.fi -.\" ------------------------------------ -.SS version (v) -.B vmm version -.PP -Gibt Versions\- und Copyright\-Informationen zu -.B vmm -aus. -Danach wird -.B vmm -beendet. -.\" ----------------------------------------------------------------------- -.SH DOMAIN UNTERBEFEHLE -.SS domainadd (da) -.B vmm domainadd -.IR fqdn " [" transport ] -.PP -Fügt eine neue Domain in die Datenbank ein und erstellt das -Domain\-Verzeichnis. -.PP -Wurde das optional Argument -.I transport -angegeben, ersetzt der angegebene Transport den konfigurierten Transport -.RI ( misc.transport ") aus " vmm.cfg . -Der angegebene -.I transport -ist der Vorgabe\-Transport für alle Konten, die dieser Domain zugeordnet -werden. -.PP -Konfigurationsbezogenes Verhalten: -.RS -.TP -.I domain.auto_postmaster -Wenn diese Option den Wert -.B true -(Vorgabe) hat, wird -.B vmm -nach erfolgreichem Anlegen der Domain auch das Konto für -.BI postmaster@ fqdn -erstellen. -.TP -.I account.random_password -Sollte dieser Option ebenfalls der Wert -.B true -zugewiesen sein, wird ein zufällig generiertes Passwort für den -Postmaster\-Account gesetzt und auf stdout ausgegeben. -.RE -.PP -Beispiele: -.PP -.nf -.B vmm domainadd support.example.com smtp:[mx1.example.com]:2025 -Konto für postmaster@support.example.com wird angelegt -Neues Passwort eingeben: -Neues Passwort wiederholen: -.B vmm cs account.random_password true -.B vmm domainadd vertrieb.example.com -Konto für postmaster@vertrieb.example.com wird angelegt -Erzeugtes Passwort: YoG3Uw*5aH -.fi -.\" ------------------------------------ -.SS domaindelete (dd) -.BI "vmm domaindelete " fqdn -.RB [ force ] -.PP -Dieser Unterbefehl löscht die Domain mit dem angegebenen -.IR fqdn . -.PP -Sollten der zu löschenden Domain Konten, Aliase und/oder Relocated User -zugeordnet sein, wird -.B vmm -die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden. -Sollten Sie sich Ihres Vorhabens sicher sein, so kann optional das -Schlüsselwort -.B force -angegeben werden. -.PP -Sollten Sie wirklich immer wissen was Sie tun, so editieren Sie Ihre -.I vmm.cfg -und setzen den Wert der Option -.I domain.force_deletion -auf -.BR true . -Dann werden Sie zukünftig beim Löschen von Domains nicht mehr wegen -vorhanden Konten, Aliase und/oder Relocated User gewarnt. -.\" ------------------------------------ -.SS domaininfo (di) -.B vmm domaininfo -.IR fqdn \ [ details ] -.PP -Dieser Unterbefehl zeigt Informationen zur Domain mit dem angegebenen -.I fqdn -an. -.PP -Um detaillierte Informationen über die Domain zu erhalten, kann das -optionale Argument -.I details -angegeben werden. -Ein möglicher Wert für -.I details -kann eines der folgenden sechs Schlüsselwörter sein: -.RS -.TP 13 -.B accounts -um alle eingerichteten Konten aufzulisten -.TP -.B aliasdomains -um alle zugeordneten Alias\-Domains aufzulisten -.TP -.B aliases -um alle vorhandenen Alias\-Adressen aufzulisten -.TP -.B catchall -um alle Catch\-all\-Ziele aufzulisten -.TP -.B relocated -um alle Adressen der Relocated Users aufzulisten -.TP -.B full -um alle oben genannten Informationen aufzulisten -.RE -.PP -Beispiel: -.PP -.nf -.B vmm domaininfo sales.example.com -Domain Informationen --------------------- - Domain Name......: sales.example.com - GID..............: 70708 - Domain Directory.: /srv/mail/c/70708 - Quota Limit/User.: Storage: 500,00 MiB; Messages: 10.000 - Active Services..: IMAP SIEVE - Transport........: lmtp:unix:private/dovecot-lmtp - Alias Domains....: 0 - Accounts.........: 1 - Aliases..........: 0 - Relocated........: 0 - Catch-All Dests..: 1 -.fi -.\" ------------------------------------ -.SS domainquota (dq) -.B vmm domainquota -.IR "fqdn storage" " [" messages ] -.RB [ force ] -.PP -Dieser Unterbefehl wird verwendet, um für die Konten der Domain ein neues -Quota\-Limit festzulegen. -.PP -Standardmäßig gilt für Konten das Quota\-Limit der -.IR vmm.cfg " (" domain.quota_bytes " und " domain.quota_messages ). -Das neue Quota\-Limit gilt für für alle bestehenden Konten, die nicht selbst -ein Quota\-Limit definieren. Soll das neue Quota\-Limit auch für Konten mit -eigenen Limiten angewendet werden, so ist das optionale Schlüsselwort -.B force -anzugeben. -.br -Wenn der Wert für das Argument -.I messages -ausgelassen wurde, wird der Vorgabewert -.B 0 -(null) als Anzahl von Nachrichten angewendet werden. -.PP -Beispiel: -.PP -.nf -.B vmm domainquota example.com 1g force -.fi -.\" ------------------------------------ -.SS domainservices (ds) -.B vmm domainservices -.IR fqdn " [" "service ..." ] -.RB [ force ] -.PP -Um festzulegen, welche Services für die Anwender der Domain \(em mit dem -angegebenen -.I fqdn -\(em nutzbar sein sollen, wird dieser Unterbefehl verwendet. -.PP -Der Zugriff auf alle genannten Services wird den Anwender gestattet. -Der Zugriff auf nicht genannte Services wird verweigert werden. -Verwendbare -.IR service \-Namen -sind: -.BR imap ", " pop3 ", " sieve " und " smtp . -.br -Wird das Schlüsselwort -.B force -angegeben, so werden alle kontospezifischen Einstellungen gelöscht und es -gelten fortan die Service\-Einstellungen der Domain für alle Konten. Ohne -dieses Schlüsselwort gelten die neuen Einstellungen nur für Konten, bei denen -die Service\-Einstellungen nicht individuell geändert wurden. -.\" ------------------------------------ -.SS domaintransport (dt) -.BI "vmm domaintransport" " fqdn transport" -.RB [ force ] -.PP -Ein neuer -.I transport -für die Domain mit dem angegebenen -.I fqdn -kann mit diesem Unterbefehl festgelegt werden. -.PP -Wird das Schlüsselwort -.B force -angegeben, so werden alle kontospezifischen Einstellungen gelöscht und es -gelten fortan die Transport\-Einstellungen der Domain für alle Konten. Ohne -dieses Schlüsselwort gelten die neuen Einstellungen nur für Konten, bei denen -die Transport\-Einstellungen nicht individuell geändert wurden. -.PP -Beispiel: -.PP -.nf -.B vmm domaintransport support.example.com dovecot: -.fi -.\" ------------------------------------ -.SS domainnote (do) -.BI "vmm domainnote" " fqdn" -.RI [ note ] -.PP -Mit diesem Unterbefehl kann eine Domain mit einer Notiz versehen werden. Um -die Notiz wieder zu löschen, läßt man sie einfach weg. -.PP -Beispiel: -.PP -.nf -.B vmm do example.com Gehört Robert -.fi -.\" ----------------------------------------------------------------------- -.SH ALIAS\-DOMAIN UNTERBEFEHLE -Eine Alias\-Domain ist ein Alias für eine Domain, die zuvor mit dem -Unterbefehl -.B domainadd -erstellt wurde. -Alle Konten, Aliase und Relocated Users der Domain sind ebenfalls unter der -Alias\-Domain verfügbar. -.br -Im Folgenden wird angenommen, example.net sei ein Alias für example.com. -.PP -Postfix wird nicht erst fälschlicherweise E\-Mails für -unbekannten.user@example.net annehmen und später an den \(em oftmals -gefälschten \(em Absender bouncen. -Postfix wird E\-Mails an unbekannte Empfänger sofort ablehnen. -.br -Dieses Verhalten ist sichergestellt, solange die empfohlenen -Datenbankabfragen in -.I $config_directory/pgsql\-*.cf -konfiguriert sind. -.\" ------------------------------------ -.SS aliasdomainadd (ada) -.BI "vmm aliasdomainadd" " fqdn destination" -.PP -Dieser Unterbefehl legt die Alias\-Domain -.RI ( fqdn ) -als Alias für eine bestehende Domain -.RI ( destination ") an." -.PP -Beispiel: -.PP -.nf -.B vmm aliasdomainadd example.net example.com -.fi -.\" ------------------------------------ -.SS aliasdomaindelete (add) -.BI "vmm aliasdomaindelete" " fqdn" -.PP -Verwenden Sie diesen Unterbefehl, um die Alias\-Domain -.I fqdn -zu löschen. -.PP -Beispiel: -.PP -.nf -.B vmm aliasdomaindelete e.g.example.com -.fi -.\" ------------------------------------ -.SS aliasdomaininfo (adi) -.BI "vmm aliasdomaininfo" " fqdn" -.PP -Dieser Unterbefehl gibt Informationen darüber aus, welcher Domain die -Alias\-Domain -.I fqdn -aktuell zugeordnet ist. -.PP -Beispiel: -.PP -.nf -.B vmm adi example.net -Alias\-Domain Informationen --------------------------- - Die Alias\-Domain example.net gehört zu: - * example.com -.fi -.\" ------------------------------------ -.SS aliasdomainswitch (ads) -.BI "vmm aliasdomainswitch" " fqdn destination" -.PP -Wenn Sie die bereits vorhandene Alias\-Domain -.I fqdn -einer anderen Ziel\-Domain zuordnen wollen, verwenden Sie diesen -Unterbefehl. -.PP -Beispiel: -.PP -.nf -.B vmm aliasdomainswitch example.net example.org -.fi -.\" ----------------------------------------------------------------------- -.SH KONTO UNTERBEFEHLE -.SS useradd (ua) -.B vmm useradd -.IR address " [" password ] -.PP -Mit diesem Unterbefehl wird ein neues Konto für die angegebene Adresse -angelegt. -.PP -Wurde kein Passwort angegeben wird -.B vmm -dieses im interaktiven Modus erfragen. -Falls kein Passwort angegeben wurde und -.I account.random_password -den Wert -.B true -hat, wird -.B vmm -ein zufälliges Passwort generieren und auf stdout ausgeben, nachdem das -Konto angelegt wurde. -.PP -Beispiele: -.PP -.nf -.B vmm ua d.user@example.com \(dqA 5ecR3t P4s5\(rs/\(rs/0rd\(dq -.B vmm useradd e.user@example.com -Neues Passwort eingeben: -Neues Passwort wiederholen: -.fi -.\" ------------------------------------ -.SS userdelete (ud) -.BI "vmm userdelete" " address" -.RB [ force ] -.PP -Verwenden Sie diesen Unterbefehl, um das Konto mit der angegebenen Adresse -zu löschen. -.PP -Sollte es einen oder mehrere Aliase geben, deren Ziel\-Adresse mit der -Adresse des zu löschenden Kontos identisch ist, wird -.B vmm -die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden. -Um dieses zu umgehen, kann das optionale Schlüsselwort -.B force -angegebenen werden. -.\" ------------------------------------ -.SS userinfo (ui) -.B "vmm userinfo" -.IR address " [" details ] -.PP -Dieser Unterbefehl zeigt einige Informationen über das Konto mit der -angegebenen Adresse an. -.PP -Wurde das optionale Argument -.I details -angegeben, werden weitere Informationen ausgegeben. -Mögliche Werte für -.I details -sind: -.RS -.TP 8 -.B aliases -um alle Alias\-Adressen, mit dem Ziel -.IR address , -aufzulisten -.TP -.B du -um zusätzlich die Festplattenbelegung des Mail\-Verzeichnisses eines Kontos -anzuzeigen. -Soll die Festplattenbelegung jedes Mal mit der -.B userinfo -ermittelt werden, ist in der -.I vmm.cfg -der Wert der Option -.I account.disk_usage -auf -.B true -zu setzen. -.TP -.B full -um alle oben genannten Informationen anzuzeigen -.RE -.PP -Beispiel: -.PP -.nf -.B vmm userinfo d.user@example.com -Konto Informationen -------------------- - Address..........: d.user@example.com - Name.............: None - UID..............: 79881 - GID..............: 70704 - Home.............: /srv/mail/2/70704/79881 - Mail_Location....: mdbox:~/mdbox - Quota Storage....: [ 0,00%] 0/500,00 MiB - Quota Messages...: [ 0,00%] 0/10.000 - Transport........: lmtp:unix:private/dovecot-lmtp - SMTP.............: deaktiviert - POP3.............: deaktiviert - IMAP.............: aktiviert - SIEVE............: aktiviert -.fi -.\" ------------------------------------ -.SS username (un) -.BI "vmm username" " address" -.RI [ name ] -.PP -Der bürgerliche Name des Kontoinhabers mit der angegebenen Adresse kann mit -diesem Unterbefehl gesetzt/aktualisiert werden. -.PP -Wird kein -.I name -übergeben, so wird der Wert in den Kontoinformationen gelöscht. -.PP -Beispiel: -.PP -.nf -.B vmm username d.user@example.com \(dqJohn Doe\(dq -.fi -.\" ------------------------------------ -.SS userpassword (up) -.BI "vmm userpassword" " address" -.RI [ password ] -.PP -Das Passwort eines Kontos kann mit diesem Unterbefehl aktualisiert werden. -.PP -Wurde kein Passwort angegeben, wird -.B vmm -dieses im interaktiven Modus erfragen. -.PP -Beispiel: -.PP -.nf -.B vmm up d.user@example.com \(dqA |\(rs/|0r3 5ecur3 P4s5\(rs/\(rs/0rd?\(dq -.fi -.\" ------------------------------------ -.SS usernote (uo) -.BI "vmm usernote" " address" -.RI [ note ] -.PP -Mit diesem Unterbefehl kann ein Konto mit einer Notiz versehen werden. Um die -Notiz wieder zu löschen, läßt man sie einfach weg. -.PP -Beispiel: -.PP -.nf -.B vmm uo d.user@example.com Wird nur bis Ende Mai 2012 gebraucht -.fi -.\" ------------------------------------ -.SS userquota (uq) -.BI "vmm userquota" " address storage" -.RI [ messages ] -.PP -Um ein neues Quota\-Limit für das Konto mit der angegebenen Adresse -festzulegen, wird dieser Unterbefehl verwendet. -.PP -Wenn der Wert für das Argument -.I messages -ausgelassen wurde, wird der Vorgabewert -.B 0 -(null) als Anzahl von Nachrichten angewendet werden. -.PP -Anstelle der Limits, bewirkt das Wort -.BR domain , -dass die Limits des Kontos gelöscht wird und somit wieder der in der -Domain gespeicherte Wert für das Konto gilt. -.PP -Beispiel: -.PP -.nf -.B vmm userquota d.user@example.com 750m -.B vmm userquote d.user@example.com domain -.fi -.\" ------------------------------------ -.SS userservices (us) -.B vmm userservices -.IR address " [" "service ..." ] -.PP -Verwenden Sie diesen Unterbefehl, um einem Anwender den Zugriff auf die -genannten Services zu gestatten. -.PP -Der Zugriff auf alle nicht genannten Services wird dem Anwender, mit der -angegebenen Adresse, verwehrt werden. -.PP -Anstelle einer Liste, bewirkt das Wort -.BR domain , -dass die benutzerspezifische Liste gelöscht wird und somit wieder die in -der Domain gespeicherte Liste für das Konto gilt. -.PP -Beispiel: -.PP -.nf -.B vmm userservices d.user@example.com SMTP IMAP -.B vmm userservices d.user@example.com domain -.\" ------------------------------------ -.SS usertransport (ut) -.BI "vmm usertransport" " address transport" -.PP -Mit diesem Unterbefehl kann ein abweichender -.I transport -für das Konto mit der angegebenen Adresse bestimmt werden. -.PP -Wird als -.I transport -das Wort 'domain' übergeben, so wird der explizite Transport des Kontos -wieder gelöscht und der in der Domain gespeicherte Wert benutzt. -.PP -Beispiel: -.br -Angenommen, Sie wollen mit Dovecots -.BR dsync (1) -die E\-Mails vom Maildir\-Format ins mdbox\-Format konvertieren, dann -können Sie Postfix, über den Transport, darüber informieren, es später -nochmals zu versuchen. -.PP -.nf -.B vmm ut d.user@example.com \(dqretry:4.0.0 Mailbox being migrated\(dq -# Konvertieren der Mailbox … -# … danach den Transport auf den Domainwert setzen -.B vmm usertransport d.user@example.com domain -.fi -.\" ----------------------------------------------------------------------- -.SH ALIAS UNTERBEFEHLE -.SS aliasadd (aa) -.BI "vmm aliasadd" " address destination ..." -.PP -Mit diesem Unterbefehl werden neue Alias\-Adressen, mit einer oder mehren -.IR destination (en), -erstellt. -.PP -Innerhalb der Zieladresse werden die Zeichenketten -.IR %n , -.IR %d -und -.IR %= -durch den ursprünglichen lokalen Teil, die Domain bzw. die Emailadresse mit -'=' anstelle von '@' ersetzt. Dies ermöglicht z.B. in Verbindung mit -Alias\-Domains domain\-spezifische Empfänger. -.PP -Beispiele: -.PP -.nf -.B vmm aliasadd john.doe@example.com d.user@example.com -.B vmm aa support@example.com d.user@example.com e.user@example.com -.B vmm aa postmaster@example.com postmaster+%d@example.org -.fi -.\" ------------------------------------ -.SS aliasdelete (ad) -.BI "vmm aliasdelete" " address" -.RI [ destination " ...]" -.PP -Verwenden Sie diesen Unterbefehl um den Alias mit der angegebenen Adresse -zu löschen. -.PP -Wurden eine oder mehrere optionale -.I destination -Adressen angegeben, so werden nur diese -.IR destination s -vom angegebenen Alias entfernt. -.PP -Beispiel: -.PP -.nf -.B vmm aliasdelete support@example.com d.user@example.com -.fi -.\" ------------------------------------ -.SS aliasinfo (ai) -.BI "vmm aliasinfo" " address" -.PP -Informationen zum Alias mit der angegebenen Adresse können mit diesem -Unterbefehl ausgegeben werden. -.PP -Beispiel: -.PP -.nf -.B vmm aliasinfo support@example.com -Alias Informationen -------------------- - E\-Mails für support@example.com werden weitergeleitet an: - * e.user@example.com -.fi -.\" ----------------------------------------------------------------------- -.SH RELOCATED UNTERBEFEHLE -.SS relocatedadd (ra) -.BI "vmm relocatedadd" " address newaddress" -.PP -Um einen neuen Relocated User anzulegen kann dieser Unterbefehl verwendet -werden. -.PP -Dabei ist -.I address -die ehemalige Adresse des Benutzers, zum Beispiel b.nutzer@example.com, und -.I newaddress -die neue Adresse, unter der die/der Benutzer/in erreichbar ist. -.PP -Beispiel: -.PP -.nf -.B vmm relocatedadd b.nutzer@example.com b\-nutzer@firma.tld -.fi -.\" ------------------------------------ -.SS relocatedinfo (ri) -.BI "vmm relocatedinfo " address -.PP -Dieser Unterbefehl zeigt die neue Adresse des Relocated Users mit mit der -angegebenen Adresse. -.PP -Beispiel: -.PP -.nf -.B vmm relocatedinfo b.nutzer@example.com -Verschiebe\-Informationen ------------------------- - Der Benutzer »b.nutzer@example.com« wurde nach »b\-nutzer@firma.tld« verschoben -.fi -.\" ------------------------------------ -.SS relocateddelete (rd) -.BI "vmm relocateddelete " address -.PP -Mit diesem Unterbefehl kann der Relocated User mit der angegebenen Adresse -gelöscht werden. -.PP -Beispiel: -.PP -.nf -.B vmm relocateddelete b.nutzer@example.com -.fi -.\" ----------------------------------------------------------------------- -.SH CATCH\-ALL UNTERBEFEHLE -.SS catchalladd (caa) -.BI "vmm catchalladd" " fqdn destination ..." -.PP -Mit diesem Unterbefehl können für eine Domain Adressen definiert werden, an -die E\-Mails geleitet werden, die an nicht\-existente Adressen innerhalb -dieser Domains adressiert sind. -Diese Adressen \(dqfangen alle\(dq diese E\-Mails auf, es sei denn es -bestehen spezifischere Aliase, Mailboxen oder Relocated\-Einträge. -.PP -WARNUNG: Catch\-all Adressen können dazu führen, dass ein Mailserver von -Spam überflutet wird, da Spammer zuweilen gerne alle möglichen Emailadressen -ausprobieren und man auf einmal zig tausend Nachrichten gerichtet an -Adressen von abba@example.org bis zztop@example.org weitergeleitet bekommt. -.PP -Beispiel: -.PP -.nf -.B vmm catchalladd example.com b.nutzer@example.org -.fi -.\" ------------------------------------ -.SS catchallinfo (cai) -.BI "vmm catchallinfo " fqdn -.PP -Dieser Unterbefehl zeigt die für eine Domain definierten Catch\-all Aliase -an. -.PP -Beispiel: -.PP -.nf -.B vmm catchallinfo example.com -Catch-all Informationen ------------------------ - Nachrichten an unbekannte Adressen innerhalb der example.com Domäne werden - weitergeleitet an: - * b.nutzer@example.org -.fi -.\" ------------------------------------ -.SS catchalldelete (cad) -.BI "vmm catchalldelete " fqdn -.RI [ destination " ...]" -.PP -Mit diesem Unterbefehl werden Catch\-all Aliase einer Domain wieder -gelöscht, -entweder nur das/die angegebene(n) Alias(e), oder alle, wenn keine -.I destination -Adresse angegeben wurde. -.PP -Beispiel: -.PP -.nf -.B vmm catchalldelete example.com b.nutzer@example.org -.fi -.\" ----------------------------------------------------------------------- -.SH DATEIEN -.TP -.I /root/vmm.cfg -Wird verwendet, falls vorhanden. -.TP -.I /usr/local/etc/vmm.cfg -Wird verwendet, sollte obige Datei nicht gefunden werden. -.TP -.I /etc/vmm.cfg -Wird verwendet, falls die oben genannten Dateien nicht existieren. -.\" ----------------------------------------------------------------------- -.SH SIEHE AUCH -.BR dsync (1), -.BR transport (5), -.BR vmm.cfg (5) -.\" ----------------------------------------------------------------------- -.SH INTERNET RESSOURCEN -.TP -Homepage -http://vmm.localdomain.org/ -.TP -Projekt\-Seite -http://sf.net/projects/vmm/ -.TP -Bugtracker -https://bitbucket.org/pvo/vmm/issues -.\" ----------------------------------------------------------------------- -.SH COPYING -vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschrieben und sind unter den Bedingungen der -BSD Lizenz lizenziert. \ No newline at end of file diff -r 6287cf6c6447 -r 5dba8063b708 man/de/man5/vmm.cfg.5 --- a/man/de/man5/vmm.cfg.5 Sun Jan 06 18:11:49 2013 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,625 +0,0 @@ -.TH "VMM.CFG" "5" "2012-08-12" "vmm 0.6" "vmm" -.SH NAME -vmm.cfg \- Konfigurationsdatei für vmm -.\" ----------------------------------------------------------------------- -.SH ÜBERSICHT -vmm.cfg -.\" ----------------------------------------------------------------------- -.SH BESCHREIBUNG -.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. -Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden -ignoriert. -.PP -Jeder Wert ist von einem der folgenden Datentypen: -.PP -.TP 8 -.I Boolean -um festzulegen, ob etwas eingeschaltet/aktiviert (true) oder -ausgeschaltet/deaktiviert (false) ist. -.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. -.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 -[database] -user = ich -pass = xxxxxxxx - -[misc] -dovecot_version = 1.2.16 -.fi -.\" ----------------------------------------------------------------------- -.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 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). -.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 -.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.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. -.\" ------------------------------------ -.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. -.\" ----------------------------------------------------------------------- -.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. -.PP -Das Quota\-Limit (quota_bytes und quota_messages), Service\-Einstellungen -(imap, pop3, sieve und smtp) und der Transport werden angewendet, wenn -eine Domain angelegt wird. -Um die Einstellungen einer vorhandenen Domain zu ändern, verwenden Sie -einen der folgenden -.BR vmm (1) -Unterbefehle: -.PP -.TP -.B domainquota -um das Quota\-Limit einer Domain zu ändern -.TP -.B domainservices -um einer Domain einen abweichenden Satz von nutzbaren Services zuzuweisen -.TP -.B domaintransport -um einen neuen Vorgabe\-Transport für eine Domain festzulegen -.PP -Wenn ein Account angelegt wird, erbt er alle Einstellungen von der Domain, -zu der er hinzugefügt wird. -Abweichende Einstellungen für einen vorhandenen Account nehmen Sie mit -einem der Unterbefehle -.BR userquota ", " userservices " und " usertransport -vor. -.\" ------------------------------------ -.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). -.\" ------------------------------------ -.SS domain.imap -.BR imap " (Vorgabe: true) :" -.I Boolean -.PP -Legt fest, ob sich neu angelegte Benutzer per IMAP anmelden können sollen. -.\" ------------------------------------ -.SS domain.pop3 -.BR pop3 " (Vorgabe: true) :" -.I Boolean -.PP -Legt fest, ob sich neu angelegte Benutzer per POP3 anmelden können sollen. -.\" ------------------------------------ -.SS domain.quota_bytes -.BR quota_bytes " (Vorgabe: 0) :" -.I String -.PP -Quota Limit in Bytes. -0 bedeutet unbegrenzt. -Dieses Limit wird beim Anlegen von 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 domain.quota_messages -.BR quota_messages " (Vorgabe: 0) :" -.I Int -.PP -Quota Limit als Anzahl von Nachrichten. -0 bedeutet unbegrenzt. -Dieses Limit wird beim Anlegen neuer Domains angewendet. -.\" ------------------------------------ -.SS domain.sieve -.BR sieve " (Vorgabe: true) :" -.I Boolean -.PP -Legt fest, ob sich neu angelegte Benutzer per SIEVE (ManageSieve) anmelden -können sollen. -.\" ------------------------------------ -.SS domain.smtp -.BR smtp " (Vorgabe: true) :" -.I Boolean -.PP -Legt fest, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmelden -können sollen. -.\" ------------------------------------ -.SS domain.transport -.BR transport " (Vorgabe: dovecot:) :" -.I String -.PP -Der Standard\-Transport aller neuen Domains. -Siehe auch: -.BR transport (5). -.\" ----------------------------------------------------------------------- -.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 mdbox -Dovecot \(>= v2.0.beta5 -.TP -.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. -.\" ------------------------------------ -.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 verwendbaren Passwort\-Schemen zu erhalten, führen Sie -das Kommando -.B vmm lp -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 -.\" ----------------------------------------------------------------------- -.SH BEISPIEL -Eine Beispiel\-Konfiguration. -Alle Optionen, die nicht in der Konfigurationsdatei gelistet sind, haben -ihren Vorgabewert. -.PP -.nf -[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 - -[domain] -quota_bytes = 500M -quota_messages = 10000 -transport = lmtp:unix:private/dovecot\-lmtp - -[mailbox] -folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix - -[misc] -crypt_sha512_rounds = 10000 -dovecot_version = 2.0.beta4 -password_scheme = SHA512\-CRYPT.hex -.fi -.\" ----------------------------------------------------------------------- -.SH SIEHE AUCH -.BR postconf (1), -.BR vmm (1), -.BR transport (5) -.\" ----------------------------------------------------------------------- -.SH INTERNET RESSOURCEN -.TP -Homepage -http://vmm.localdomain.org/ -.TP -Projekt\-Seite -http://sf.net/projects/vmm/ -.TP -Bugtracker -https://bitbucket.org/pvo/vmm/issues -.\" ----------------------------------------------------------------------- -.SH COPYING -vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschrieben und sind unter den Bedingungen der -BSD Lizenz lizenziert. \ No newline at end of file