VMM/EmailAddress: reworked class EmailAddress again.
The attributes domainname and localpart are now read-only.
.TH"VMM""1""17 Aug 2009""Pascal Volk".SHNAMEvmm \- Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase zuverwalten..SHSYNOPSIS.Bvmm\fIUnterbefehl\fP\fIObjekt\fP [ \fIArgumente\fP ].SHBESCHREIBUNG\fBvmm\fP (Virtual Mail Manager) ist ein Kommandozeilen-Werkzeug fürAdministratoren/Postmaster zur Verwaltung von Domains, Konten und Aliase. Eswurde entwickelt für Dovecot und Postfix mit einem PostgreSQL-Backend..SHUNTERBEFEHLEVon jedem Unterbefehl gibt es jeweils eine lange und kurze Variante. Bei beidenFormen ist die Groß-/Kleinschreibung zu berücksichtigen..SSALLGEMEINEUNTERBEFEHLE.TP\fBconfigure\fP (\fBcf\fP) [ \fIAbschnitt\fP ]Startet den interaktiven Konfiguration-Modus für alle Konfigurations-Abschnitte..brWurde das optionale Argument \fIAbschnitt\fP angegeben, werden nur die Optionendes angegebenen Abschnitts angezeigt und können geändert werden. FolgendeAbschnitte sind vorhanden:.RS.PD0.TP-.Bdatabase.TP-.Bmaildir.TP-.Bservices.TP-.Bdomdir.TP-.Bbin.TP-.Bmisc.PD.RE.LP.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.fi.PP.TP\fBgetuser\fP (\fBgu\fP) \fIuserid\fPWenn nur eine UserID vorhanden ist, z. B. aus der Prozessliste, kann mit demUnterbefehl \fBgetuser\fP die E-Mail-Adresse des Users ermittelt werden..PP.nf Beispiel:\fBvmm getuser 70004\fP Account Informationen --------------------- UID............: 70004 GID............: 70000 Address........: c.user@example.com.fi.\".TP\fBlistdomains\fP (\fBld\fP) [ \fIMuster\fP ]Dieser Unterbefehl listet alle verfügbaren Domains auf. Allen Domains wird einPräfix vorangestellt. Entweder ein '[+]', falls es sich um eine primäre Domainhandelt, oder ein '[-]', falls es sich um eine Alias-Domain handelt. DieAusgabe kann reduziert werden, indem ein optionales \fIMuster\fP angegeben wird..brUm eine Wildcard-Suche durchzuführen kann das %-Zeichen am Anfang und/oder Endedes \fIMusters\fP verwendet werden..PP.nf Beispiel:\fBvmm listdomains %example%\fP Übereinstimmende Domains ------------------------ [+] example.com [-] e.g.example.com [-] example.name [+] example.net [+] example.org.fi.\".TP\fBhelp\fP (\fBh\fP)Dieser Unterbefehl gibt alle verfügbaren Kommandos auf stdout aus. Danachbeendet sich \fBvmm\fP..TP\fBversion\fP (\fBv\fP)Gibt Versions-Informationen zu \fBvmm\fP aus..\".SSDOMAINUNTERBEFEHLE.TP\fBdomainadd\fP (\fBda\fP) \fIDomain\fP [ \fITransport\fP ]Fügt eine neue \fIDomain\fP in die Datenbank ein..brIst das optionale Argument \fITransport\fP angegeben, wird der Vorgabe-Transportaus \fBvmm.cfg\fP (misc/transport) für diese \fIDomain\fP ignoriert und derangegebene \fITransport\fP verwendet. Der angegebene \fITransport\fP istgleichzeitig der Vorgabe-Transport für alle neuen Konten, die unter dieserDomain eingerichtet werden..PP.nf Beispiele:\fBvmm domainadd support.example.com smtp:mx1.example.com vmm domainadd sales.example.com\fP.fi.TP\fBdomaininfo\fP (\fBdi\fP) \fIDomain\fP [ \fIdetails\fP ]Dieser Unterbefehl zeigt Information zur angegeben \fIDomain\fP an..brUm detaillierte Informationen über die \fIDomain\fP zu erhalten, kann dasoptionale Argument \fIdetails\fP angegeben werden. Ein möglicher Wert für\fIdetails\fP kann eines der folgenden fünf Schlüsselwörter sein:.RS.PD0.TP.Baccountsum alle existierenden Konten aufzulisten.TP.Baliasdomainsum alle zugeordneten Alias-Domains aufzulisten.TP.Baliasesum alle verfügbaren Alias-Adressen aufzulisten.TP.Brelocatedum alle Adressen der relocated Users aufzulisten.TP.Bfullum alle oben genannten Informationen aufzulisten.PD.RE.LP.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.fi.TP\fBdomaintransport\fP (\fBdt\fP) \fIDomain\fP\fITransport\fP [ \fIforce\fP ]Ein neuer \fITransport\fP für die angegebene \fIDomain\fP kann mit diesemUnterbefehl festgelegt werden..brWurde das optionale Schlüsselwort '\fBforce\fP' angegeben, so werden allebisherigen Transport-Einstellungen, der in dieser Domain vorhandenen Konten,mit dem neuen \fITransport\fP überschrieben..brAndernfalls gilt der neue \fITransport\fP nur für Konten, die neu erstelltwerden..PP.nf Beispiel:\fBvmm domaintransport support.example.com dovecot:\fP.fi.TP\fBdomaindelete\fP (\fBdd\fP) \fIDomain\fP [ \fIdelalias\fP | \fIdeluser\fP | \fIdelall\fP ]Mit diesem Unterbefehl wird die angegebene \fIDomain\fP gelöscht..brSollten der \fIDomain\fP Konten und/oder Aliase zugeordnet sein, wird \fBvmm\fPdie Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden.Sollten Sie sich Ihres Vorhabens sicher sein, so kann optional eines derfolgenden 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 wegenvorhanden Konten/Aliase gewarnt..\".SSALIAS-DOMAINUNTERBEFEHLE.TP\fBaliasdomainaddd\fP (\fBada\fP) \fIAliasdomain\fP\fIZieldomain\fPMit diesem Unterbefehl wird der \fIZieldomain\fP die Alias-Domain\fIAliasdomain\fP zugewiesen..PP.nf Beispiel:\fBvmm aliasdomainadd example.name example.com\fP.fi.TP\fBaliasdomaininfo (\fBadi\fP) \fIAliasdomain\fPDieser Unterbefehl informiert darüber, welcher Domain die Alias-Domain\fIAliasdomain\fP zugeordnet ist..PP.nf Beispiel:\fBvmm aliasdomaininfo example.name\fP Alias-Domain Informationen -------------------------- Die Alias-Domain example.name gehört zu: * example.com.fi.TP\fBaliasdomainswitch\fP (\fBads\fP) \fIAliasdomain\fP\fIZieldomain\fPWenn das Ziel der vorhandenen \fIAliasdomain\fP auf eine andere \fIZieldomain\fPgeändert werden soll, ist dieser Unterbefehl zu verwenden..PP.nf Beispiel:\fBvmm aliasdomainswitch example.name example.org\fP.fi.TP\fBaliasdomaindelete\fP (\fBadd\fP) \fIAliasdomain\fPWenn die Alias-Domain mit dem Namen \fIAliasdomain\fP gelöscht werden soll, istdieser Unterbefehl zu verwenden..PP.nf Beispiel:\fBvmm aliasdomaindelete e.g.example.com\fP.fi.\".SSKONTOUNTERBEFEHLE.TP\fBuseradd\fP (\fBua\fP) \fIAdresse\fP [ \fIPasswort\fP ]Mit diesem Unterbefehl wird ein neues Konto für die angegebene \fIAdresse\fPangelegt..brWurde kein \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktivenModus erfragen..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:.fi.TP\fBuserinfo\fP (\fBui\fP) \fIAdresse\fP [ \fIdetails\fP ]Dieser Unterbefehl zeigt einige Informationen über das Konto mit der angegebenen\fIAdresse\fP an..brWurde das optionale Argument \fIdetails\fP angegeben, werden weitereInformationen ausgegeben..brMögliche Werte für \fIdetails\fP sind:.RS.PD0.TP.Baliasesum alle Alias-Adressen, mit dem Ziel \fIAdresse\fP, aufzulisten.TP.Bduum zusätzlich die Festplattenbelegung des Kontos anzuzeigen.TP.Bfullum alle oben genannten Informationen anzuzeigen.PD.RE.LP.TP\fBusername\fP (\fBun\fP) \fIAdresse\fP\fI'Bürgerlicher Name'\fPDer Bürgerliche Name des Konto-Inhabers mit der angegebenen \fIAdresse\fP kannmit diesem Unterbefehl gesetzt/aktualisiert werden..PP.nf Beispiel:\fBvmm un d.user@example.com 'John Doe'\fP.fi.TP\fBuserpassword\fP (\fBup\fP) \fIAdresse\fP [ \fIPasswort\fP ]Das \fIPasswort\fP eines Kontos kann mit diesem Unterbefehl aktualisiert werden..brWurde kein \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktivenModus erfragen..PP.nf Beispiel:\fBvmm up d.user@example.com 'A |\\/|0r3 5ecur3 P4s5\\/\\/0rd?'\fP.fi.TP\fBusertransport\fP (\fBut\fP) \fIAdresse\fP\fITransport\fPMit diesem Unterbefehl kann ein abweichender \fITransport\fP für das Konto mitder angegebenen \fIAdresse\fP festgelegt werden..PP.nf Beispiel:\fBvmm ut d.user@example.com smtp:pc105.it.example.com\fP.fi.TP\fBuserdisable\fP (\fBu0\fP) \fIAdresse\fP [ \fIService\fP ]Soll ein Anwender keinen Zugriff auf einen oder alle Service haben, kann derZugriff mit diesem Unterbefehl beschränkt werden..brWurde 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..brAndernfalls wird nur der Zugriff auf den angegeben \fIService\fP gesperrt..PP.nf Beispiele:\fBvmm u0 b.user@example.com imap\fP\fBvmm userdisable c.user@example.com\fP.fi.PP.TP\fBuserenable\fP (\fBu1\fP) \fIAdresse\fP [ \fIService\fP ]Um den Zugriff auf bestimmte oder alle gesperrten Service zu gewähren, wirddieser Unterbefehl verwendet..brWurde 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..brAndernfalls wird nur der Zugriff auf den angegeben \fIService\fP gestattet..PP.TP\fBuserdelete\fP (\fBud\fP) \fIAdresse\fP [ \fIdelalias\fP ]Verwenden Sie diesen Unterbefehl um, das Konto mit der angegebenen \fIAdresse\fPzu löschen..brSollte es einen oder mehrere Aliase geben, deren Zieladresse mit der des Kontosidentisch ist, wird \fBvmm\fP die Ausführung des Befehls mit einerentsprechenden Fehlermeldung beenden. Um dieses zu umgehen, kann das optionaleSchlüsselwort '\fIdelalias\fP' angegebenen werden..\".SSALIASUNTERBEFEHLE.TP\fBaliasadd\fP (\fBaa\fP) \fIAlias\fP\fIZiel\fPMit diesem Unterbefehl werden neue Aliase erstellt..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.fi.TP\fBaliasinfo\fP (\fBai\fP) \fIAlias\fPInformationen zu einem Alias können mit diesem Unterbefehl ausgegeben werden..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.fi.TP\fBaliasdelete\fP (\fBad\fP) \fIAlias\fP [ \fIZiel\fP ]Verwenden Sie diesen Unterbefehl um den angegebenen \fIAlias\fP zu löschen..brWurde die optionale Zieladresse \fIZiel\fP angegeben, so wird nur dieseZieladresse vom angegebenen \fIAlias\fP entfernt..PP.nf Beispiel:\fBvmm ad support@example.com d.user@example.com\fP.fi.\".SSRELOCATEDUNTERBEFEHLE.TP\fBrelocatedadd\fP (\fBra\fP) \fIalte_adresse\fP\fIneue_adresse\fPUm einen neuen relocated User anzulegen kann dieser Unterbefehl verwendetwerden..brDabei ist \fIalte_adresse\fP die ehemalige Adresse des Benutzers, z. B.b.user@example.com, und \fIneue_adresse\fP die neue Adresse, unter der Benutzererreichbar ist..PP.nf Beispiel:\fBvmm relocatedadd b.user@example.com b-user@company.tld\fP.fi.TP\fBrelocatedinfo\fP (\fBri\fP) \fIalte_adresse\fPDieser Unterbefehl zeigt die neue Adresse des relocated Users mit\fIalte_adresse\fP..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“.fi.TP\fBrelocateddelete\fP (\fBrd\fP) \fIalte_adresse\fPMit diesem Unterbefehl kann der relocated User mit \fIalte_adresse\fP gelöschtwerden..PP.nf Beispiel:\fBvmm relocateddelete b.user@example.com\fP.fi.\".SHDATEIEN/usr/local/etc/vmm.cfg.SHSIEHEAUCHvmm.cfg(5), Konfigurationsdatei für vmm.SHAUTOR\fBvmm\fP und die dazugehörigen Manualseiten wurden von Pascal Volk<\fIneverseen@users.sourceforge.net\fP> geschrieben und sind unter denBedingungen der BSD Lizenz lizenziert.