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