diff -r c0e1fb1b0145 -r a4aead244f75 man/de/man1/vmm.1 --- a/man/de/man1/vmm.1 Mon Nov 07 03:22:15 2011 +0000 +++ b/man/de/man1/vmm.1 Thu Jun 28 19:26:50 2012 +0000 @@ -1,447 +1,1015 @@ -.TH "VMM" "1" "17 Aug 2009" "Pascal Volk" +.TH "VMM" "1" "2012-04-15" "vmm 0.6" "vmm" .SH NAME -vmm \- Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase zu -verwalten. -.SH SYNOPSIS +vmm \- Kommandozeilenprogramm zur Verwaltung von E\-Mail\-Domains/\-Konten +und \-Aliase. +.\" ----------------------------------------------------------------------- +.SH ÜBERSICHT .B vmm -\fIUnterbefehl\fP \fIObjekt\fP [ \fIArgumente\fP ] +.IR Unterbefehl " [" "Argument ..." ] +.\" ----------------------------------------------------------------------- .SH BESCHREIBUNG -\fBvmm\fP (Virtual Mail Manager) ist ein Kommandozeilen-Werkzeug für -Administratoren/Postmaster zur Verwaltung von Domains, Konten und Aliase. Es -wurde entwickelt für Dovecot und Postfix mit einem PostgreSQL-Backend. -.SH UNTERBEFEHLE -Von jedem Unterbefehl gibt es jeweils eine lange und kurze Variante. Bei beiden -Formen ist die Groß-/Kleinschreibung zu berücksichtigen. -.SS ALLGEMEINE UNTERBEFEHLE +.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 -\fBconfigure\fP (\fBcf\fP) [ \fIAbschnitt\fP ] -Startet den interaktiven Konfiguration-Modus für alle Konfigurations-Abschnitte. -.br -Wurde das optionale Argument \fIAbschnitt\fP angegeben, werden nur die Optionen -des angegebenen Abschnitts angezeigt und können geändert werden. Folgende -Abschnitte sind vorhanden: -.RS -.PD 0 +.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 -- -.B -database +.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 -- -.B -maildir +.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 -- -.B -services +.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 -- -.B -domdir +.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 -- -.B -bin -.TP -- -.B -misc -.PD -.RE -.LP +.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 - Beispiel: - - \fBvmm configure services\fP - Verwende Konfigurationsdatei: /usr/local/etc/vmm.cfg - - * Konfigurations Abschnitt: „services“ - Neuer Wert für Option pop3 [True]: - Neuer Wert für Option smtp [True]: - Neuer Wert für Option imap [True]: - Neuer Wert für Option sieve [True]: false +.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 -\fBgetuser\fP (\fBgu\fP) \fIuserid\fP -Wenn nur eine UserID vorhanden ist, z. B. aus der Prozessliste, kann mit dem -Unterbefehl \fBgetuser\fP die E-Mail-Adresse des Users ermittelt werden. +.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 - Beispiel: +.B vmm configure mailbox +Konfigurationsdatei wird verwendet: /root/vmm.cfg - \fBvmm getuser 70004\fP - Account Informationen - --------------------- - UID............: 70004 - GID............: 70000 - Address........: c.user@example.com +* 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 -.\" -.TP -\fBlistdomains\fP (\fBld\fP) [ \fIMuster\fP ] -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 \fIMuster\fP angegeben wird. +.\" ------------------------------------ +.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 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 -Um eine Wildcard-Suche durchzuführen kann das %-Zeichen am Anfang und/oder Ende -des \fIMusters\fP verwendet werden. +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 - Beispiel: +.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 - \fBvmm listdomains %example%\fP - Übereinstimmende Domains - ------------------------ - [+] example.com - [-] e.g.example.com - [-] example.name - [+] example.net - [+] example.org +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 -\fBhelp\fP (\fBh\fP) -Dieser Unterbefehl gibt alle verfügbaren Kommandos auf stdout aus. Danach -beendet sich \fBvmm\fP. -.TP -\fBversion\fP (\fBv\fP) -Gibt Versions-Informationen zu \fBvmm\fP aus. -.\" -.SS DOMAIN UNTERBEFEHLE +.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 -\fBdomainadd\fP (\fBda\fP) \fIDomain\fP [ \fITransport\fP ] -Fügt eine neue \fIDomain\fP in die Datenbank ein. -.br -Ist das optionale Argument \fITransport\fP angegeben, wird der Vorgabe-Transport -aus \fBvmm.cfg\fP (misc/transport) für diese \fIDomain\fP ignoriert und der -angegebene \fITransport\fP verwendet. Der angegebene \fITransport\fP ist -gleichzeitig der Vorgabe-Transport für alle neuen Konten, die unter dieser -Domain eingerichtet werden. +.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 - Beispiele: - - \fBvmm domainadd support.example.com smtp:mx1.example.com - vmm domainadd sales.example.com\fP +.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 -.TP -\fBdomaininfo\fP (\fBdi\fP) \fIDomain\fP [ \fIdetails\fP ] -Dieser Unterbefehl zeigt Information zur angegeben \fIDomain\fP an. -.br -Um detaillierte Informationen über die \fIDomain\fP zu erhalten, kann das -optionale Argument \fIdetails\fP angegeben werden. Ein möglicher Wert für -\fIdetails\fP kann eines der folgenden fünf Schlüsselwörter sein: +.\" ------------------------------------ +.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 fünf Schlüsselwörter sein: .RS -.PD 0 -.TP +.TP 13 .B accounts -um alle existierenden Konten aufzulisten +um alle eingerichteten Konten aufzulisten .TP .B aliasdomains -um alle zugeordneten Alias-Domains aufzulisten +um alle zugeordneten Alias\-Domains aufzulisten .TP .B aliases -um alle verfügbaren Alias-Adressen aufzulisten +um alle vorhandenen Alias\-Adressen aufzulisten .TP .B relocated -um alle Adressen der relocated Users aufzulisten +um alle Adressen der Relocated Users aufzulisten +.TP +.B catchall +um alle Catch\-all\-Ziele aufzulisten .TP .B full um alle oben genannten Informationen aufzulisten -.PD .RE -.LP +.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 - Beispiel: - - \fBvmm domaininfo sales.example.com\fP - Domain Informationen - -------------------- - Domainname.....: sales.example.com - GID............: 70002 - Transport......: dovecot: - Domaindir......: /home/mail/5/70002 - Aliasdomains...: 0 - Accounts.......: 0 - Aliases........: 0 - Relocated......: 0 - +.B vmm domainquota example.com 1g force .fi -.TP -\fBdomaintransport\fP (\fBdt\fP) \fIDomain\fP \fITransport\fP [ \fIforce\fP ] -Ein neuer \fITransport\fP für die angegebene \fIDomain\fP kann mit diesem -Unterbefehl festgelegt werden. +.\" ------------------------------------ +.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 -Wurde das optionale Schlüsselwort '\fBforce\fP' angegeben, so werden alle -bisherigen Transport-Einstellungen, der in dieser Domain vorhandenen Konten, -mit dem neuen \fITransport\fP überschrieben. -.br -Andernfalls gilt der neue \fITransport\fP nur für Konten, die neu erstellt -werden. +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 - Beispiel: - - \fBvmm domaintransport support.example.com dovecot:\fP +.B vmm domaintransport support.example.com dovecot: .fi -.TP -\fBdomaindelete\fP (\fBdd\fP) \fIDomain\fP [ \fIdelalias\fP | \fIdeluser\fP | \fIdelall\fP ] -Mit diesem Unterbefehl wird die angegebene \fIDomain\fP gelöscht. -.br -Sollten der \fIDomain\fP Konten und/oder Aliase zugeordnet sein, wird \fBvmm\fP -die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden. - -Sollten Sie sich Ihres Vorhabens sicher sein, so kann optional eines der -folgenden Schlüsselwörter angegeben werden: '\fBdelalias\fP', '\fBdeluser\fP' oder '\fBdelall\fP' - -Sollten Sie wirklich immer wissen was Sie tun, so editieren Sie Ihre -\fBvmm.cfg\fP und setzen den Wert der Option \fIforcedel\fP, im Abschnitt -\fImisc\fP, auf true. Dann werden Sie beim Löschen von Domains nicht mehr wegen -vorhanden Konten/Aliase gewarnt. -.\" -.SS ALIAS-DOMAIN UNTERBEFEHLE -.TP -\fBaliasdomainaddd\fP (\fBada\fP) \fIAliasdomain\fP \fIZieldomain\fP -Mit diesem Unterbefehl wird der \fIZieldomain\fP die Alias-Domain -\fIAliasdomain\fP zugewiesen. +.\" ------------------------------------ +.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 - Beispiel: - - \fBvmm aliasdomainadd example.name example.com\fP +.B vmm do example.com Gehört Robert .fi -.TP -\fBaliasdomaininfo (\fBadi\fP) \fIAliasdomain\fP -Dieser Unterbefehl informiert darüber, welcher Domain die Alias-Domain -\fIAliasdomain\fP zugeordnet ist. +.\" ----------------------------------------------------------------------- +.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 - Beispiel: - - \fBvmm aliasdomaininfo example.name\fP - Alias-Domain Informationen - -------------------------- - Die Alias-Domain example.name gehört zu: - * example.com +.B vmm aliasdomainadd example.net example.com .fi -.TP -\fBaliasdomainswitch\fP (\fBads\fP) \fIAliasdomain\fP \fIZieldomain\fP -Wenn das Ziel der vorhandenen \fIAliasdomain\fP auf eine andere \fIZieldomain\fP -geändert werden soll, ist dieser Unterbefehl zu verwenden. +.\" ------------------------------------ +.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 - Beispiel: - - \fBvmm aliasdomainswitch example.name example.org\fP +.B vmm aliasdomaindelete e.g.example.com .fi -.TP -\fBaliasdomaindelete\fP (\fBadd\fP) \fIAliasdomain\fP -Wenn die Alias-Domain mit dem Namen \fIAliasdomain\fP gelöscht werden soll, ist -dieser Unterbefehl zu verwenden. +.\" ------------------------------------ +.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 - Beispiel: - - \fBvmm aliasdomaindelete e.g.example.com\fP +.B vmm aliasdomainswitch example.net example.org .fi -.\" -.SS KONTO UNTERBEFEHLE -.TP -\fBuseradd\fP (\fBua\fP) \fIAdresse\fP [ \fIPasswort\fP ] -Mit diesem Unterbefehl wird ein neues Konto für die angegebene \fIAdresse\fP +.\" ----------------------------------------------------------------------- +.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. -.br -Wurde kein \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktiven -Modus erfragen. +.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 - Beispiele: - - \fBvmm ua d.user@example.com 'A 5ecR3t P4s5\\/\\/0rd'\fP - \fBvmm ua e.user@example.com\fP - Neues Passwort eingeben: - Neues Passwort wiederholen: +.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 -.TP -\fBuserinfo\fP (\fBui\fP) \fIAdresse\fP [ \fIdetails\fP ] -Dieser Unterbefehl zeigt einige Informationen über das Konto mit der angegebenen -\fIAdresse\fP an. -.br -Wurde das optionale Argument \fIdetails\fP angegeben, werden weitere -Informationen ausgegeben. -.br -Mögliche Werte für \fIdetails\fP sind: +.\" ------------------------------------ +.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 -.PD 0 -.TP +.TP 8 .B aliases -um alle Alias-Adressen, mit dem Ziel \fIAdresse\fP, aufzulisten +um alle Alias\-Adressen, mit dem Ziel +.IR address , +aufzulisten .TP .B du -um zusätzlich die Festplattenbelegung des Kontos anzuzeigen +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 -.PD .RE -.LP -.TP -\fBusername\fP (\fBun\fP) \fIAdresse\fP \fI'Bürgerlicher Name'\fP -Der Bürgerliche Name des Konto-Inhabers mit der angegebenen \fIAdresse\fP kann -mit diesem Unterbefehl gesetzt/aktualisiert werden. +.PP +Beispiel: .PP .nf - Beispiel: - - \fBvmm un d.user@example.com 'John Doe'\fP +.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 -.TP -\fBuserpassword\fP (\fBup\fP) \fIAdresse\fP [ \fIPasswort\fP ] -Das \fIPasswort\fP eines Kontos kann mit diesem Unterbefehl aktualisiert werden. -.br -Wurde kein \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktiven -Modus erfragen. +.\" ------------------------------------ +.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 - Beispiel: - - \fBvmm up d.user@example.com 'A |\\/|0r3 5ecur3 P4s5\\/\\/0rd?'\fP +.B vmm username d.user@example.com \(dqJohn Doe\(dq .fi -.TP -\fBusertransport\fP (\fBut\fP) \fIAdresse\fP \fITransport\fP -Mit diesem Unterbefehl kann ein abweichender \fITransport\fP für das Konto mit -der angegebenen \fIAdresse\fP festgelegt werden. +.\" ------------------------------------ +.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 - Beispiel: - - \fBvmm ut d.user@example.com smtp:pc105.it.example.com\fP +.B vmm uo d.user@example.com Wird nur bis Ende Mai 2012 gebraucht .fi -.TP -\fBuserdisable\fP (\fBu0\fP) \fIAdresse\fP [ \fIService\fP ] -Soll ein Anwender keinen Zugriff auf einen oder alle Service haben, kann der -Zugriff mit diesem Unterbefehl beschränkt werden. -.br -Wurde weder ein \fIService\fP noch das Schlüsselwort '\fIall\fP' angegeben, -werden alle Services (\fIsmtp\fP, \fIpop3\fP, \fIimap\fP, und \fIsieve\fP) -für das Konto mit der angegebenen \fIAdresse\fP deaktiviert. -.br -Andernfalls wird nur der Zugriff auf den angegeben \fIService\fP gesperrt. +.\" ------------------------------------ +.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 einer Limite, bewirkt das Wort 'domain', daß die Limite 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 'domain', daß die benutzerspezifische +Liste gelöscht wird und somit wieder die in der Domain gespeicherte +Liste für das Konto gilt. +.PP +Beispiel: .PP .nf - Beispiele: - - \fBvmm u0 b.user@example.com imap\fP - \fBvmm userdisable c.user@example.com\fP -.fi +.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 -.TP -\fBuserenable\fP (\fBu1\fP) \fIAdresse\fP [ \fIService\fP ] -Um den Zugriff auf bestimmte oder alle gesperrten Service zu gewähren, wird -dieser Unterbefehl verwendet. -.br -Wurde weder ein \fIService\fP noch das Schlüsselwort '\fIall\fP' angegeben, -werden alle Services (\fIsmtp\fP, \fIpop3\fP, \fIimap\fP, und \fIsieve\fP) -für das Konto mit der angegebenen \fIAdresse\fP aktiviert. +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 -Andernfalls wird nur der Zugriff auf den angegeben \fIService\fP gestattet. +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 -.TP -\fBuserdelete\fP (\fBud\fP) \fIAdresse\fP [ \fIdelalias\fP ] -Verwenden Sie diesen Unterbefehl um, das Konto mit der angegebenen \fIAdresse\fP -zu löschen. -.br -Sollte es einen oder mehrere Aliase geben, deren Zieladresse mit der des Kontos -identisch ist, wird \fBvmm\fP die Ausführung des Befehls mit einer -entsprechenden Fehlermeldung beenden. Um dieses zu umgehen, kann das optionale -Schlüsselwort '\fIdelalias\fP' angegebenen werden. -.\" -.SS ALIAS UNTERBEFEHLE -.TP -\fBaliasadd\fP (\fBaa\fP) \fIAlias\fP \fIZiel\fP -Mit diesem Unterbefehl werden neue Aliase erstellt. +.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 - Beispiele: - - \fBvmm aliasadd john.doe@example.com d.user@example.com\fP - \fBvmm aa support@example.com d.user@example.com\fP - \fBvmm aa support@example.com e.user@example.com\fP +.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 -.TP -\fBaliasinfo\fP (\fBai\fP) \fIAlias\fP -Informationen zu einem Alias können mit diesem Unterbefehl ausgegeben werden. +.\" ------------------------------------ +.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 +Wurde eine optionale +.I destination +angegeben, so wird nur diese +.I destination +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 - Beispiel: - - \fBvmm aliasinfo support@example.com\fP - Alias Informationen - ------------------- - E-Mails für support@example.com werden weitergeleitet an: - * d.user@example.com - * e.user@example.com +.B vmm aliasinfo support@example.com +Alias Informationen +------------------- + E\-Mails für support@example.com werden weitergeleitet an: + * e.user@example.com .fi -.TP -\fBaliasdelete\fP (\fBad\fP) \fIAlias\fP [ \fIZiel\fP ] -Verwenden Sie diesen Unterbefehl um den angegebenen \fIAlias\fP zu löschen. -.br -Wurde die optionale Zieladresse \fIZiel\fP angegeben, so wird nur diese -Zieladresse vom angegebenen \fIAlias\fP entfernt. +.\" ----------------------------------------------------------------------- +.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 - Beispiel: - \fBvmm ad support@example.com d.user@example.com\fP +.B vmm relocateddelete b.nutzer@example.com .fi -.\" -.SS RELOCATED UNTERBEFEHLE -.TP -\fBrelocatedadd\fP (\fBra\fP) \fIalte_adresse\fP \fIneue_adresse\fP -Um einen neuen relocated User anzulegen kann dieser Unterbefehl verwendet -werden. -.br -Dabei ist \fIalte_adresse\fP die ehemalige Adresse des Benutzers, z. B. -b.user@example.com, und \fIneue_adresse\fP die neue Adresse, unter der Benutzer -erreichbar ist. +.\" ----------------------------------------------------------------------- +.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, daß 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 - Beispiel: - - \fBvmm relocatedadd b.user@example.com b-user@company.tld\fP +.B vmm catchalladd example.com b.nutzer@example.org .fi -.TP -\fBrelocatedinfo\fP (\fBri\fP) \fIalte_adresse\fP -Dieser Unterbefehl zeigt die neue Adresse des relocated Users mit -\fIalte_adresse\fP. +.\" ------------------------------------ +.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 - Beispiel: - - \fBvmm relocatedinfo b.user@example.com\fP - Relocated Informationen - ----------------------- - Der Benutzer „b.user@example.com“ ist erreichbar unter „b-user@company.tld“ +.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 -.TP -\fBrelocateddelete\fP (\fBrd\fP) \fIalte_adresse\fP -Mit diesem Unterbefehl kann der relocated User mit \fIalte_adresse\fP gelöscht -werden. +.\" ------------------------------------ +.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 angegebene Alias, oder alle, wenn keines +angegeben wurde. +.PP +Beispiel: .PP .nf - Beispiel: - - \fBvmm relocateddelete b.user@example.com\fP +.B vmm catchalldelete example.com b.nutzer@example.org .fi -.\" +.\" ----------------------------------------------------------------------- .SH DATEIEN -/usr/local/etc/vmm.cfg +.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 -vmm.cfg(5), Konfigurationsdatei für vmm -.SH AUTOR -\fBvmm\fP und die dazugehörigen Manualseiten wurden von Pascal Volk -<\fIneverseen@users.sourceforge.net\fP> geschrieben und sind unter den -Bedingungen der BSD Lizenz lizenziert. +.BR dsync (1), +.BR transport (5), +.BR vmm.cfg (5) +.\" ----------------------------------------------------------------------- +.SH INTERNET RESSOURCEN +.TP +Wiki +http://de.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.