diff -r ad7cfbfbc68d -r c2543ddde9f5 man/de/man1/vmm.1 --- a/man/de/man1/vmm.1 Tue Oct 25 15:36:38 2011 +0000 +++ b/man/de/man1/vmm.1 Wed Oct 26 03:20:40 2011 +0000 @@ -1,447 +1,908 @@ -.TH "VMM" "1" "17 Aug 2009" "Pascal Volk" +.TH "VMM" "1" "2011-10-26" "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 13 +.I Adresse +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. +.I FQDN +Der voll qualifizierten Domain\-Namen \(em ohne den abschließenden Punkt +\(em einer Domain oder Alias\-Domain. +.\" -------------------------- +.TP +.I Nachrichten +Ein Integer\-Wert, der das maximal nutzbare Kontingent als Anzahl von +Nachrichten festlegt. .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 +Der Wert +.B 0 +(null) bedeutet unbegrenzt \(em kein Quota\-Limit als Anzahl von +Nachrichten. +.\" -------------------------- .TP -- -.B -database +.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 -maildir +.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 -services +.I Speicher +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 -domdir +.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. +.\" -------------------------- .TP -- -.B -bin -.TP -- -.B -misc -.PD -.RE -.LP +.I Ziel\-Adresse +Ist entweder eine +.RI E\-Mail\- Adresse , +wenn sie in Verbindung mit +.I "ALIAS UNTERBEFEHLEN" +verwendet wird, oder ein +.I FQDN +in Verbindung mit +.IR "ALIASDOMAIN UNTERBEFEHLEN" . +.\" ----------------------------------------------------------------------- +.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 Wert .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. +Verwenden Sie diesen Unterbefehl, um einer einzelnen Konfigurationsoption +einen neuen +.I Wert +zuzuweisen. +.I Option +ist der Name der Konfigurationsoption, +.I Wert +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 - Beispiel: - - \fBvmm getuser 70004\fP - Account Informationen - --------------------- - UID............: 70004 - GID............: 70000 - Address........: c.user@example.com +.B vmm configget misc.transport +misc.transport = dovecot: +.B vmm configset misc.transport lmtp:unix:private/dovecot\-lmtp +.B vmm cg misc.transport +misc.transport = lmtp:unix:private/dovecot\-lmtp .fi -.\" +.\" ------------------------------------ +.SS configure (cf) +.B vmm configure +.RI [ Sektion ] +.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 Sektion +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 +.B bin +Pfade zu externen Binär\-Dateien +.TP +.B database +Datenbank Einstellungen +.TP +.B domain +Domain Einstellungen +.TP +.B mailbox +Mailbox Einstellungen .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. -.br -Um eine Wildcard-Suche durchzuführen kann das %-Zeichen am Anfang und/oder Ende -des \fIMusters\fP verwendet werden. +.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 +.B vmm configure mailbox +Verwende Konfigurationsdatei: /usr/local/etc/vmm.cfg + +* Konfigurations\-Sektion: „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 - Beispiel: - - \fBvmm listdomains %example%\fP - Übereinstimmende Domains - ------------------------ - [+] example.com - [-] e.g.example.com - [-] example.name - [+] example.net - [+] example.org +.B vmm getuser 70772 +Account Informationen +--------------------- + UID............: 70772 + GID............: 70312 + Address........: a.user@example.com .fi -.\" -.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 -.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. +.\" ------------------------------------ +.SS help (h) +.B vmm help +.RI [ Unterbefehl ] +.PP +Gibt ein Liste aller vorhandenen Unterbefehle mit einer kurzen Beschreibung +aus. +Wurde ein +.I Unterbefehl +angegeben, wird Hilfe zum Unterbefehl ausgegeben. +Danach wird +.B vmm +beendet. +.\" ------------------------------------ +.SS listdomains (ld) +.B vmm listdomains +.RI [ Muster ] +.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 +.I Muster +angegeben wird. +.PP +Um eine Wildcard\-Suche durchzuführen kann das %\-Zeichen am Anfang +und/oder Ende des +.I Musters +verwendet werden. +.PP +Beispiel: .PP .nf - Beispiele: - - \fBvmm domainadd support.example.com smtp:mx1.example.com - vmm domainadd sales.example.com\fP +.B vmm listdomains %example% +Übereinstimmende Domains +------------------------ + [+] example.com + [\-] e.g.example.com + [\-] example.name + [+] example.org + [+] sales.example.com .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 +.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 -\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: +.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 +.B vmm domainadd support.example.com smtp:[mx1.example.com]:2025 +Neues Passwort eingeben: +Neues Passwort wiederholen: +.B vmm cs account.random_password true +.B vmm domainadd vertrieb.example.com +Generiertes Passwort: Bg3eVmzKqtLn.Di7 +.fi +.\" ------------------------------------ +.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 full um alle oben genannten Informationen aufzulisten -.PD .RE -.LP +.PP +Beispiel: +.PP +.nf +.B vmm domaininfo sales.example.com +Domain Informationen +-------------------- + Domainname.....: sales.example.com + GID............: 70698 + Transport......: dovecot: + Domaindir......: /srv/mail/k/70698 + Quota Limit....: Storage: 0; Messages: 0 + Aliasdomains...: 0 + Accounts.......: 1 + Aliases........: 0 + Relocated......: 0 +.fi +.\" ------------------------------------ +.SS domainquota (dq) +.B vmm domainquota +.IR "FQDN Speicher" " [" Nachrichten ] +.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 " (" misc.quota_bytes " und " misc.quota_messages ). +Das neue Quota\-Limit wird für alle zukünftig angelegte Konten gelten. +Soll das neue Quota\-Limit auch auf bestehende Konten der Domain angewendet +werden, so ist das optionale Schlüsselwort +.B force +anzugeben. +.br +Wenn der Wert für das Argument +.I Nachrichten +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. -.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. +.\" ------------------------------------ +.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 +Wurde das optionale Schlüsselwort +.B force +angegeben, so werden alle bisherigen Transport\-Einstellungen, der in +dieser Domain vorhandenen Konten, mit dem neuen +.I Transport +überschrieben. +Andernfalls gilt der neue +.I Transport +nur für Konten, die zukünftig erstellt werden. +.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. +.\" ----------------------------------------------------------------------- +.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 -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. +Dieses Verhalten ist sichergestellt, solange die empfohlenen +Datenbankabfragen in +.I $config_directory/pgsql\-*.cf +konfiguriert sind. +.\" ------------------------------------ +.SS aliasdomainadd (ada) +.BI "vmm aliasdomainadd" " FQDN Ziel\-Adresse" +.PP +Dieser Unterbefehl legt die Alias\-Domain +.RI ( FQDN ) +als Alias für eine bestehende Domain +.RI ( Ziel\-Adresse ") an." +.PP +Beispiel: +.PP +.nf +.B vmm aliasdomainadd example.net example.com +.fi +.\" ------------------------------------ +.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 +.B vmm aliasdomaindelete e.g.example.com +.fi +.\" ------------------------------------ +.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 - Beispiel: - - \fBvmm aliasdomainadd example.name example.com\fP +.B vmm adi example.net +Alias\-Domain Informationen +-------------------------- + Die Alias\-Domain example.net gehört zu: + * example.com .fi -.TP -\fBaliasdomaininfo (\fBadi\fP) \fIAliasdomain\fP -Dieser Unterbefehl informiert darüber, welcher Domain die Alias-Domain -\fIAliasdomain\fP zugeordnet ist. +.\" ------------------------------------ +.SS aliasdomainswitch (ads) +.BI "vmm aliasdomainswitch" " FQDN Ziel\-Adresse" +.PP +Wenn Sie die bereits vorhandene Alias\-Domain +.I FQDN +einer anderen +.I Ziel\-Domain +zuordnen wollen, verwenden Sie diesen Unterbefehl. +.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 aliasdomainswitch example.net example.org .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. +.\" ----------------------------------------------------------------------- +.SH KONTO UNTERBEFEHLE +.SS useradd (ua) +.B vmm useradd +.IR Adresse " [" Passwort ] +.PP +Mit diesem Unterbefehl wird ein neues Konto für die angegebene +.I Adresse +angelegt. .PP -.nf - Beispiel: - - \fBvmm aliasdomainswitch example.name example.org\fP -.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. +Wurde kein +.I Passwort +angegeben wird +.B vmm +dieses im interaktiven Modus erfragen. +Falls kein +.I 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 - Beispiel: - - \fBvmm aliasdomaindelete e.g.example.com\fP +.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 -.\" -.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 kein \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktiven -Modus erfragen. +.\" ------------------------------------ +.SS userdelete (ud) +.BI "vmm userdelete" " Adresse" +.RB [ force ] +.PP +Verwenden Sie diesen Unterbefehl, um das Konto mit der angegebenen +.I Adresse +zu löschen. +.PP +Sollte es einen oder mehrere Aliase geben, deren Ziel\-Adresse mit der +.I 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 userdisable (u0) +.BI "vmm userdisable" " Adresse" +.RI [ "Service ..." ] +.PP +Soll ein Anwender keinen Zugriff auf bestimmte oder alle Service haben, +kann der Zugriff mit diesem Unterbefehl beschränkt werden. +.PP +Wurde kein +.I Service +angegeben, werden alle Services +.RB ( smtp ", " pop3 ", " imap " und " sieve ) +für das Konto mit der angegebenen +.I Adresse +deaktiviert. +Andernfalls wird nur der Zugriff auf den/die angegebenen +.IR Service /s +gesperrt. +.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 u0 b.user@example.com imap pop3 +.B vmm userdisable c.user@example.com .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 userenable (u1) +.BI "vmm userenable" " Adresse" +.RI [ "Service ..." ] +.PP +Um den Zugriff auf bestimmte oder alle gesperrten Service zu gewähren, +wird dieser Unterbefehl verwendet. +.PP +Wurde kein +.I Service +angegeben, werden alle Services +.RB ( smtp ", " pop3 ", " imap " und " sieve ) +für das Konto mit der angegebenen +.I Adresse +aktiviert. +Andernfalls wird nur der Zugriff auf den/die angegebenen +.IR Service /s +aktiviert. +.\" ------------------------------------ +.SS userinfo (ui) +.B "vmm userinfo" +.IR Adresse " [" Details ] +.PP +Dieser Unterbefehl zeigt einige Informationen über das Konto mit der +angegebenen +.I 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 Adresse , +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 +Account Informationen +--------------------- + Address........: d.user@example.com + Name...........: None + UID............: 79839 + GID............: 70312 + Home...........: /srv/mail/8/70312/79839 + Mail_Location..: mdbox:~/mdbox + Quota Storage..: [ 0,00%] 0 von 1,00 GiB + Quota Messages.: [ 0,00%] 0 von 0 + Transport......: dovecot: + SMTP...........: aktiviert + POP3...........: aktiviert + 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" " Adresse Name" +.PP +Der Bürgerliche +.I Name +des Kontoinhabers mit der angegebenen +.I Adresse +kann mit diesem Unterbefehl gesetzt/aktualisiert werden. +.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" " Adresse" +.RI [ Passwort ] +.PP +Das +.I Passwort +eines Kontos kann mit diesem Unterbefehl aktualisiert werden. +.PP +Wurde kein +.I Passwort +angegeben wird +.B vmm +dieses im interaktiven Modus erfragen. +.PP +Beispiel: .PP .nf - Beispiel: - - \fBvmm ut d.user@example.com smtp:pc105.it.example.com\fP +.B vmm up d.user@example.com \(dqA |\(rs/|0r3 5ecur3 P4s5\(rs/\(rs/0rd?\(dq .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" " Adresse Speicher" +.RI [ Nachrichten ] +.PP +Um ein neues Quota\-Limit für das Konto mit der angegebenen +.I Adresse +festzulegen, wird dieser Unterbefehl verwendet. +.PP +Wenn der Wert für das Argument +.I Nachrichten +ausgelassen wurde, wird der Vorgabewert +.B 0 +(null) als Anzahl von Nachrichten angewendet werden. +.PP +Beispiel: .PP .nf - Beispiele: - - \fBvmm u0 b.user@example.com imap\fP - \fBvmm userdisable c.user@example.com\fP +.B vmm userquota d.user@example.com 750m .fi +.\" ------------------------------------ +.SS usertransport (ut) +.BI "vmm usertransport" " Adresse 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 +.I Adresse +bestimmt werden. +.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 Dovecots lmtp setzen +.B vmm usertransport d.user@example.com lmtp:unix:private/dovecot\-lmtp +.fi +.\" ----------------------------------------------------------------------- +.SH ALIAS UNTERBEFEHLE +.SS aliasadd (aa) +.BI "vmm aliasadd" " Adresse Ziel\-Adresse ..." +.PP +Mit diesem Unterbefehl werden neue +.RI Alias\- Adresse n, +mit einer oder mehren +.IR Ziel\-Adresse (n), +erstellt. +.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 .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" " Adresse" +.RI [ Ziel\-Adresse ] +.PP +Verwenden Sie diesen Unterbefehl um den Alias mit der angegebenen +.I Adresse +zu löschen. +.PP +Wurde eine optionale +.I Ziel\-Adresse +angegeben, so wird nur diese +.I Ziel\-Adresse +vom angegebenen Alias entfernt. +.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 aliasdelete support@example.com d.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. +.\" ------------------------------------ +.SS aliasinfo (ai) +.BI "vmm aliasinfo" " Adresse" +.PP +Informationen zum Alias mit der angegebenen +.I Adresse +können mit diesem Unterbefehl ausgegeben werden. +.PP +Beispiel: +.PP +.nf +.B vmm aliasinfo support@example.com +Alias Informationen +------------------- + E\-Mails für support@example.com werden weitergeleitet an: + * e.user@example.com +.fi +.\" ----------------------------------------------------------------------- +.SH RELOCATED UNTERBEFEHLE +.SS relocatedadd (ra) +.BI "vmm relocatedadd" " Adresse Neue_Adresse" +.PP +Um einen neuen Relocated User anzulegen kann dieser Unterbefehl verwendet +werden. +.PP +Dabei ist +.I Adresse +die ehemalige Adresse des Benutzers, zum Beispiel b.nutzer@example.com, und +.I Neue_Adresse +die neue Adresse, unter der die/der Benutzer/in erreichbar ist. +.PP +Beispiel: .PP .nf - Beispiel: - \fBvmm ad support@example.com d.user@example.com\fP +.B vmm relocatedadd b.nutzer@example.com b\-nutzer@firma.tld .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. +.\" ------------------------------------ +.SS relocatedinfo (ri) +.BI "vmm relocatedinfo " Adresse +.PP +Dieser Unterbefehl zeigt die neue Adresse des Relocated Users mit mit der +angegebenen +.IR Adresse . +.PP +Beispiel: .PP .nf - Beispiel: - - \fBvmm relocatedadd b.user@example.com b-user@company.tld\fP +.B vmm relocatedinfo b.nutzer@example.com +Relocated Informationen +----------------------- + Der Benutzer „b.nutzer@example.com“ ist erreichbar unter „b\-nutzer@company.tld“ .fi -.TP -\fBrelocatedinfo\fP (\fBri\fP) \fIalte_adresse\fP -Dieser Unterbefehl zeigt die neue Adresse des relocated Users mit -\fIalte_adresse\fP. +.\" ------------------------------------ +.SS relocateddelete (rd) +.BI "vmm relocateddelete " Adresse +.PP +Mit diesem Unterbefehl kann der Relocated User mit der angegebenen +.I Adresse +gelöscht werden. +.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 relocateddelete b.nutzer@example.com .fi +.\" ----------------------------------------------------------------------- +.SH DATEIEN +.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 -\fBrelocateddelete\fP (\fBrd\fP) \fIalte_adresse\fP -Mit diesem Unterbefehl kann der relocated User mit \fIalte_adresse\fP gelöscht -werden. -.PP -.nf - Beispiel: - - \fBvmm relocateddelete b.user@example.com\fP -.fi -.\" -.SH DATEIEN -/usr/local/etc/vmm.cfg +.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 +http://sf.net/tracker/?group_id=213727&atid=1026862 +.\" ----------------------------------------------------------------------- +.SH COPYING +vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschrieben und sind unter den Bedingungen der BSD +Lizenz lizenziert. \ No newline at end of file