man/de/man1/vmm.1
changeset 571 a4aead244f75
parent 565 a75923ce2842
child 587 8767ec854084
equal deleted inserted replaced
465:c0e1fb1b0145 571:a4aead244f75
     1 .TH "VMM" "1" "17 Aug 2009" "Pascal Volk"
     1 .TH "VMM" "1" "2012-04-15" "vmm 0.6" "vmm"
     2 .SH NAME
     2 .SH NAME
     3 vmm \- Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase zu
     3 vmm \- Kommandozeilenprogramm zur Verwaltung von E\-Mail\-Domains/\-Konten
     4 verwalten.
     4 und \-Aliase.
     5 .SH SYNOPSIS
     5 .\" -----------------------------------------------------------------------
       
     6 .SH ÜBERSICHT
     6 .B vmm
     7 .B vmm
     7 \fIUnterbefehl\fP \fIObjekt\fP [ \fIArgumente\fP ]
     8 .IR Unterbefehl " [" "Argument ..." ]
       
     9 .\" -----------------------------------------------------------------------
     8 .SH BESCHREIBUNG
    10 .SH BESCHREIBUNG
     9 \fBvmm\fP (Virtual Mail Manager) ist ein Kommandozeilen-Werkzeug für
    11 .B vmm
    10 Administratoren/Postmaster zur Verwaltung von Domains, Konten und Aliase. Es
    12 (a virtual mail manager) ist das einfach zu bedienende
    11 wurde entwickelt für Dovecot und Postfix mit einem PostgreSQL-Backend.
    13 Kommandozeilenprogramm für Administratoren und Postmaster, zur Verwaltung
    12 .SH UNTERBEFEHLE
    14 von (Alias\-) Domains, Konten, Alias\-Adressen und sogenannten Relocated
    13 Von jedem Unterbefehl gibt es jeweils eine lange und kurze Variante. Bei beiden
    15 Users.
    14 Formen ist die Groß-/Kleinschreibung zu berücksichtigen.
    16 Es ermöglicht die schnelle und einfache Verwaltung des Mailservers.
    15 .SS ALLGEMEINE UNTERBEFEHLE
       
    16 .TP
       
    17 \fBconfigure\fP (\fBcf\fP) [ \fIAbschnitt\fP ]
       
    18 Startet den interaktiven Konfiguration-Modus für alle Konfigurations-Abschnitte.
       
    19 .br
    17 .br
    20 Wurde das optionale Argument \fIAbschnitt\fP angegeben, werden nur die Optionen
    18 Es wurde für Dovecot und Postfix mit einem PostgreSQL\-Backend entwickelt.
    21 des angegebenen Abschnitts angezeigt und können geändert werden. Folgende
    19 .PP
    22 Abschnitte sind vorhanden:
    20 Von jedem
       
    21 .I Unterbefehl
       
    22 gibt es jeweils eine lange und kurze Variante.
       
    23 Die Kurzform ist in Klammern geschrieben.
       
    24 Bei beiden Formen ist die Groß\-/Kleinschreibung zu berücksichtigen.
       
    25 .PP
       
    26 Die meisten
       
    27 .IR Unterbefehl e
       
    28 erwarten ein oder mehrere
       
    29 .IR Argument e.
       
    30 .\" -----------------------------------------------------------------------
       
    31 .SH ARGUMENTE
       
    32 .TP 12
       
    33 .I address
       
    34 Die komplette E\-Mail\-Adresse
       
    35 .RI ( local\-part @ fqdn )
       
    36 eines Kontos, Aliases oder Relocated Users.
       
    37 .\" --------------------------
       
    38 .TP
       
    39 .I destination
       
    40 Ist entweder eine E\-Mail\-Adresse, wenn sie in Verbindung mit
       
    41 .I "ALIAS UNTERBEFEHLEN"
       
    42 verwendet wird, oder ein
       
    43 .I fqdn
       
    44 in Verbindung mit
       
    45 .IR "ALIASDOMAIN UNTERBEFEHLEN" .
       
    46 .\" --------------------------
       
    47 .TP
       
    48 .I fqdn
       
    49 Der voll qualifizierten Domain\-Namen \(em ohne den abschließenden Punkt
       
    50 \(em einer Domain oder Alias\-Domain.
       
    51 .\" --------------------------
       
    52 .TP
       
    53 .I messages
       
    54 Ein Integer\-Wert, der das maximal nutzbare Kontingent als Anzahl von
       
    55 Nachrichten festlegt.
       
    56 .br
       
    57 Der Wert
       
    58 .B 0
       
    59 (null) bedeutet unbegrenzt \(em kein Quota\-Limit als Anzahl von
       
    60 Nachrichten.
       
    61 .\" --------------------------
       
    62 .TP
       
    63 .I option
       
    64 ist der Name einer Konfigurationsoption mit vorangestellter
       
    65 Konfigurations\-Sektion, getrennt durch einen Punkt.
       
    66 Zum Beispiel:
       
    67 .IB misc . transport
       
    68 .br
       
    69 Alle Konfigurationsoptionen werden in
       
    70 .BR vmm.cfg (5)
       
    71 beschrieben.
       
    72 .\" --------------------------
       
    73 .TP
       
    74 .I service
       
    75 Der Name eines Services, der gewöhnlicherweise in Verbindung mit Dovecot
       
    76 genutzt wird.
       
    77 Folgende Services werden unterstützt:
       
    78 .BR imap ", " pop3 ", " sieve " und " smtp .
       
    79 .\" --------------------------
       
    80 .TP
       
    81 .I storage
       
    82 Bestimmt das maximal nutzbare Kontingent in Bytes.
       
    83 Eines der folgenden Präfixe kann dem dem ganzzahligen Wert angehängt
       
    84 werden:
       
    85 .BR b " (Bytes), " k " (Kilobytes), " M " (Megabytes) oder " G
       
    86 (Gigabytes).
       
    87 .br
       
    88 Der Wert
       
    89 .B 0
       
    90 (null) bedeutet unbegrenzt \(em kein Quota\-Limit in Bytes.
       
    91 .\" --------------------------
       
    92 .TP
       
    93 .I transport
       
    94 ein Transport für Postfix, angegeben in der Form:
       
    95 .IB transport :
       
    96 oder
       
    97 .IB transport :\c
       
    98 .IR nexthop .
       
    99 Siehe
       
   100 .BR transport (5)
       
   101 für weitere Details.
       
   102 .\" -----------------------------------------------------------------------
       
   103 .SH ALLGEMEINE UNTERBEFEHLE
       
   104 .SS configget (cg)
       
   105 .BI "vmm configget" " option"
       
   106 .PP
       
   107 Dieser Unterbefehl wird verwendet, um den aktuellen Wert der übergebenen
       
   108 .I option
       
   109 anzuzeigen.
       
   110 .PP
       
   111 Beispiel:
       
   112 .PP
       
   113 .nf
       
   114 .B vmm configget misc.crypt_sha512_rounds
       
   115 misc.crypt_sha512_rounds = 5000
       
   116 .fi
       
   117 .\" --------------------------
       
   118 .SS configset (cs)
       
   119 .B vmm configset
       
   120 .I option value
       
   121 .PP
       
   122 Verwenden Sie diesen Unterbefehl, um einer einzelnen Konfigurationsoption
       
   123 einen neuen Wert zuzuweisen.
       
   124 .I option
       
   125 ist der Name der Konfigurationsoption,
       
   126 .I value
       
   127 ist der Wert, der der Konfigurationsoption zugewiesen wird.
       
   128 .IP Hinweis:
       
   129 Diese Unterbefehl erstellt eine neue
       
   130 .IR vmm.cfg ,
       
   131 ohne Kommentare.
       
   132 Die aktuelle Konfigurationsdatei wird als
       
   133 .IR vmm.cfg.bak
       
   134 gesichert.
       
   135 .PP
       
   136 Beispiel:
       
   137 .PP
       
   138 .nf
       
   139 .B vmm configget domain.transport
       
   140 domain.transport = dovecot:
       
   141 .B vmm configset domain.transport lmtp:unix:private/dovecot\-lmtp
       
   142 .B vmm cg domain.transport
       
   143 domain.transport = lmtp:unix:private/dovecot\-lmtp
       
   144 .fi
       
   145 .\" ------------------------------------
       
   146 .SS configure (cf)
       
   147 .B vmm configure
       
   148 .RI [ section ]
       
   149 .PP
       
   150 Startet die interaktiven Konfiguration für alle Konfigurationssektionen.
       
   151 .PP
       
   152 Dabei wird der aktuell konfigurierte Wert einer jeden Option in eckigen
       
   153 Klammern ausgegeben.
       
   154 Sollte kein Wert konfiguriert sein, wird der Vorgabewert der jeweiligen
       
   155 Option in in eckigen Klammern angezeigt.
       
   156 Um den angezeigten Wert unverändert zu übernehmen, ist dieser mit der
       
   157 Eingabe\-Taste zu bestätigen.
       
   158 .PP
       
   159 Wurde das optionale Argument
       
   160 .I section
       
   161 angegeben, werden nur die Optionen der angegebenen Sektion angezeigt und
       
   162 können geändert werden.
       
   163 Folgende Sektionen sind vorhanden:
    23 .RS
   164 .RS
    24 .PD 0
   165 .TP 10
    25 .TP
   166 .B account
    26 -
   167 Konto Einstellungen
    27 .B
   168 .TP
    28 database
   169 .B bin
    29 .TP
   170 Pfade zu externen Binär\-Dateien
    30 -
   171 .TP
    31 .B
   172 .B database
    32 maildir
   173 Datenbank Einstellungen
    33 .TP
   174 .TP
    34 -
   175 .B domain
    35 .B
   176 Domain Einstellungen
    36 services
   177 .TP
    37 .TP
   178 .B mailbox
    38 -
   179 Mailbox Einstellungen
    39 .B
   180 .TP
    40 domdir
   181 .B misc
    41 .TP
   182 Verschiedene Einstellungen
    42 -
       
    43 .B
       
    44 bin
       
    45 .TP
       
    46 -
       
    47 .B
       
    48 misc
       
    49 .PD
       
    50 .RE
   183 .RE
    51 .LP
   184 .PP
    52 .PP
   185 Die Konfigurationsoptionen werden in
    53 .nf
   186 .BR vmm.cfg (5)
    54         Beispiel:
   187 beschrieben.
       
   188 .IP Hinweis:
       
   189 Diese Unterbefehl erstellt eine neue
       
   190 .IR vmm.cfg ,
       
   191 ohne Kommentare.
       
   192 Die aktuelle Konfigurationsdatei wird als
       
   193 .IR vmm.cfg.bak
       
   194 gesichert.
       
   195 .PP
       
   196 Beispiel:
       
   197 .PP
       
   198 .nf
       
   199 .B vmm configure mailbox
       
   200 Konfigurationsdatei wird verwendet: /root/vmm.cfg
    55 
   201 
    56         \fBvmm configure services\fP
   202 * Konfigurationsabschnitt: »mailbox«
    57         Verwende Konfigurationsdatei: /usr/local/etc/vmm.cfg
   203 Neuer Wert für Option folders [Drafts:Sent:Templates:Trash]:
       
   204 Neuer Wert für Option format [maildir]: mdbox
       
   205 Neuer Wert für Option subscribe [True]:
       
   206 Neuer Wert für Option root [Maildir]: mdbox
       
   207 .fi
       
   208 .\" ------------------------------------
       
   209 .SS getuser (gu)
       
   210 .BI "vmm getuser" " uid"
       
   211 .PP
       
   212 Wenn nur der
       
   213 .I uid
       
   214 eines Benutzers vorhanden ist, zum Beispiel aus der Prozessliste, kann mit
       
   215 dem Unterbefehl
       
   216 .B getuser
       
   217 die E\-Mail\-Adresse des Benutzers ermittelt werden.
       
   218 .PP
       
   219 Beispiel:
       
   220 .PP
       
   221 .nf
       
   222 .B vmm getuser 79876
       
   223 Konto Informationen
       
   224 -------------------
       
   225         UID............: 79876
       
   226         GID............: 70704
       
   227         Address........: a.user@example.com
       
   228 .fi
       
   229 .\" ------------------------------------
       
   230 .SS help (h)
       
   231 .B vmm help
       
   232 .RI [ subcommand ]
       
   233 .PP
       
   234 Gibt ein Liste aller vorhandenen Unterbefehle mit einer kurzen Beschreibung
       
   235 aus.
       
   236 Wurde ein
       
   237 .I subcommand
       
   238 angegeben, wird Hilfe zu diesem Unterbefehl ausgegeben.
       
   239 Danach wird
       
   240 .B vmm
       
   241 beendet.
       
   242 .\" ------------------------------------
       
   243 .SS listdomains (ld)
       
   244 .B vmm listdomains
       
   245 .RI [ pattern ]
       
   246 .PP
       
   247 Dieser Unterbefehl listet alle angelegten Domains auf.
       
   248 Allen Domains wird ein Präfix vorangestellt.
       
   249 Entweder ein `[+]', falls es sich um eine primäre Domain handelt, oder ein
       
   250 `[-]', falls es sich um eine Alias\-Domain handelt.
       
   251 Die Ausgabe kann reduziert werden, indem ein optionales Muster angegeben
       
   252 wird.
       
   253 .PP
       
   254 Um eine Wildcard\-Suche durchzuführen kann das %\-Zeichen am Anfang
       
   255 und/oder Ende des Musters verwendet werden.
       
   256 .PP
       
   257 Beispiel:
       
   258 .PP
       
   259 .nf
       
   260 .B vmm listdomains %example%
       
   261 Übereinstimmende Domains
       
   262 ------------------------
       
   263         [+] example.com
       
   264         [\-]     e.g.example.com
       
   265         [\-]     example.name
       
   266         [+] example.org
       
   267         [+] sales.example.com
       
   268 .fi
       
   269 .\" ------------------------------------
       
   270 .SS listpwschemes (lp)
       
   271 .B vmm listpwschemes
       
   272 .PP
       
   273 Dieser Unterbefehl listet alle unterstützte Passwort\-Schemen, die als Wert
       
   274 für
       
   275 .I misc.password_scheme
       
   276 in der
       
   277 .I vmm.cfg
       
   278 verwendet werden können.
       
   279 Die Ausgabe variiert, je nach eingesetzter Dovecot Version und der libc des
       
   280 Systems.
       
   281 .br
       
   282 Sollte Ihre Dovecot\-Installation nicht zu alt sein, werden zusätzlich
       
   283 die verwendbaren Encoding\-Suffixe ausgegeben.
       
   284 Eines dieser Suffixe kann an das Passwort\-Schema angefügt werden.
       
   285 .PP
       
   286 Beispiel:
       
   287 .PP
       
   288 .nf
       
   289 .B vmm listpwschemes
       
   290 Verfügbare Passwort-Schemata
       
   291 ----------------------------
       
   292         CRYPT SHA512-CRYPT LDAP-MD5 DIGEST-MD5 SHA256 SHA512 SSHA512
       
   293         SKEY SSHA NTLM RPA MD5-CRYPT HMAC-MD5 SHA1 PLAIN SHA CRAM-MD5
       
   294         SSHA256 MD5 LANMAN CLEARTEXT PLAIN-MD5 PLAIN-MD4 OTP SMD5
       
   295         SHA256-CRYPT
    58 
   296 
    59         * Konfigurations Abschnitt: „services“
   297 Verwendbare Encoding-Suffixe
    60         Neuer Wert für Option pop3 [True]: 
   298 ----------------------------
    61         Neuer Wert für Option smtp [True]: 
   299         .B64 .BASE64 .HEX
    62         Neuer Wert für Option imap [True]: 
   300 .fi
    63         Neuer Wert für Option sieve [True]: false
   301 .\" ------------------------------------
    64 .fi
   302 .SS version (v)
    65 .PP
   303 .B vmm version
    66 .TP
   304 .PP
    67 \fBgetuser\fP (\fBgu\fP) \fIuserid\fP
   305 Gibt Versions\- und Copyright\-Informationen zu
    68 Wenn nur eine UserID vorhanden ist, z. B. aus der Prozessliste, kann mit dem
   306 .B vmm
    69 Unterbefehl \fBgetuser\fP die E-Mail-Adresse des Users ermittelt werden.
   307 aus.
    70 .PP
   308 Danach wird
    71 .nf
   309 .B vmm
    72         Beispiel:
   310 beendet.
    73 
   311 .\" -----------------------------------------------------------------------
    74         \fBvmm getuser 70004\fP
   312 .SH DOMAIN UNTERBEFEHLE
    75         Account Informationen
   313 .SS domainadd (da)
    76         ---------------------
   314 .B vmm domainadd
    77                 UID............: 70004
   315 .IR fqdn " [" transport ]
    78                 GID............: 70000
   316 .PP
    79                 Address........: c.user@example.com
   317 Fügt eine neue Domain in die Datenbank ein und erstellt das
    80 .fi
   318 Domain\-Verzeichnis.
    81 .\"
   319 .PP
    82 .TP
   320 Wurde das optional Argument
    83 \fBlistdomains\fP (\fBld\fP) [ \fIMuster\fP ]
   321 .I transport
    84 Dieser Unterbefehl listet alle verfügbaren Domains auf. Allen Domains wird ein
   322 angegeben, ersetzt der angegebene Transport den konfigurierten Transport
    85 Präfix vorangestellt. Entweder ein '[+]', falls es sich um eine primäre Domain
   323 .RI ( misc.transport ") aus " vmm.cfg .
    86 handelt, oder ein '[-]', falls es sich um eine Alias-Domain handelt.  Die
   324 Der angegebene
    87 Ausgabe kann reduziert werden, indem ein optionales \fIMuster\fP angegeben wird.
   325 .I transport
    88 .br
   326 ist der Vorgabe\-Transport für alle Konten, die dieser Domain zugeordnet
    89 Um eine Wildcard-Suche durchzuführen kann das %-Zeichen am Anfang und/oder Ende
   327 werden.
    90 des \fIMusters\fP verwendet werden.
   328 .PP
    91 .PP
   329 Konfigurationsbezogenes Verhalten:
    92 .nf
       
    93         Beispiel:
       
    94 
       
    95         \fBvmm listdomains %example%\fP
       
    96         Übereinstimmende Domains
       
    97         ------------------------
       
    98                 [+] example.com
       
    99                 [-]     e.g.example.com
       
   100                 [-]     example.name
       
   101                 [+] example.net
       
   102                 [+] example.org
       
   103 .fi
       
   104 .\"
       
   105 .TP
       
   106 \fBhelp\fP (\fBh\fP)
       
   107 Dieser Unterbefehl gibt alle verfügbaren Kommandos auf stdout aus. Danach
       
   108 beendet sich \fBvmm\fP.
       
   109 .TP
       
   110 \fBversion\fP (\fBv\fP)
       
   111 Gibt Versions-Informationen zu \fBvmm\fP aus.
       
   112 .\"
       
   113 .SS DOMAIN UNTERBEFEHLE
       
   114 .TP
       
   115 \fBdomainadd\fP (\fBda\fP) \fIDomain\fP [ \fITransport\fP ]
       
   116 Fügt eine neue \fIDomain\fP in die Datenbank ein.
       
   117 .br
       
   118 Ist das optionale Argument \fITransport\fP angegeben, wird der Vorgabe-Transport
       
   119 aus \fBvmm.cfg\fP (misc/transport) für diese \fIDomain\fP ignoriert und der
       
   120 angegebene \fITransport\fP verwendet. Der angegebene \fITransport\fP ist
       
   121 gleichzeitig der Vorgabe-Transport für alle neuen Konten, die unter dieser
       
   122 Domain eingerichtet werden.
       
   123 .PP
       
   124 .nf
       
   125         Beispiele:
       
   126 
       
   127         \fBvmm domainadd support.example.com smtp:mx1.example.com
       
   128         vmm domainadd sales.example.com\fP
       
   129 .fi
       
   130 .TP
       
   131 \fBdomaininfo\fP (\fBdi\fP) \fIDomain\fP [ \fIdetails\fP ]
       
   132 Dieser Unterbefehl zeigt Information zur angegeben \fIDomain\fP an.
       
   133 .br
       
   134 Um detaillierte Informationen über die \fIDomain\fP zu erhalten, kann das
       
   135 optionale Argument \fIdetails\fP angegeben werden. Ein möglicher Wert für
       
   136 \fIdetails\fP kann eines der folgenden fünf Schlüsselwörter sein:
       
   137 .RS
   330 .RS
   138 .PD 0
   331 .TP
   139 .TP
   332 .I domain.auto_postmaster
       
   333 Wenn diese Option den Wert
       
   334 .B true
       
   335 (Vorgabe) hat, wird
       
   336 .B vmm
       
   337 nach erfolgreichem Anlegen der Domain auch das Konto für
       
   338 .BI postmaster@ fqdn
       
   339 erstellen.
       
   340 .TP
       
   341 .I account.random_password
       
   342 Sollte dieser Option ebenfalls der Wert
       
   343 .B true
       
   344 zugewiesen sein, wird ein zufällig generiertes Passwort für den
       
   345 Postmaster\-Account gesetzt und auf stdout ausgegeben.
       
   346 .RE
       
   347 .PP
       
   348 Beispiele:
       
   349 .PP
       
   350 .nf
       
   351 .B vmm domainadd support.example.com smtp:[mx1.example.com]:2025
       
   352 Konto für postmaster@support.example.com wird angelegt
       
   353 Neues Passwort eingeben:
       
   354 Neues Passwort wiederholen:
       
   355 .B vmm cs account.random_password true
       
   356 .B vmm domainadd vertrieb.example.com
       
   357 Konto für postmaster@vertrieb.example.com wird angelegt
       
   358 Erzeugtes Passwort: YoG3Uw*5aH
       
   359 .fi
       
   360 .\" ------------------------------------
       
   361 .SS domaindelete (dd)
       
   362 .BI "vmm domaindelete " fqdn
       
   363 .RB [ force ]
       
   364 .PP
       
   365 Dieser Unterbefehl löscht die Domain mit dem angegebenen
       
   366 .IR fqdn .
       
   367 .PP
       
   368 Sollten der zu löschenden Domain Konten, Aliase und/oder Relocated User
       
   369 zugeordnet sein, wird
       
   370 .B vmm
       
   371 die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden.
       
   372 Sollten Sie sich Ihres Vorhabens sicher sein, so kann optional das
       
   373 Schlüsselwort
       
   374 .B force
       
   375 angegeben werden.
       
   376 .PP
       
   377 Sollten Sie wirklich immer wissen was Sie tun, so editieren Sie Ihre
       
   378 .I vmm.cfg
       
   379 und setzen den Wert der Option
       
   380 .I domain.force_deletion
       
   381 auf
       
   382 .BR true .
       
   383 Dann werden Sie zukünftig beim Löschen von Domains nicht mehr wegen
       
   384 vorhanden Konten, Aliase und/oder Relocated User gewarnt.
       
   385 .\" ------------------------------------
       
   386 .SS domaininfo (di)
       
   387 .B vmm domaininfo
       
   388 .IR fqdn \ [ details ]
       
   389 .PP
       
   390 Dieser Unterbefehl zeigt Informationen zur Domain mit dem angegebenen
       
   391 .I fqdn
       
   392 an.
       
   393 .PP
       
   394 Um detaillierte Informationen über die Domain zu erhalten, kann das
       
   395 optionale Argument
       
   396 .I details
       
   397 angegeben werden.
       
   398 Ein möglicher Wert für
       
   399 .I details
       
   400 kann eines der folgenden fünf Schlüsselwörter sein:
       
   401 .RS
       
   402 .TP 13
   140 .B accounts
   403 .B accounts
   141 um alle existierenden Konten aufzulisten
   404 um alle eingerichteten Konten aufzulisten
   142 .TP
   405 .TP
   143 .B aliasdomains
   406 .B aliasdomains
   144 um alle zugeordneten Alias-Domains aufzulisten
   407 um alle zugeordneten Alias\-Domains aufzulisten
   145 .TP
   408 .TP
   146 .B aliases
   409 .B aliases
   147 um alle verfügbaren Alias-Adressen aufzulisten
   410 um alle vorhandenen Alias\-Adressen aufzulisten
   148 .TP
   411 .TP
   149 .B relocated
   412 .B relocated
   150 um alle Adressen der relocated Users aufzulisten
   413 um alle Adressen der Relocated Users aufzulisten
       
   414 .TP
       
   415 .B catchall
       
   416 um alle Catch\-all\-Ziele aufzulisten
   151 .TP
   417 .TP
   152 .B full
   418 .B full
   153 um alle oben genannten Informationen aufzulisten
   419 um alle oben genannten Informationen aufzulisten
   154 .PD
       
   155 .RE
   420 .RE
   156 .LP
   421 .PP
   157 .PP
   422 Beispiel:
   158 .nf
   423 .PP
   159         Beispiel:
   424 .nf
   160 
   425 .B vmm domaininfo sales.example.com
   161         \fBvmm domaininfo sales.example.com\fP
   426 Domain Informationen
   162         Domain Informationen
   427 --------------------
   163         --------------------
   428         Domain Name......: sales.example.com
   164                 Domainname.....: sales.example.com
   429         GID..............: 70708
   165                 GID............: 70002
   430         Domain Directory.: /srv/mail/c/70708
   166                 Transport......: dovecot:
   431         Quota Limit/User.: Storage: 500,00 MiB; Messages: 10.000
   167                 Domaindir......: /home/mail/5/70002
   432         Active Services..: IMAP SIEVE
   168                 Aliasdomains...: 0
   433         Transport........: lmtp:unix:private/dovecot-lmtp
   169                 Accounts.......: 0
   434         Alias Domains....: 0
   170                 Aliases........: 0
   435         Accounts.........: 1
   171                 Relocated......: 0
   436         Aliases..........: 0
   172 
   437         Relocated........: 0
   173 .fi
   438         Catch-All Dests..: 1
   174 .TP
   439 .fi
   175 \fBdomaintransport\fP (\fBdt\fP) \fIDomain\fP \fITransport\fP [ \fIforce\fP ]
   440 .\" ------------------------------------
   176 Ein neuer \fITransport\fP für die angegebene \fIDomain\fP kann mit diesem
   441 .SS domainquota (dq)
   177 Unterbefehl festgelegt werden.
   442 .B vmm domainquota
       
   443 .IR "fqdn storage" " [" messages ]
       
   444 .RB [ force ]
       
   445 .PP
       
   446 Dieser Unterbefehl wird verwendet, um für die Konten der Domain ein neues
       
   447 Quota\-Limit festzulegen.
       
   448 .PP
       
   449 Standardmäßig gilt für Konten das Quota\-Limit der
       
   450 .IR vmm.cfg " (" domain.quota_bytes " und " domain.quota_messages ).
       
   451 Das neue Quota\-Limit gilt für für alle bestehenden Konten, die nicht selbst
       
   452 ein Quota\-Limit definieren. Soll das neue Quota\-Limit auch für Konten mit
       
   453 eigenen Limiten angewendet werden, so ist das optionale Schlüsselwort
       
   454 .B force
       
   455 anzugeben.
   178 .br
   456 .br
   179 Wurde das optionale Schlüsselwort '\fBforce\fP' angegeben, so werden alle
   457 Wenn der Wert für das Argument
   180 bisherigen Transport-Einstellungen, der in dieser Domain vorhandenen Konten,
   458 .I messages
   181 mit dem neuen \fITransport\fP überschrieben.
   459 ausgelassen wurde, wird der Vorgabewert
       
   460 .B 0
       
   461 (null) als Anzahl von Nachrichten angewendet werden.
       
   462 .PP
       
   463 Beispiel:
       
   464 .PP
       
   465 .nf
       
   466 .B vmm domainquota example.com 1g force
       
   467 .fi
       
   468 .\" ------------------------------------
       
   469 .SS domainservices (ds)
       
   470 .B vmm domainservices
       
   471 .IR fqdn " [" "service ..." ]
       
   472 .RB [ force ]
       
   473 .PP
       
   474 Um festzulegen, welche Services für die Anwender der Domain \(em mit dem
       
   475 angegebenen
       
   476 .I fqdn
       
   477 \(em nutzbar sein sollen, wird dieser Unterbefehl verwendet.
       
   478 .PP
       
   479 Der Zugriff auf alle genannten Services wird den Anwender gestattet.
       
   480 Der Zugriff auf nicht genannte Services wird verweigert werden.
       
   481 Verwendbare
       
   482 .IR service \-Namen
       
   483 sind:
       
   484 .BR  imap ", " pop3 ", " sieve " und " smtp .
   182 .br
   485 .br
   183 Andernfalls gilt der neue \fITransport\fP nur für Konten, die neu erstellt
   486 Wird das Schlüsselwort
   184 werden.
   487 .B force
   185 .PP
   488 angegeben, so werden alle kontospezifischen Einstellungen gelöscht und es
   186 .nf
   489 gelten fortan die Service\-Einstellungen der Domain für alle Konten. Ohne
   187         Beispiel:
   490 dieses Schlüsselwort gelten die neuen Einstellungen nur für Konten, bei denen
   188 
   491 die Service\-Einstellungen nicht individuell geändert wurden.
   189         \fBvmm domaintransport support.example.com dovecot:\fP
   492 .\" ------------------------------------
   190 .fi
   493 .SS domaintransport (dt)
   191 .TP
   494 .BI "vmm domaintransport" " fqdn transport"
   192 \fBdomaindelete\fP (\fBdd\fP) \fIDomain\fP [ \fIdelalias\fP | \fIdeluser\fP | \fIdelall\fP ]
   495 .RB [ force ]
   193 Mit diesem Unterbefehl wird die angegebene \fIDomain\fP gelöscht.
   496 .PP
       
   497 Ein neuer
       
   498 .I transport
       
   499 für die Domain mit dem angegebenen
       
   500 .I fqdn
       
   501 kann mit diesem Unterbefehl festgelegt werden.
       
   502 .PP
       
   503 Wird das Schlüsselwort
       
   504 .B force
       
   505 angegeben, so werden alle kontospezifischen Einstellungen gelöscht und es
       
   506 gelten fortan die Transport\-Einstellungen der Domain für alle Konten. Ohne
       
   507 dieses Schlüsselwort gelten die neuen Einstellungen nur für Konten, bei denen
       
   508 die Transport\-Einstellungen nicht individuell geändert wurden.
       
   509 .PP
       
   510 Beispiel:
       
   511 .PP
       
   512 .nf
       
   513 .B vmm domaintransport support.example.com dovecot:
       
   514 .fi
       
   515 .\" ------------------------------------
       
   516 .SS domainnote (do)
       
   517 .BI "vmm domainnote" " fqdn"
       
   518 .RI [ note ]
       
   519 .PP
       
   520 Mit diesem Unterbefehl kann eine Domain mit einer Notiz versehen werden. Um
       
   521 die Notiz wieder zu löschen, läßt man sie einfach weg.
       
   522 .PP
       
   523 Beispiel:
       
   524 .PP
       
   525 .nf
       
   526 .B vmm do example.com Gehört Robert
       
   527 .fi
       
   528 .\" -----------------------------------------------------------------------
       
   529 .SH ALIAS\-DOMAIN UNTERBEFEHLE
       
   530 Eine Alias\-Domain ist ein Alias für eine Domain, die zuvor mit dem
       
   531 Unterbefehl
       
   532 .B domainadd
       
   533 erstellt wurde.
       
   534 Alle Konten, Aliase und Relocated Users der Domain sind ebenfalls unter der
       
   535 Alias\-Domain verfügbar.
   194 .br
   536 .br
   195 Sollten der \fIDomain\fP Konten und/oder Aliase zugeordnet sein, wird \fBvmm\fP
   537 Im Folgenden wird angenommen, example.net sei ein Alias für example.com.
       
   538 .PP
       
   539 Postfix wird nicht erst fälschlicherweise E\-Mails für
       
   540 unbekannten.user@example.net annehmen und später an den \(em oftmals
       
   541 gefälschten \(em Absender bouncen.
       
   542 Postfix wird E\-Mails an unbekannte Empfänger sofort ablehnen.
       
   543 .br
       
   544 Dieses Verhalten ist sichergestellt, solange die empfohlenen
       
   545 Datenbankabfragen in
       
   546 .I $config_directory/pgsql\-*.cf
       
   547 konfiguriert sind.
       
   548 .\" ------------------------------------
       
   549 .SS aliasdomainadd (ada)
       
   550 .BI "vmm aliasdomainadd" " fqdn destination"
       
   551 .PP
       
   552 Dieser Unterbefehl legt die Alias\-Domain
       
   553 .RI ( fqdn )
       
   554 als Alias für eine bestehende Domain
       
   555 .RI ( destination ") an."
       
   556 .PP
       
   557 Beispiel:
       
   558 .PP
       
   559 .nf
       
   560 .B vmm aliasdomainadd example.net example.com
       
   561 .fi
       
   562 .\" ------------------------------------
       
   563 .SS aliasdomaindelete (add)
       
   564 .BI "vmm aliasdomaindelete" " fqdn"
       
   565 .PP
       
   566 Verwenden Sie diesen Unterbefehl, um die Alias\-Domain
       
   567 .I fqdn
       
   568 zu löschen.
       
   569 .PP
       
   570 Beispiel:
       
   571 .PP
       
   572 .nf
       
   573 .B vmm aliasdomaindelete e.g.example.com
       
   574 .fi
       
   575 .\" ------------------------------------
       
   576 .SS aliasdomaininfo (adi)
       
   577 .BI "vmm aliasdomaininfo" " fqdn"
       
   578 .PP
       
   579 Dieser Unterbefehl gibt Informationen darüber aus, welcher Domain die
       
   580 Alias\-Domain
       
   581 .I fqdn
       
   582 aktuell zugeordnet ist.
       
   583 .PP
       
   584 Beispiel:
       
   585 .PP
       
   586 .nf
       
   587 .B vmm adi example.net
       
   588 Alias\-Domain Informationen
       
   589 --------------------------
       
   590         Die Alias\-Domain example.net gehört zu:
       
   591             * example.com
       
   592 .fi
       
   593 .\" ------------------------------------
       
   594 .SS aliasdomainswitch (ads)
       
   595 .BI "vmm aliasdomainswitch" " fqdn destination"
       
   596 .PP
       
   597 Wenn Sie die bereits vorhandene Alias\-Domain
       
   598 .I fqdn
       
   599 einer anderen Ziel\-Domain zuordnen wollen, verwenden Sie diesen
       
   600 Unterbefehl.
       
   601 .PP
       
   602 Beispiel:
       
   603 .PP
       
   604 .nf
       
   605 .B vmm aliasdomainswitch example.net example.org
       
   606 .fi
       
   607 .\" -----------------------------------------------------------------------
       
   608 .SH KONTO UNTERBEFEHLE
       
   609 .SS useradd (ua)
       
   610 .B vmm useradd
       
   611 .IR address " [" password ]
       
   612 .PP
       
   613 Mit diesem Unterbefehl wird ein neues Konto für die angegebene Adresse
       
   614 angelegt.
       
   615 .PP
       
   616 Wurde kein Passwort angegeben wird
       
   617 .B vmm
       
   618 dieses im interaktiven Modus erfragen.
       
   619 Falls kein Passwort angegeben wurde und
       
   620 .I account.random_password
       
   621 den Wert
       
   622 .B true
       
   623 hat, wird
       
   624 .B vmm
       
   625 ein zufälliges Passwort generieren und auf stdout ausgeben, nachdem das
       
   626 Konto angelegt wurde.
       
   627 .PP
       
   628 Beispiele:
       
   629 .PP
       
   630 .nf
       
   631 .B vmm ua d.user@example.com \(dqA 5ecR3t P4s5\(rs/\(rs/0rd\(dq
       
   632 .B vmm useradd e.user@example.com
       
   633 Neues Passwort eingeben:
       
   634 Neues Passwort wiederholen:
       
   635 .fi
       
   636 .\" ------------------------------------
       
   637 .SS userdelete (ud)
       
   638 .BI "vmm userdelete" " address"
       
   639 .RB [ force ]
       
   640 .PP
       
   641 Verwenden Sie diesen Unterbefehl, um das Konto mit der angegebenen Adresse
       
   642 zu löschen.
       
   643 .PP
       
   644 Sollte es einen oder mehrere Aliase geben, deren Ziel\-Adresse mit der
       
   645 Adresse des zu löschenden Kontos identisch ist, wird
       
   646 .B vmm
   196 die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden.
   647 die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden.
   197 
   648 Um dieses zu umgehen, kann das optionale Schlüsselwort
   198 Sollten Sie sich Ihres Vorhabens sicher sein, so kann optional eines der
   649 .B force
   199 folgenden Schlüsselwörter angegeben werden: '\fBdelalias\fP', '\fBdeluser\fP' oder '\fBdelall\fP'
   650 angegebenen werden.
   200 
   651 .\" ------------------------------------
   201 Sollten Sie wirklich immer wissen was Sie tun, so editieren Sie Ihre
   652 .SS userinfo (ui)
   202 \fBvmm.cfg\fP und setzen den Wert der Option \fIforcedel\fP, im Abschnitt
   653 .B "vmm userinfo"
   203 \fImisc\fP, auf true. Dann werden Sie beim Löschen von Domains nicht mehr wegen
   654 .IR address " [" details ]
   204 vorhanden Konten/Aliase gewarnt.
   655 .PP
   205 .\"
   656 Dieser Unterbefehl zeigt einige Informationen über das Konto mit der
   206 .SS ALIAS-DOMAIN UNTERBEFEHLE
   657 angegebenen Adresse an.
   207 .TP
   658 .PP
   208 \fBaliasdomainaddd\fP (\fBada\fP) \fIAliasdomain\fP \fIZieldomain\fP
   659 Wurde das optionale Argument
   209 Mit diesem Unterbefehl wird der \fIZieldomain\fP die Alias-Domain
   660 .I details
   210 \fIAliasdomain\fP zugewiesen.
   661 angegeben, werden weitere Informationen ausgegeben.
   211 .PP
   662 Mögliche Werte für
   212 .nf
   663 .I details
   213         Beispiel:
   664 sind:
   214 
       
   215         \fBvmm aliasdomainadd example.name example.com\fP
       
   216 .fi
       
   217 .TP
       
   218 \fBaliasdomaininfo (\fBadi\fP) \fIAliasdomain\fP
       
   219 Dieser Unterbefehl informiert darüber, welcher Domain die Alias-Domain
       
   220 \fIAliasdomain\fP zugeordnet ist.
       
   221 .PP
       
   222 .nf
       
   223         Beispiel:
       
   224 
       
   225         \fBvmm aliasdomaininfo example.name\fP
       
   226         Alias-Domain Informationen
       
   227         --------------------------
       
   228                 Die Alias-Domain example.name gehört zu:
       
   229                     * example.com
       
   230 .fi
       
   231 .TP
       
   232 \fBaliasdomainswitch\fP (\fBads\fP) \fIAliasdomain\fP \fIZieldomain\fP
       
   233 Wenn das Ziel der vorhandenen \fIAliasdomain\fP auf eine andere \fIZieldomain\fP
       
   234 geändert werden soll, ist dieser Unterbefehl zu verwenden.
       
   235 .PP
       
   236 .nf
       
   237         Beispiel:
       
   238 
       
   239         \fBvmm aliasdomainswitch example.name example.org\fP
       
   240 .fi
       
   241 .TP
       
   242 \fBaliasdomaindelete\fP (\fBadd\fP) \fIAliasdomain\fP
       
   243 Wenn die Alias-Domain mit dem Namen \fIAliasdomain\fP gelöscht werden soll, ist
       
   244 dieser Unterbefehl zu verwenden.
       
   245 .PP
       
   246 .nf
       
   247         Beispiel:
       
   248 
       
   249         \fBvmm aliasdomaindelete e.g.example.com\fP
       
   250 .fi
       
   251 .\"
       
   252 .SS KONTO UNTERBEFEHLE
       
   253 .TP
       
   254 \fBuseradd\fP (\fBua\fP) \fIAdresse\fP [ \fIPasswort\fP ]
       
   255 Mit diesem Unterbefehl wird ein neues Konto für die angegebene \fIAdresse\fP
       
   256 angelegt.
       
   257 .br
       
   258 Wurde kein \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktiven
       
   259 Modus erfragen.
       
   260 .PP
       
   261 .nf
       
   262         Beispiele:
       
   263 
       
   264         \fBvmm ua d.user@example.com 'A 5ecR3t P4s5\\/\\/0rd'\fP
       
   265         \fBvmm ua e.user@example.com\fP
       
   266         Neues Passwort eingeben:
       
   267         Neues Passwort wiederholen:
       
   268 .fi
       
   269 .TP
       
   270 \fBuserinfo\fP (\fBui\fP) \fIAdresse\fP [ \fIdetails\fP ]
       
   271 Dieser Unterbefehl zeigt einige Informationen über das Konto mit der angegebenen
       
   272 \fIAdresse\fP an.
       
   273 .br
       
   274 Wurde das optionale Argument \fIdetails\fP angegeben, werden weitere
       
   275 Informationen ausgegeben.
       
   276 .br
       
   277 Mögliche Werte für \fIdetails\fP sind:
       
   278 .RS
   665 .RS
   279 .PD 0
   666 .TP 8
   280 .TP 
       
   281 .B aliases
   667 .B aliases
   282 um alle Alias-Adressen, mit dem Ziel \fIAdresse\fP, aufzulisten
   668 um alle Alias\-Adressen, mit dem Ziel
       
   669 .IR address ,
       
   670 aufzulisten
   283 .TP
   671 .TP
   284 .B du
   672 .B du
   285 um zusätzlich die Festplattenbelegung des Kontos anzuzeigen
   673 um zusätzlich die Festplattenbelegung des Mail\-Verzeichnisses eines Kontos
       
   674 anzuzeigen.
       
   675 Soll die Festplattenbelegung jedes Mal mit der
       
   676 .B userinfo
       
   677 ermittelt werden, ist in der
       
   678 .I vmm.cfg
       
   679 der Wert der Option
       
   680 .I account.disk_usage
       
   681 auf
       
   682 .B true
       
   683 zu setzen.
   286 .TP
   684 .TP
   287 .B full
   685 .B full
   288 um alle oben genannten Informationen anzuzeigen
   686 um alle oben genannten Informationen anzuzeigen
   289 .PD
       
   290 .RE
   687 .RE
   291 .LP
   688 .PP
   292 .TP
   689 Beispiel:
   293 \fBusername\fP (\fBun\fP) \fIAdresse\fP \fI'Bürgerlicher Name'\fP
   690 .PP
   294 Der Bürgerliche Name des Konto-Inhabers mit der angegebenen \fIAdresse\fP kann
   691 .nf
   295 mit diesem Unterbefehl gesetzt/aktualisiert werden.
   692 .B vmm userinfo d.user@example.com
   296 .PP
   693 Konto Informationen
   297 .nf
   694 -------------------
   298         Beispiel:
   695         Address..........: d.user@example.com
   299 
   696         Name.............: None
   300         \fBvmm un d.user@example.com 'John Doe'\fP
   697         UID..............: 79881
   301 .fi
   698         GID..............: 70704
   302 .TP
   699         Home.............: /srv/mail/2/70704/79881
   303 \fBuserpassword\fP (\fBup\fP) \fIAdresse\fP [ \fIPasswort\fP ]
   700         Mail_Location....: mdbox:~/mdbox
   304 Das \fIPasswort\fP eines Kontos kann mit diesem Unterbefehl aktualisiert werden.
   701         Quota Storage....: [  0,00%] 0/500,00 MiB
       
   702         Quota Messages...: [  0,00%] 0/10.000
       
   703         Transport........: lmtp:unix:private/dovecot-lmtp
       
   704         SMTP.............: deaktiviert
       
   705         POP3.............: deaktiviert
       
   706         IMAP.............: aktiviert
       
   707         SIEVE............: aktiviert
       
   708 .fi
       
   709 .\" ------------------------------------
       
   710 .SS username (un)
       
   711 .BI "vmm username" " address"
       
   712 .RI [ name ]
       
   713 .PP
       
   714 Der bürgerliche Name des Kontoinhabers mit der angegebenen Adresse kann mit
       
   715 diesem Unterbefehl gesetzt/aktualisiert werden.
       
   716 .PP
       
   717 Wird kein
       
   718 .I name
       
   719 übergeben, so wird der Wert in den Kontoinformationen gelöscht.
       
   720 .PP
       
   721 Beispiel:
       
   722 .PP
       
   723 .nf
       
   724 .B vmm username d.user@example.com \(dqJohn Doe\(dq
       
   725 .fi
       
   726 .\" ------------------------------------
       
   727 .SS userpassword (up)
       
   728 .BI "vmm userpassword" " address"
       
   729 .RI [ password ]
       
   730 .PP
       
   731 Das Passwort eines Kontos kann mit diesem Unterbefehl aktualisiert werden.
       
   732 .PP
       
   733 Wurde kein Passwort angegeben, wird
       
   734 .B vmm
       
   735 dieses im interaktiven Modus erfragen.
       
   736 .PP
       
   737 Beispiel:
       
   738 .PP
       
   739 .nf
       
   740 .B vmm up d.user@example.com \(dqA |\(rs/|0r3 5ecur3 P4s5\(rs/\(rs/0rd?\(dq
       
   741 .fi
       
   742 .\" ------------------------------------
       
   743 .SS usernote (uo)
       
   744 .BI "vmm usernote" " address"
       
   745 .RI [ note ]
       
   746 .PP
       
   747 Mit diesem Unterbefehl kann ein Konto mit einer Notiz versehen werden. Um die
       
   748 Notiz wieder zu löschen, läßt man sie einfach weg.
       
   749 .PP
       
   750 Beispiel:
       
   751 .PP
       
   752 .nf
       
   753 .B vmm uo d.user@example.com Wird nur bis Ende Mai 2012 gebraucht
       
   754 .fi
       
   755 .\" ------------------------------------
       
   756 .SS userquota (uq)
       
   757 .BI "vmm userquota" " address storage"
       
   758 .RI [ messages ]
       
   759 .PP
       
   760 Um ein neues Quota\-Limit für das Konto mit der angegebenen Adresse
       
   761 festzulegen, wird dieser Unterbefehl verwendet.
       
   762 .PP
       
   763 Wenn der Wert für das Argument
       
   764 .I messages
       
   765 ausgelassen wurde, wird der Vorgabewert
       
   766 .B 0
       
   767 (null) als Anzahl von Nachrichten angewendet werden.
       
   768 .PP
       
   769 Anstelle einer Limite, bewirkt das Wort 'domain', daß die Limite des
       
   770 Kontos gelöscht wird und somit wieder der in der Domain gespeicherte
       
   771 Wert für das Konto gilt.
       
   772 .PP
       
   773 Beispiel:
       
   774 .PP
       
   775 .nf
       
   776 .B vmm userquota d.user@example.com 750m
       
   777 .B vmm userquote d.user@example.com domain
       
   778 .fi
       
   779 .\" ------------------------------------
       
   780 .SS userservices (us)
       
   781 .B vmm userservices
       
   782 .IR address " [" "service ..." ]
       
   783 .PP
       
   784 Verwenden Sie diesen Unterbefehl, um einem Anwender den Zugriff auf die
       
   785 genannten Services zu gestatten.
       
   786 .PP
       
   787 Der Zugriff auf alle nicht genannten Services wird dem Anwender, mit der
       
   788 angegebenen Adresse, verwehrt werden.
       
   789 .PP
       
   790 Anstelle einer Liste, bewirkt das Wort 'domain', daß die benutzerspezifische
       
   791 Liste gelöscht wird und somit wieder die in der Domain gespeicherte
       
   792 Liste für das Konto gilt.
       
   793 .PP
       
   794 Beispiel:
       
   795 .PP
       
   796 .nf
       
   797 .B vmm userservices d.user@example.com SMTP IMAP
       
   798 .B vmm userservices d.user@example.com domain
       
   799 .\" ------------------------------------
       
   800 .SS usertransport (ut)
       
   801 .BI "vmm usertransport" " address transport"
       
   802 .PP
       
   803 Mit diesem Unterbefehl kann ein abweichender
       
   804 .I transport
       
   805 für das Konto mit der angegebenen Adresse bestimmt werden.
       
   806 .PP
       
   807 Wird als
       
   808 .I transport
       
   809 das Wort 'domain' übergeben, so wird der explizite Transport des Kontos
       
   810 wieder gelöscht und der in der Domain gespeicherte Wert benutzt.
       
   811 .PP
       
   812 Beispiel:
   305 .br
   813 .br
   306 Wurde kein \fIPasswort\fP angegeben wird \fBvmm\fP dieses im interaktiven
   814 Angenommen, Sie wollen mit Dovecots
   307 Modus erfragen.
   815 .BR dsync (1)
   308 .PP
   816 die E\-Mails vom Maildir\-Format ins mdbox\-Format konvertieren, dann
   309 .nf
   817 können Sie Postfix, über den Transport, darüber informieren, es später
   310         Beispiel:
   818 nochmals zu versuchen.
   311 
   819 .PP
   312         \fBvmm up d.user@example.com 'A |\\/|0r3 5ecur3 P4s5\\/\\/0rd?'\fP
   820 .nf
   313 .fi
   821 .B vmm ut d.user@example.com \(dqretry:4.0.0 Mailbox being migrated\(dq
   314 .TP
   822 # Konvertieren der Mailbox …
   315 \fBusertransport\fP (\fBut\fP) \fIAdresse\fP \fITransport\fP
   823 # … danach den Transport auf den Domainwert setzen
   316 Mit diesem Unterbefehl kann ein abweichender \fITransport\fP für das Konto mit
   824 .B vmm usertransport d.user@example.com domain
   317 der angegebenen \fIAdresse\fP festgelegt werden.
   825 .fi
   318 .PP
   826 .\" -----------------------------------------------------------------------
   319 .nf
   827 .SH ALIAS UNTERBEFEHLE
   320         Beispiel:
   828 .SS aliasadd (aa)
   321 
   829 .BI "vmm aliasadd" " address destination ..."
   322         \fBvmm ut d.user@example.com smtp:pc105.it.example.com\fP
   830 .PP
   323 .fi
   831 Mit diesem Unterbefehl werden neue Alias\-Adressen, mit einer oder mehren
   324 .TP
   832 .IR destination (en),
   325 \fBuserdisable\fP (\fBu0\fP) \fIAdresse\fP [ \fIService\fP ]
   833 erstellt.
   326 Soll ein Anwender keinen Zugriff auf einen oder alle Service haben, kann der
   834 .PP
   327 Zugriff mit diesem Unterbefehl beschränkt werden.
   835 Innerhalb der Zieladresse werden die Zeichenketten
   328 .br
   836 .IR %n ,
   329 Wurde weder ein \fIService\fP noch das Schlüsselwort '\fIall\fP' angegeben,
   837 .IR %d
   330 werden alle Services (\fIsmtp\fP, \fIpop3\fP, \fIimap\fP, und \fIsieve\fP)
   838 und
   331 für das Konto mit der angegebenen \fIAdresse\fP deaktiviert.
   839 .IR %=
   332 .br
   840 durch den ursprünglichen lokalen Teil, die Domain bzw. die Emailadresse mit
   333 Andernfalls wird nur der Zugriff auf den angegeben \fIService\fP gesperrt.
   841 '=' anstelle von '@' ersetzt. Dies ermöglicht z.B. in Verbindung mit
   334 .PP
   842 Alias\-Domains domain\-spezifische Empfänger.
   335 .nf
   843 .PP
   336         Beispiele:
   844 Beispiele:
   337 
   845 .PP
   338         \fBvmm u0 b.user@example.com imap\fP
   846 .nf
   339         \fBvmm userdisable c.user@example.com\fP
   847 .B vmm aliasadd john.doe@example.com d.user@example.com
   340 .fi
   848 .B vmm aa support@example.com d.user@example.com e.user@example.com
   341 .PP
   849 .B vmm aa postmaster@example.com postmaster+%d@example.org
   342 .TP
   850 .fi
   343 \fBuserenable\fP (\fBu1\fP) \fIAdresse\fP [ \fIService\fP ]
   851 .\" ------------------------------------
   344 Um den Zugriff auf bestimmte oder alle gesperrten Service zu gewähren, wird
   852 .SS aliasdelete (ad)
   345 dieser Unterbefehl verwendet.
   853 .BI "vmm aliasdelete" " address"
   346 .br
   854 .RI [ destination ]
   347 Wurde weder ein \fIService\fP noch das Schlüsselwort '\fIall\fP' angegeben,
   855 .PP
   348 werden alle Services (\fIsmtp\fP, \fIpop3\fP, \fIimap\fP, und \fIsieve\fP)
   856 Verwenden Sie diesen Unterbefehl um den Alias mit der angegebenen Adresse
   349 für das Konto mit der angegebenen  \fIAdresse\fP aktiviert.
       
   350 .br
       
   351 Andernfalls wird nur der Zugriff auf den angegeben \fIService\fP gestattet.
       
   352 .PP
       
   353 .TP
       
   354 \fBuserdelete\fP (\fBud\fP) \fIAdresse\fP [ \fIdelalias\fP ]
       
   355 Verwenden Sie diesen Unterbefehl um, das Konto mit der angegebenen \fIAdresse\fP
       
   356 zu löschen.
   857 zu löschen.
   357 .br
   858 .PP
   358 Sollte es einen oder mehrere Aliase geben, deren Zieladresse mit der des Kontos
   859 Wurde eine optionale
   359 identisch ist, wird \fBvmm\fP die Ausführung des Befehls mit einer
   860 .I destination
   360 entsprechenden Fehlermeldung beenden. Um dieses zu umgehen, kann das optionale
   861 angegeben, so wird nur diese
   361 Schlüsselwort '\fIdelalias\fP' angegebenen werden.
   862 .I destination
   362 .\"
   863 vom angegebenen Alias entfernt.
   363 .SS ALIAS UNTERBEFEHLE
   864 .PP
   364 .TP
   865 Beispiel:
   365 \fBaliasadd\fP (\fBaa\fP) \fIAlias\fP \fIZiel\fP
   866 .PP
   366 Mit diesem Unterbefehl werden neue Aliase erstellt.
   867 .nf
   367 .PP
   868 .B vmm aliasdelete support@example.com d.user@example.com
   368 .nf
   869 .fi
   369         Beispiele:
   870 .\" ------------------------------------
   370 
   871 .SS aliasinfo (ai)
   371         \fBvmm aliasadd john.doe@example.com d.user@example.com\fP
   872 .BI "vmm aliasinfo" " address"
   372         \fBvmm aa support@example.com d.user@example.com\fP
   873 .PP
   373         \fBvmm aa support@example.com e.user@example.com\fP
   874 Informationen zum Alias mit der angegebenen Adresse können mit diesem
   374 .fi
   875 Unterbefehl ausgegeben werden.
   375 .TP
   876 .PP
   376 \fBaliasinfo\fP (\fBai\fP) \fIAlias\fP
   877 Beispiel:
   377 Informationen zu einem Alias können mit diesem Unterbefehl ausgegeben werden.
   878 .PP
   378 .PP
   879 .nf
   379 .nf
   880 .B vmm aliasinfo support@example.com
   380         Beispiel:
   881 Alias Informationen
   381 
   882 -------------------
   382         \fBvmm aliasinfo support@example.com\fP
   883         E\-Mails für support@example.com werden weitergeleitet an:
   383         Alias Informationen
   884              * e.user@example.com
   384         -------------------
   885 .fi
   385                 E-Mails für support@example.com werden weitergeleitet an:
   886 .\" -----------------------------------------------------------------------
   386                      * d.user@example.com
   887 .SH RELOCATED UNTERBEFEHLE
   387                      * e.user@example.com
   888 .SS relocatedadd (ra)
   388 .fi
   889 .BI "vmm relocatedadd" " address newaddress"
   389 .TP
   890 .PP
   390 \fBaliasdelete\fP (\fBad\fP) \fIAlias\fP [ \fIZiel\fP ]
   891 Um einen neuen Relocated User anzulegen kann dieser Unterbefehl verwendet
   391 Verwenden Sie diesen Unterbefehl um den angegebenen \fIAlias\fP zu löschen.
       
   392 .br
       
   393 Wurde die optionale Zieladresse \fIZiel\fP angegeben, so wird nur diese
       
   394 Zieladresse vom angegebenen \fIAlias\fP entfernt.
       
   395 .PP
       
   396 .nf
       
   397         Beispiel:
       
   398         \fBvmm ad support@example.com d.user@example.com\fP
       
   399 .fi
       
   400 .\"
       
   401 .SS RELOCATED UNTERBEFEHLE
       
   402 .TP
       
   403 \fBrelocatedadd\fP (\fBra\fP) \fIalte_adresse\fP \fIneue_adresse\fP
       
   404 Um einen neuen relocated User anzulegen kann dieser Unterbefehl verwendet
       
   405 werden.
   892 werden.
   406 .br
   893 .PP
   407 Dabei ist \fIalte_adresse\fP die ehemalige Adresse des Benutzers, z. B.
   894 Dabei ist
   408 b.user@example.com, und \fIneue_adresse\fP die neue Adresse, unter der Benutzer
   895 .I address
   409 erreichbar ist.
   896 die ehemalige Adresse des Benutzers, zum Beispiel b.nutzer@example.com, und
   410 .PP
   897 .I newaddress
   411 .nf
   898 die neue Adresse, unter der die/der Benutzer/in erreichbar ist.
   412         Beispiel:
   899 .PP
   413 
   900 Beispiel:
   414         \fBvmm relocatedadd b.user@example.com b-user@company.tld\fP
   901 .PP
   415 .fi
   902 .nf
   416 .TP
   903 .B vmm relocatedadd b.nutzer@example.com b\-nutzer@firma.tld
   417 \fBrelocatedinfo\fP (\fBri\fP) \fIalte_adresse\fP
   904 .fi
   418 Dieser Unterbefehl zeigt die neue Adresse des relocated Users mit
   905 .\" ------------------------------------
   419 \fIalte_adresse\fP.
   906 .SS relocatedinfo (ri)
   420 .PP
   907 .BI "vmm relocatedinfo " address
   421 .nf
   908 .PP
   422         Beispiel:
   909 Dieser Unterbefehl zeigt die neue Adresse des Relocated Users mit mit der
   423 
   910 angegebenen Adresse.
   424         \fBvmm relocatedinfo b.user@example.com\fP
   911 .PP
   425         Relocated Informationen
   912 Beispiel:
   426         -----------------------
   913 .PP
   427         Der Benutzer „b.user@example.com“ ist erreichbar unter „b-user@company.tld“
   914 .nf
   428 .fi
   915 .B vmm relocatedinfo b.nutzer@example.com
   429 .TP
   916 Verschiebe\-Informationen
   430 \fBrelocateddelete\fP (\fBrd\fP) \fIalte_adresse\fP
   917 ------------------------
   431 Mit diesem Unterbefehl kann der relocated User mit \fIalte_adresse\fP gelöscht
   918         Der Benutzer »b.nutzer@example.com« wurde nach »b\-nutzer@firma.tld« verschoben
   432 werden.
   919 .fi
   433 .PP
   920 .\" ------------------------------------
   434 .nf
   921 .SS relocateddelete (rd)
   435         Beispiel:
   922 .BI "vmm relocateddelete " address
   436 
   923 .PP
   437         \fBvmm relocateddelete b.user@example.com\fP
   924 Mit diesem Unterbefehl kann der Relocated User mit der angegebenen Adresse
   438 .fi
   925 gelöscht werden.
   439 .\"
   926 .PP
       
   927 Beispiel:
       
   928 .PP
       
   929 .nf
       
   930 .B vmm relocateddelete b.nutzer@example.com
       
   931 .fi
       
   932 .\" -----------------------------------------------------------------------
       
   933 .SH CATCH\-ALL UNTERBEFEHLE
       
   934 .SS catchalladd (caa)
       
   935 .BI "vmm catchalladd" " fqdn destination ..."
       
   936 .PP
       
   937 Mit diesem Unterbefehl können für eine Domain Adressen definiert werden, an
       
   938 die E\-Mails geleitet werden, die an nicht\-existente Adressen innerhalb
       
   939 dieser Domains adressiert sind.
       
   940 Diese Adressen \(dqfangen alle\(dq diese E\-Mails auf, es sei denn es
       
   941 bestehen spezifischere Aliase, Mailboxen oder Relocated\-Einträge.
       
   942 .PP
       
   943 WARNUNG: Catch\-all Adressen können dazu führen, daß ein Mailserver von Spam
       
   944 überflutet wird, da Spammer zuweilen gerne alle möglichen Emailadressen
       
   945 ausprobieren und man auf einmal zig tausend Nachrichten gerichtet an
       
   946 Adressen von abba@example.org bis zztop@example.org weitergeleitet bekommt.
       
   947 .PP
       
   948 Beispiel:
       
   949 .PP
       
   950 .nf
       
   951 .B vmm catchalladd example.com b.nutzer@example.org
       
   952 .fi
       
   953 .\" ------------------------------------
       
   954 .SS catchallinfo (cai)
       
   955 .BI "vmm catchallinfo " fqdn
       
   956 .PP
       
   957 Dieser Unterbefehl zeigt die für eine Domain definierten Catch\-all Aliase
       
   958 an.
       
   959 .PP
       
   960 Beispiel:
       
   961 .PP
       
   962 .nf
       
   963 .B vmm catchallinfo example.com
       
   964 Catch-all Informationen
       
   965 -----------------------
       
   966   Nachrichten an unbekannte Adressen innerhalb der example.com Domäne werden
       
   967   weitergeleitet an:
       
   968          * b.nutzer@example.org
       
   969 .fi
       
   970 .\" ------------------------------------
       
   971 .SS catchalldelete (cad)
       
   972 .BI "vmm catchalldelete " fqdn
       
   973 .RI [ destination ]
       
   974 .PP
       
   975 Mit diesem Unterbefehl werden Catch\-all Aliase einer Domain wieder
       
   976 gelöscht, entweder nur das angegebene Alias, oder alle, wenn keines
       
   977 angegeben wurde.
       
   978 .PP
       
   979 Beispiel:
       
   980 .PP
       
   981 .nf
       
   982 .B vmm catchalldelete example.com b.nutzer@example.org
       
   983 .fi
       
   984 .\" -----------------------------------------------------------------------
   440 .SH DATEIEN
   985 .SH DATEIEN
   441 /usr/local/etc/vmm.cfg
   986 .TP
       
   987 .I /root/vmm.cfg
       
   988 Wird verwendet, falls vorhanden.
       
   989 .TP
       
   990 .I /usr/local/etc/vmm.cfg
       
   991 Wird verwendet, sollte obige Datei nicht gefunden werden.
       
   992 .TP
       
   993 .I /etc/vmm.cfg
       
   994 Wird verwendet, falls die oben genannten Dateien nicht existieren.
       
   995 .\" -----------------------------------------------------------------------
   442 .SH SIEHE AUCH
   996 .SH SIEHE AUCH
   443 vmm.cfg(5), Konfigurationsdatei für vmm
   997 .BR dsync (1),
   444 .SH AUTOR
   998 .BR transport (5),
   445 \fBvmm\fP und die dazugehörigen Manualseiten wurden von Pascal Volk
   999 .BR vmm.cfg (5)
   446 <\fIneverseen@users.sourceforge.net\fP> geschrieben und sind unter den
  1000 .\" -----------------------------------------------------------------------
   447 Bedingungen der BSD Lizenz lizenziert.
  1001 .SH INTERNET RESSOURCEN
       
  1002 .TP
       
  1003 Wiki
       
  1004 http://de.vmm.localdomain.org/
       
  1005 .TP
       
  1006 Projekt\-Seite
       
  1007 http://sf.net/projects/vmm/
       
  1008 .TP
       
  1009 Bugtracker
       
  1010 https://bitbucket.org/pvo/vmm/issues
       
  1011 .\" -----------------------------------------------------------------------
       
  1012 .SH COPYING
       
  1013 vmm und die dazugehörigen Manualseiten wurden von Pascal Volk <user+vmm AT
       
  1014 localhost.localdomain.org> geschrieben und sind unter den Bedingungen der
       
  1015 BSD Lizenz lizenziert.