.\" $Id$

.TH "VMM" "1" "11. Jun 2008" "Pascal Volk"

.SH NAME

vmm \- Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase zu

verwalten.

.SH SYNOPSIS

.B vmm

\fIUnterbefehl\fP \fIObjekt\fP [ \fIArgumente\fP ]

.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

.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

.TP

-

.B

database

.TP

-

.B

maildir

.TP

-

.B

services

.TP

-

.B

domdir

.TP

-

.B

bin

.TP

-

.B

misc

.PD

.RE

.LP

.PP

.nf

        Beispiel:

        \fBvmm configure services\fP

        * Konfigurations Abschnitt: services

        Neuer Wert für pop3 [True]: 

        Neuer Wert für smtp [True]: 

        Neuer Wert für imap [True]: 

        Neuer Wert für managesieve [True]: false

.fi

.PP

.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.

.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. Die Ausgabe kann

reduziert werden, indem ein optionales \fIMuster\fP angegeben wird.

.br

Um eine Wildcard-Suche durchzuführen kann das %-Zeichen am Anfang und/oder Ende

des \fIMusters\fP verwendet werden.

.PP

.nf

        Beispiel:

        \fBvmm listdomains example%\fP

        Übereinstimmende Domains

        -------------------------

                example.com

                example.net

                example.org

.fi

.\"

.TP

\fBhelp\fP (\fBh\fP)

Dieser Unterbefehl gibt alle verfügbaren Kommandos auf stderr aus. Danach

beendet sich \fBvmm\fP.

.TP

\fBversion\fP (\fBv\fP)

Gibt Versions-Informationen zu \fBvmm\fP aus.

.\"

.SS DOMAIN UNTERBEFEHLE

.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.

.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 [ \fIdetailed\fP ]

Dieser Unterbefehl zeigt Information zur angegeben \fIDomain\fP an.

.br

Wurde das optionale Schlüsselwort '\fBdetailed\fP' angegeben, werden zusätzlich

alle eingerichteten Konten und Aliase aufgelistet.

.PP

.nf

        Beispiel:

        \fBvmm domaininfo sales.example.com\fP

        Domain Informationen

        --------------------

                Domainname.....: sales.example.com

                GID............: 70002

                Transport......: dovecot:

                Domaindir......: /home/mail/5/70002

                Accounts.......: 0

                Aliases........: 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 diesem

Unterbefehl festgelegt werden.

.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.

.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.

.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 KONTO UNTERBEFEHLE

.TP

\fBuseradd\fP (\fBua\fP) \fIAdresse\fP [ \fIPasswort\fP ]

Mit diesem Unterbefehl wird ein neues Konto für die angegebene \fIAdresse\fP

angelegt.

.br

Wurde keine \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktiven

Modus 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 [ \fIdu\fP ]

Dieser Unterbefehl zeigt einige Informationen über das Konto mit der angegebenen

\fIAdresse\fP an.

.br

Wurde das optionale Argument \fIdu\fP angegeben, wird zusätzlich die

Festplattenbelegung des Kontos ermittelt und ausgegeben.

.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

.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.

.br

Wurde keine \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktiven

Modus 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\fP

Mit diesem Unterbefehl kann ein abweichender \fITransport\fP für das Konto mit

der 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 [ \fIsmtp\fP | \fIpop3\fP | \fIimap\fP | \fImanagesieve\fP | \fIall\fP ]

Soll ein Anwender keinen Zugriff auf einen oder alle Service haben, kann der

Zugriff mit diesem Unterbefehl beschränkt werden.

.br

Wurde weder der Name eines Services noch das Schlüsselwort '\fIall\fP'

angegeben, werden alle Service ('smtp', 'pop3', 'imap', und 'managesieve') für

das Konto mit der angegebenen  \fIAdresse\fP deaktiviert.

.br

Andernfalls wird nur der Zugriff auf den angegeben Service gesperrt.

.PP

.nf

        Beispiele:

        \fBvmm u0 b.user@example.com imap\fP

        \fBvmm userdisable c.user@example.com\fP

.fi

.TP

\fBuserenable\fP (\fBu1\fP) \fIAdresse\fP [ \fIsmtp\fP | \fIpop3\fP | \fIimap\fP | \fImanagesieve\fP | \fIall\fP ]

Um den Zugriff auf bestimmte oder alle gesperrten Service zu gewähren, wird

dieser Unterbefehl verwendet.

.br

Wurde weder der Name eines Services noch das Schlüsselwort '\fIall\fP'

angegeben, werden alle Service ('smtp', 'pop3', 'imap', und 'managesieve') für

das Konto mit der angegebenen  \fIAdresse\fP aktiviert.

.br

Andernfalls wird nur der Zugriff auf den angegeben Service gestattet.

.TP

\fBuserdelete\fP (\fBud\fP) \fIAdresse\fP

Verwenden Sie diesen Unterbefehl um, das Konto mit der angegebenen \fIAdresse\fP

zu löschen.

.\"

.SS ALIAS UNTERBEFEHLE

.TP

\fBaliasadd\fP (\fBaa\fP) \fIAlias\fP \fIZiel\fP

Mit 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\fP

Informationen 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 gehen 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.

.br

Wurde die optionale Ziel-Adresse \fIZiel\fP angegeben, so wird nur diese

Ziel-Adresse vom angegebenen \fIAlias\fP entfernt.

.PP

.nf

        Beispiel:

        \fBvmm ad support@example.com d.user@example.com\fP

.fi

.SH DATEIEN

/usr/local/etc/vmm.cfg

.SH SIEHE AUCH

vmm.cfg(5), Konfigurationsdatei für vmm

.SH AUTOR

\fBvmm\fP und die dazugehörigen Manualseiten wurden von Pascal Volk

<\fIp.volk@veb-it.de\fP> geschrieben und sind unter den Bedingungen der BSD

Lizenz lizenziert.