VMM{/Config}: reduced docstrings. Added doc to the repository.
=====
vmm
=====
-----------------------------------------------------------------------------
Kommandozeilenprogramm zur Verwaltung von E-Mail-Domains, -Konten und -Aliase
-----------------------------------------------------------------------------
:Author: Pascal Volk <neverseen@users.sourceforge.net>
: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