man/de/man1/vmm.1
branchv0.7.x
changeset 678 5dba8063b708
parent 677 6287cf6c6447
child 679 b6ef80a8daa2
equal deleted inserted replaced
677:6287cf6c6447 678:5dba8063b708
     1 .TH "VMM" "1" "2012-09-27" "vmm 0.6" "vmm"
       
     2 .SH NAME
       
     3 vmm \- Kommandozeilenprogramm zur Verwaltung von E\-Mail\-Domains/\-Konten
       
     4 und \-Aliase.
       
     5 .\" -----------------------------------------------------------------------
       
     6 .SH ÜBERSICHT
       
     7 .B vmm
       
     8 .IR Unterbefehl " [" "Argument ..." ]
       
     9 .\" -----------------------------------------------------------------------
       
    10 .SH BESCHREIBUNG
       
    11 .B vmm
       
    12 (a virtual mail manager) ist das einfach zu bedienende
       
    13 Kommandozeilenprogramm für Administratoren und Postmaster, zur Verwaltung
       
    14 von (Alias\-) Domains, Konten, Alias\-Adressen und sogenannten Relocated
       
    15 Users.
       
    16 Es ermöglicht die schnelle und einfache Verwaltung des Mailservers.
       
    17 .br
       
    18 Es wurde für Dovecot und Postfix mit einem PostgreSQL\-Backend entwickelt.
       
    19 .PP
       
    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:
       
   164 .RS
       
   165 .TP 10
       
   166 .B account
       
   167 Konto Einstellungen
       
   168 .TP
       
   169 .B bin
       
   170 Pfade zu externen Binär\-Dateien
       
   171 .TP
       
   172 .B database
       
   173 Datenbank Einstellungen
       
   174 .TP
       
   175 .B domain
       
   176 Domain Einstellungen
       
   177 .TP
       
   178 .B mailbox
       
   179 Mailbox Einstellungen
       
   180 .TP
       
   181 .B misc
       
   182 Verschiedene Einstellungen
       
   183 .RE
       
   184 .PP
       
   185 Die Konfigurationsoptionen werden in
       
   186 .BR vmm.cfg (5)
       
   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
       
   201 
       
   202 * Konfigurationsabschnitt: »mailbox«
       
   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 listaddresses (ll)
       
   271 .B vmm listaddresses
       
   272 .RI [ pattern ]
       
   273 .PP
       
   274 Verwenden Sie diesen Unterbefehl, um alle Adressen anzuzeigen.
       
   275 Einträge regulärer Domains werden mit einem '+' gekennzeichnet, Einträge
       
   276 von Alias-Domains mit einem '-'. Zudem wird jedem Eintrag ein 'u', 'a',
       
   277 oder 'r' vorangestellt, welche den Eintrag als Benutzerkonto, Alias oder
       
   278 Relocated User identifizieren.
       
   279 .PP
       
   280 Mit dem optionalen Muster können Sie die Ausgabe einschränken. Akzeptiert
       
   281 wird entweder eine Domain oder ein SQL-Muster (% als Wildcard).
       
   282 .PP
       
   283 Beispiel:
       
   284 .PP
       
   285 .nf
       
   286 .B vmm listaddresses example.com
       
   287 .B vmm listaddresses %master@%
       
   288 .\" ------------------------------------
       
   289 .SS listaliases (la)
       
   290 .B vmm listaliases
       
   291 .RI [ pattern ]
       
   292 .PP
       
   293 Verwenden Sie diesen Unterbefehl, um alle Aliase anzuzeigen. Reguläre
       
   294 Aliase werden mit einem '+' gekennzeichnet, Aliase in Alias-Domains mit
       
   295 einem '-'.
       
   296 .PP
       
   297 Mit dem optionalen Muster können Sie die Ausgabe einschränken. Akzeptiert
       
   298 wird entweder eine Domain oder ein SQL-Muster (% als Wildcard).
       
   299 .PP
       
   300 Beispiel:
       
   301 .PP
       
   302 .nf
       
   303 .B vmm listaliases example.com
       
   304 .B vmm listaliases %master@%
       
   305 .\" ------------------------------------
       
   306 .SS listrelocated (lr)
       
   307 .B vmm listrelocated
       
   308 .RI [ pattern ]
       
   309 .PP
       
   310 Verwenden Sie diesen Unterbefehl, um alle Relocated Users anzuzeigen.
       
   311 Einträge regulärer Domains werden mit einem '+' gekennzeichnet, Einträge
       
   312 von Alias-Domains mit einem '-'.
       
   313 .PP
       
   314 Mit dem optionalen Muster können Sie die Ausgabe einschränken. Akzeptiert
       
   315 wird entweder eine Domain oder ein SQL-Muster (% als Wildcard).
       
   316 .PP
       
   317 Beispiel:
       
   318 .PP
       
   319 .nf
       
   320 .B vmm listrelocated example.com
       
   321 .B vmm listrelocated %master@%
       
   322 .\" ------------------------------------
       
   323 .SS listusers (lu)
       
   324 .B vmm listusers
       
   325 .RI [ pattern ]
       
   326 .PP
       
   327 Verwenden Sie diesen Unterbefehl, um alle Benutzerkonten anzuzeigen.
       
   328 Reguläre Benutzerkonten werden mit einem '+' gekennzeichnet, Benutzerkonten
       
   329 in Alias-Domains mit einem '-'.
       
   330 .PP
       
   331 Mit dem optionalen Muster können Sie die Ausgabe einschränken. Akzeptiert
       
   332 wird entweder eine Domain oder ein SQL-Muster (% als Wildcard).
       
   333 .PP
       
   334 Beispiel:
       
   335 .PP
       
   336 .nf
       
   337 .B vmm listusers example.com
       
   338 .B vmm listusers %master@%
       
   339 .\" ------------------------------------
       
   340 .SS listpwschemes (lp)
       
   341 .B vmm listpwschemes
       
   342 .PP
       
   343 Dieser Unterbefehl listet alle unterstützte Passwort\-Schemen, die als Wert
       
   344 für
       
   345 .I misc.password_scheme
       
   346 in der
       
   347 .I vmm.cfg
       
   348 verwendet werden können.
       
   349 Die Ausgabe variiert, je nach eingesetzter Dovecot Version und der libc des
       
   350 Systems.
       
   351 .br
       
   352 Sollte Ihre Dovecot\-Installation nicht zu alt sein, werden zusätzlich
       
   353 die verwendbaren Encoding\-Suffixe ausgegeben.
       
   354 Eines dieser Suffixe kann an das Passwort\-Schema angefügt werden.
       
   355 .PP
       
   356 Beispiel:
       
   357 .PP
       
   358 .nf
       
   359 .B vmm listpwschemes
       
   360 Verfügbare Passwort-Schemata
       
   361 ----------------------------
       
   362         CRYPT SHA512-CRYPT LDAP-MD5 DIGEST-MD5 SHA256 SHA512 SSHA512
       
   363         SKEY SSHA NTLM RPA MD5-CRYPT HMAC-MD5 SHA1 PLAIN SHA CRAM-MD5
       
   364         SSHA256 MD5 LANMAN CLEARTEXT PLAIN-MD5 PLAIN-MD4 OTP SMD5
       
   365         SHA256-CRYPT
       
   366 
       
   367 Verwendbare Encoding-Suffixe
       
   368 ----------------------------
       
   369         .B64 .BASE64 .HEX
       
   370 .fi
       
   371 .\" ------------------------------------
       
   372 .SS version (v)
       
   373 .B vmm version
       
   374 .PP
       
   375 Gibt Versions\- und Copyright\-Informationen zu
       
   376 .B vmm
       
   377 aus.
       
   378 Danach wird
       
   379 .B vmm
       
   380 beendet.
       
   381 .\" -----------------------------------------------------------------------
       
   382 .SH DOMAIN UNTERBEFEHLE
       
   383 .SS domainadd (da)
       
   384 .B vmm domainadd
       
   385 .IR fqdn " [" transport ]
       
   386 .PP
       
   387 Fügt eine neue Domain in die Datenbank ein und erstellt das
       
   388 Domain\-Verzeichnis.
       
   389 .PP
       
   390 Wurde das optional Argument
       
   391 .I transport
       
   392 angegeben, ersetzt der angegebene Transport den konfigurierten Transport
       
   393 .RI ( misc.transport ") aus " vmm.cfg .
       
   394 Der angegebene
       
   395 .I transport
       
   396 ist der Vorgabe\-Transport für alle Konten, die dieser Domain zugeordnet
       
   397 werden.
       
   398 .PP
       
   399 Konfigurationsbezogenes Verhalten:
       
   400 .RS
       
   401 .TP
       
   402 .I domain.auto_postmaster
       
   403 Wenn diese Option den Wert
       
   404 .B true
       
   405 (Vorgabe) hat, wird
       
   406 .B vmm
       
   407 nach erfolgreichem Anlegen der Domain auch das Konto für
       
   408 .BI postmaster@ fqdn
       
   409 erstellen.
       
   410 .TP
       
   411 .I account.random_password
       
   412 Sollte dieser Option ebenfalls der Wert
       
   413 .B true
       
   414 zugewiesen sein, wird ein zufällig generiertes Passwort für den
       
   415 Postmaster\-Account gesetzt und auf stdout ausgegeben.
       
   416 .RE
       
   417 .PP
       
   418 Beispiele:
       
   419 .PP
       
   420 .nf
       
   421 .B vmm domainadd support.example.com smtp:[mx1.example.com]:2025
       
   422 Konto für postmaster@support.example.com wird angelegt
       
   423 Neues Passwort eingeben:
       
   424 Neues Passwort wiederholen:
       
   425 .B vmm cs account.random_password true
       
   426 .B vmm domainadd vertrieb.example.com
       
   427 Konto für postmaster@vertrieb.example.com wird angelegt
       
   428 Erzeugtes Passwort: YoG3Uw*5aH
       
   429 .fi
       
   430 .\" ------------------------------------
       
   431 .SS domaindelete (dd)
       
   432 .BI "vmm domaindelete " fqdn
       
   433 .RB [ force ]
       
   434 .PP
       
   435 Dieser Unterbefehl löscht die Domain mit dem angegebenen
       
   436 .IR fqdn .
       
   437 .PP
       
   438 Sollten der zu löschenden Domain Konten, Aliase und/oder Relocated User
       
   439 zugeordnet sein, wird
       
   440 .B vmm
       
   441 die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden.
       
   442 Sollten Sie sich Ihres Vorhabens sicher sein, so kann optional das
       
   443 Schlüsselwort
       
   444 .B force
       
   445 angegeben werden.
       
   446 .PP
       
   447 Sollten Sie wirklich immer wissen was Sie tun, so editieren Sie Ihre
       
   448 .I vmm.cfg
       
   449 und setzen den Wert der Option
       
   450 .I domain.force_deletion
       
   451 auf
       
   452 .BR true .
       
   453 Dann werden Sie zukünftig beim Löschen von Domains nicht mehr wegen
       
   454 vorhanden Konten, Aliase und/oder Relocated User gewarnt.
       
   455 .\" ------------------------------------
       
   456 .SS domaininfo (di)
       
   457 .B vmm domaininfo
       
   458 .IR fqdn \ [ details ]
       
   459 .PP
       
   460 Dieser Unterbefehl zeigt Informationen zur Domain mit dem angegebenen
       
   461 .I fqdn
       
   462 an.
       
   463 .PP
       
   464 Um detaillierte Informationen über die Domain zu erhalten, kann das
       
   465 optionale Argument
       
   466 .I details
       
   467 angegeben werden.
       
   468 Ein möglicher Wert für
       
   469 .I details
       
   470 kann eines der folgenden sechs Schlüsselwörter sein:
       
   471 .RS
       
   472 .TP 13
       
   473 .B accounts
       
   474 um alle eingerichteten Konten aufzulisten
       
   475 .TP
       
   476 .B aliasdomains
       
   477 um alle zugeordneten Alias\-Domains aufzulisten
       
   478 .TP
       
   479 .B aliases
       
   480 um alle vorhandenen Alias\-Adressen aufzulisten
       
   481 .TP
       
   482 .B catchall
       
   483 um alle Catch\-all\-Ziele aufzulisten
       
   484 .TP
       
   485 .B relocated
       
   486 um alle Adressen der Relocated Users aufzulisten
       
   487 .TP
       
   488 .B full
       
   489 um alle oben genannten Informationen aufzulisten
       
   490 .RE
       
   491 .PP
       
   492 Beispiel:
       
   493 .PP
       
   494 .nf
       
   495 .B vmm domaininfo sales.example.com
       
   496 Domain Informationen
       
   497 --------------------
       
   498         Domain Name......: sales.example.com
       
   499         GID..............: 70708
       
   500         Domain Directory.: /srv/mail/c/70708
       
   501         Quota Limit/User.: Storage: 500,00 MiB; Messages: 10.000
       
   502         Active Services..: IMAP SIEVE
       
   503         Transport........: lmtp:unix:private/dovecot-lmtp
       
   504         Alias Domains....: 0
       
   505         Accounts.........: 1
       
   506         Aliases..........: 0
       
   507         Relocated........: 0
       
   508         Catch-All Dests..: 1
       
   509 .fi
       
   510 .\" ------------------------------------
       
   511 .SS domainquota (dq)
       
   512 .B vmm domainquota
       
   513 .IR "fqdn storage" " [" messages ]
       
   514 .RB [ force ]
       
   515 .PP
       
   516 Dieser Unterbefehl wird verwendet, um für die Konten der Domain ein neues
       
   517 Quota\-Limit festzulegen.
       
   518 .PP
       
   519 Standardmäßig gilt für Konten das Quota\-Limit der
       
   520 .IR vmm.cfg " (" domain.quota_bytes " und " domain.quota_messages ).
       
   521 Das neue Quota\-Limit gilt für für alle bestehenden Konten, die nicht selbst
       
   522 ein Quota\-Limit definieren. Soll das neue Quota\-Limit auch für Konten mit
       
   523 eigenen Limiten angewendet werden, so ist das optionale Schlüsselwort
       
   524 .B force
       
   525 anzugeben.
       
   526 .br
       
   527 Wenn der Wert für das Argument
       
   528 .I messages
       
   529 ausgelassen wurde, wird der Vorgabewert
       
   530 .B 0
       
   531 (null) als Anzahl von Nachrichten angewendet werden.
       
   532 .PP
       
   533 Beispiel:
       
   534 .PP
       
   535 .nf
       
   536 .B vmm domainquota example.com 1g force
       
   537 .fi
       
   538 .\" ------------------------------------
       
   539 .SS domainservices (ds)
       
   540 .B vmm domainservices
       
   541 .IR fqdn " [" "service ..." ]
       
   542 .RB [ force ]
       
   543 .PP
       
   544 Um festzulegen, welche Services für die Anwender der Domain \(em mit dem
       
   545 angegebenen
       
   546 .I fqdn
       
   547 \(em nutzbar sein sollen, wird dieser Unterbefehl verwendet.
       
   548 .PP
       
   549 Der Zugriff auf alle genannten Services wird den Anwender gestattet.
       
   550 Der Zugriff auf nicht genannte Services wird verweigert werden.
       
   551 Verwendbare
       
   552 .IR service \-Namen
       
   553 sind:
       
   554 .BR  imap ", " pop3 ", " sieve " und " smtp .
       
   555 .br
       
   556 Wird das Schlüsselwort
       
   557 .B force
       
   558 angegeben, so werden alle kontospezifischen Einstellungen gelöscht und es
       
   559 gelten fortan die Service\-Einstellungen der Domain für alle Konten. Ohne
       
   560 dieses Schlüsselwort gelten die neuen Einstellungen nur für Konten, bei denen
       
   561 die Service\-Einstellungen nicht individuell geändert wurden.
       
   562 .\" ------------------------------------
       
   563 .SS domaintransport (dt)
       
   564 .BI "vmm domaintransport" " fqdn transport"
       
   565 .RB [ force ]
       
   566 .PP
       
   567 Ein neuer
       
   568 .I transport
       
   569 für die Domain mit dem angegebenen
       
   570 .I fqdn
       
   571 kann mit diesem Unterbefehl festgelegt werden.
       
   572 .PP
       
   573 Wird das Schlüsselwort
       
   574 .B force
       
   575 angegeben, so werden alle kontospezifischen Einstellungen gelöscht und es
       
   576 gelten fortan die Transport\-Einstellungen der Domain für alle Konten. Ohne
       
   577 dieses Schlüsselwort gelten die neuen Einstellungen nur für Konten, bei denen
       
   578 die Transport\-Einstellungen nicht individuell geändert wurden.
       
   579 .PP
       
   580 Beispiel:
       
   581 .PP
       
   582 .nf
       
   583 .B vmm domaintransport support.example.com dovecot:
       
   584 .fi
       
   585 .\" ------------------------------------
       
   586 .SS domainnote (do)
       
   587 .BI "vmm domainnote" " fqdn"
       
   588 .RI [ note ]
       
   589 .PP
       
   590 Mit diesem Unterbefehl kann eine Domain mit einer Notiz versehen werden. Um
       
   591 die Notiz wieder zu löschen, läßt man sie einfach weg.
       
   592 .PP
       
   593 Beispiel:
       
   594 .PP
       
   595 .nf
       
   596 .B vmm do example.com Gehört Robert
       
   597 .fi
       
   598 .\" -----------------------------------------------------------------------
       
   599 .SH ALIAS\-DOMAIN UNTERBEFEHLE
       
   600 Eine Alias\-Domain ist ein Alias für eine Domain, die zuvor mit dem
       
   601 Unterbefehl
       
   602 .B domainadd
       
   603 erstellt wurde.
       
   604 Alle Konten, Aliase und Relocated Users der Domain sind ebenfalls unter der
       
   605 Alias\-Domain verfügbar.
       
   606 .br
       
   607 Im Folgenden wird angenommen, example.net sei ein Alias für example.com.
       
   608 .PP
       
   609 Postfix wird nicht erst fälschlicherweise E\-Mails für
       
   610 unbekannten.user@example.net annehmen und später an den \(em oftmals
       
   611 gefälschten \(em Absender bouncen.
       
   612 Postfix wird E\-Mails an unbekannte Empfänger sofort ablehnen.
       
   613 .br
       
   614 Dieses Verhalten ist sichergestellt, solange die empfohlenen
       
   615 Datenbankabfragen in
       
   616 .I $config_directory/pgsql\-*.cf
       
   617 konfiguriert sind.
       
   618 .\" ------------------------------------
       
   619 .SS aliasdomainadd (ada)
       
   620 .BI "vmm aliasdomainadd" " fqdn destination"
       
   621 .PP
       
   622 Dieser Unterbefehl legt die Alias\-Domain
       
   623 .RI ( fqdn )
       
   624 als Alias für eine bestehende Domain
       
   625 .RI ( destination ") an."
       
   626 .PP
       
   627 Beispiel:
       
   628 .PP
       
   629 .nf
       
   630 .B vmm aliasdomainadd example.net example.com
       
   631 .fi
       
   632 .\" ------------------------------------
       
   633 .SS aliasdomaindelete (add)
       
   634 .BI "vmm aliasdomaindelete" " fqdn"
       
   635 .PP
       
   636 Verwenden Sie diesen Unterbefehl, um die Alias\-Domain
       
   637 .I fqdn
       
   638 zu löschen.
       
   639 .PP
       
   640 Beispiel:
       
   641 .PP
       
   642 .nf
       
   643 .B vmm aliasdomaindelete e.g.example.com
       
   644 .fi
       
   645 .\" ------------------------------------
       
   646 .SS aliasdomaininfo (adi)
       
   647 .BI "vmm aliasdomaininfo" " fqdn"
       
   648 .PP
       
   649 Dieser Unterbefehl gibt Informationen darüber aus, welcher Domain die
       
   650 Alias\-Domain
       
   651 .I fqdn
       
   652 aktuell zugeordnet ist.
       
   653 .PP
       
   654 Beispiel:
       
   655 .PP
       
   656 .nf
       
   657 .B vmm adi example.net
       
   658 Alias\-Domain Informationen
       
   659 --------------------------
       
   660         Die Alias\-Domain example.net gehört zu:
       
   661             * example.com
       
   662 .fi
       
   663 .\" ------------------------------------
       
   664 .SS aliasdomainswitch (ads)
       
   665 .BI "vmm aliasdomainswitch" " fqdn destination"
       
   666 .PP
       
   667 Wenn Sie die bereits vorhandene Alias\-Domain
       
   668 .I fqdn
       
   669 einer anderen Ziel\-Domain zuordnen wollen, verwenden Sie diesen
       
   670 Unterbefehl.
       
   671 .PP
       
   672 Beispiel:
       
   673 .PP
       
   674 .nf
       
   675 .B vmm aliasdomainswitch example.net example.org
       
   676 .fi
       
   677 .\" -----------------------------------------------------------------------
       
   678 .SH KONTO UNTERBEFEHLE
       
   679 .SS useradd (ua)
       
   680 .B vmm useradd
       
   681 .IR address " [" password ]
       
   682 .PP
       
   683 Mit diesem Unterbefehl wird ein neues Konto für die angegebene Adresse
       
   684 angelegt.
       
   685 .PP
       
   686 Wurde kein Passwort angegeben wird
       
   687 .B vmm
       
   688 dieses im interaktiven Modus erfragen.
       
   689 Falls kein Passwort angegeben wurde und
       
   690 .I account.random_password
       
   691 den Wert
       
   692 .B true
       
   693 hat, wird
       
   694 .B vmm
       
   695 ein zufälliges Passwort generieren und auf stdout ausgeben, nachdem das
       
   696 Konto angelegt wurde.
       
   697 .PP
       
   698 Beispiele:
       
   699 .PP
       
   700 .nf
       
   701 .B vmm ua d.user@example.com \(dqA 5ecR3t P4s5\(rs/\(rs/0rd\(dq
       
   702 .B vmm useradd e.user@example.com
       
   703 Neues Passwort eingeben:
       
   704 Neues Passwort wiederholen:
       
   705 .fi
       
   706 .\" ------------------------------------
       
   707 .SS userdelete (ud)
       
   708 .BI "vmm userdelete" " address"
       
   709 .RB [ force ]
       
   710 .PP
       
   711 Verwenden Sie diesen Unterbefehl, um das Konto mit der angegebenen Adresse
       
   712 zu löschen.
       
   713 .PP
       
   714 Sollte es einen oder mehrere Aliase geben, deren Ziel\-Adresse mit der
       
   715 Adresse des zu löschenden Kontos identisch ist, wird
       
   716 .B vmm
       
   717 die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden.
       
   718 Um dieses zu umgehen, kann das optionale Schlüsselwort
       
   719 .B force
       
   720 angegebenen werden.
       
   721 .\" ------------------------------------
       
   722 .SS userinfo (ui)
       
   723 .B "vmm userinfo"
       
   724 .IR address " [" details ]
       
   725 .PP
       
   726 Dieser Unterbefehl zeigt einige Informationen über das Konto mit der
       
   727 angegebenen Adresse an.
       
   728 .PP
       
   729 Wurde das optionale Argument
       
   730 .I details
       
   731 angegeben, werden weitere Informationen ausgegeben.
       
   732 Mögliche Werte für
       
   733 .I details
       
   734 sind:
       
   735 .RS
       
   736 .TP 8
       
   737 .B aliases
       
   738 um alle Alias\-Adressen, mit dem Ziel
       
   739 .IR address ,
       
   740 aufzulisten
       
   741 .TP
       
   742 .B du
       
   743 um zusätzlich die Festplattenbelegung des Mail\-Verzeichnisses eines Kontos
       
   744 anzuzeigen.
       
   745 Soll die Festplattenbelegung jedes Mal mit der
       
   746 .B userinfo
       
   747 ermittelt werden, ist in der
       
   748 .I vmm.cfg
       
   749 der Wert der Option
       
   750 .I account.disk_usage
       
   751 auf
       
   752 .B true
       
   753 zu setzen.
       
   754 .TP
       
   755 .B full
       
   756 um alle oben genannten Informationen anzuzeigen
       
   757 .RE
       
   758 .PP
       
   759 Beispiel:
       
   760 .PP
       
   761 .nf
       
   762 .B vmm userinfo d.user@example.com
       
   763 Konto Informationen
       
   764 -------------------
       
   765         Address..........: d.user@example.com
       
   766         Name.............: None
       
   767         UID..............: 79881
       
   768         GID..............: 70704
       
   769         Home.............: /srv/mail/2/70704/79881
       
   770         Mail_Location....: mdbox:~/mdbox
       
   771         Quota Storage....: [  0,00%] 0/500,00 MiB
       
   772         Quota Messages...: [  0,00%] 0/10.000
       
   773         Transport........: lmtp:unix:private/dovecot-lmtp
       
   774         SMTP.............: deaktiviert
       
   775         POP3.............: deaktiviert
       
   776         IMAP.............: aktiviert
       
   777         SIEVE............: aktiviert
       
   778 .fi
       
   779 .\" ------------------------------------
       
   780 .SS username (un)
       
   781 .BI "vmm username" " address"
       
   782 .RI [ name ]
       
   783 .PP
       
   784 Der bürgerliche Name des Kontoinhabers mit der angegebenen Adresse kann mit
       
   785 diesem Unterbefehl gesetzt/aktualisiert werden.
       
   786 .PP
       
   787 Wird kein
       
   788 .I name
       
   789 übergeben, so wird der Wert in den Kontoinformationen gelöscht.
       
   790 .PP
       
   791 Beispiel:
       
   792 .PP
       
   793 .nf
       
   794 .B vmm username d.user@example.com \(dqJohn Doe\(dq
       
   795 .fi
       
   796 .\" ------------------------------------
       
   797 .SS userpassword (up)
       
   798 .BI "vmm userpassword" " address"
       
   799 .RI [ password ]
       
   800 .PP
       
   801 Das Passwort eines Kontos kann mit diesem Unterbefehl aktualisiert werden.
       
   802 .PP
       
   803 Wurde kein Passwort angegeben, wird
       
   804 .B vmm
       
   805 dieses im interaktiven Modus erfragen.
       
   806 .PP
       
   807 Beispiel:
       
   808 .PP
       
   809 .nf
       
   810 .B vmm up d.user@example.com \(dqA |\(rs/|0r3 5ecur3 P4s5\(rs/\(rs/0rd?\(dq
       
   811 .fi
       
   812 .\" ------------------------------------
       
   813 .SS usernote (uo)
       
   814 .BI "vmm usernote" " address"
       
   815 .RI [ note ]
       
   816 .PP
       
   817 Mit diesem Unterbefehl kann ein Konto mit einer Notiz versehen werden. Um die
       
   818 Notiz wieder zu löschen, läßt man sie einfach weg.
       
   819 .PP
       
   820 Beispiel:
       
   821 .PP
       
   822 .nf
       
   823 .B vmm uo d.user@example.com Wird nur bis Ende Mai 2012 gebraucht
       
   824 .fi
       
   825 .\" ------------------------------------
       
   826 .SS userquota (uq)
       
   827 .BI "vmm userquota" " address storage"
       
   828 .RI [ messages ]
       
   829 .PP
       
   830 Um ein neues Quota\-Limit für das Konto mit der angegebenen Adresse
       
   831 festzulegen, wird dieser Unterbefehl verwendet.
       
   832 .PP
       
   833 Wenn der Wert für das Argument
       
   834 .I messages
       
   835 ausgelassen wurde, wird der Vorgabewert
       
   836 .B 0
       
   837 (null) als Anzahl von Nachrichten angewendet werden.
       
   838 .PP
       
   839 Anstelle der Limits, bewirkt das Wort
       
   840 .BR domain ,
       
   841 dass die Limits des Kontos gelöscht wird und somit wieder der in der
       
   842 Domain gespeicherte Wert für das Konto gilt.
       
   843 .PP
       
   844 Beispiel:
       
   845 .PP
       
   846 .nf
       
   847 .B vmm userquota d.user@example.com 750m
       
   848 .B vmm userquote d.user@example.com domain
       
   849 .fi
       
   850 .\" ------------------------------------
       
   851 .SS userservices (us)
       
   852 .B vmm userservices
       
   853 .IR address " [" "service ..." ]
       
   854 .PP
       
   855 Verwenden Sie diesen Unterbefehl, um einem Anwender den Zugriff auf die
       
   856 genannten Services zu gestatten.
       
   857 .PP
       
   858 Der Zugriff auf alle nicht genannten Services wird dem Anwender, mit der
       
   859 angegebenen Adresse, verwehrt werden.
       
   860 .PP
       
   861 Anstelle einer Liste, bewirkt das Wort
       
   862 .BR domain ,
       
   863 dass die benutzerspezifische Liste gelöscht wird und somit wieder die in
       
   864 der Domain gespeicherte Liste für das Konto gilt.
       
   865 .PP
       
   866 Beispiel:
       
   867 .PP
       
   868 .nf
       
   869 .B vmm userservices d.user@example.com SMTP IMAP
       
   870 .B vmm userservices d.user@example.com domain
       
   871 .\" ------------------------------------
       
   872 .SS usertransport (ut)
       
   873 .BI "vmm usertransport" " address transport"
       
   874 .PP
       
   875 Mit diesem Unterbefehl kann ein abweichender
       
   876 .I transport
       
   877 für das Konto mit der angegebenen Adresse bestimmt werden.
       
   878 .PP
       
   879 Wird als
       
   880 .I transport
       
   881 das Wort 'domain' übergeben, so wird der explizite Transport des Kontos
       
   882 wieder gelöscht und der in der Domain gespeicherte Wert benutzt.
       
   883 .PP
       
   884 Beispiel:
       
   885 .br
       
   886 Angenommen, Sie wollen mit Dovecots
       
   887 .BR dsync (1)
       
   888 die E\-Mails vom Maildir\-Format ins mdbox\-Format konvertieren, dann
       
   889 können Sie Postfix, über den Transport, darüber informieren, es später
       
   890 nochmals zu versuchen.
       
   891 .PP
       
   892 .nf
       
   893 .B vmm ut d.user@example.com \(dqretry:4.0.0 Mailbox being migrated\(dq
       
   894 # Konvertieren der Mailbox …
       
   895 # … danach den Transport auf den Domainwert setzen
       
   896 .B vmm usertransport d.user@example.com domain
       
   897 .fi
       
   898 .\" -----------------------------------------------------------------------
       
   899 .SH ALIAS UNTERBEFEHLE
       
   900 .SS aliasadd (aa)
       
   901 .BI "vmm aliasadd" " address destination ..."
       
   902 .PP
       
   903 Mit diesem Unterbefehl werden neue Alias\-Adressen, mit einer oder mehren
       
   904 .IR destination (en),
       
   905 erstellt.
       
   906 .PP
       
   907 Innerhalb der Zieladresse werden die Zeichenketten
       
   908 .IR %n ,
       
   909 .IR %d
       
   910 und
       
   911 .IR %=
       
   912 durch den ursprünglichen lokalen Teil, die Domain bzw. die Emailadresse mit
       
   913 '=' anstelle von '@' ersetzt. Dies ermöglicht z.B. in Verbindung mit
       
   914 Alias\-Domains domain\-spezifische Empfänger.
       
   915 .PP
       
   916 Beispiele:
       
   917 .PP
       
   918 .nf
       
   919 .B vmm aliasadd john.doe@example.com d.user@example.com
       
   920 .B vmm aa support@example.com d.user@example.com e.user@example.com
       
   921 .B vmm aa postmaster@example.com postmaster+%d@example.org
       
   922 .fi
       
   923 .\" ------------------------------------
       
   924 .SS aliasdelete (ad)
       
   925 .BI "vmm aliasdelete" " address"
       
   926 .RI [ destination " ...]"
       
   927 .PP
       
   928 Verwenden Sie diesen Unterbefehl um den Alias mit der angegebenen Adresse
       
   929 zu löschen.
       
   930 .PP
       
   931 Wurden eine oder mehrere optionale
       
   932 .I destination
       
   933 Adressen angegeben, so werden nur diese
       
   934 .IR destination s
       
   935 vom angegebenen Alias entfernt.
       
   936 .PP
       
   937 Beispiel:
       
   938 .PP
       
   939 .nf
       
   940 .B vmm aliasdelete support@example.com d.user@example.com
       
   941 .fi
       
   942 .\" ------------------------------------
       
   943 .SS aliasinfo (ai)
       
   944 .BI "vmm aliasinfo" " address"
       
   945 .PP
       
   946 Informationen zum Alias mit der angegebenen Adresse können mit diesem
       
   947 Unterbefehl ausgegeben werden.
       
   948 .PP
       
   949 Beispiel:
       
   950 .PP
       
   951 .nf
       
   952 .B vmm aliasinfo support@example.com
       
   953 Alias Informationen
       
   954 -------------------
       
   955         E\-Mails für support@example.com werden weitergeleitet an:
       
   956              * e.user@example.com
       
   957 .fi
       
   958 .\" -----------------------------------------------------------------------
       
   959 .SH RELOCATED UNTERBEFEHLE
       
   960 .SS relocatedadd (ra)
       
   961 .BI "vmm relocatedadd" " address newaddress"
       
   962 .PP
       
   963 Um einen neuen Relocated User anzulegen kann dieser Unterbefehl verwendet
       
   964 werden.
       
   965 .PP
       
   966 Dabei ist
       
   967 .I address
       
   968 die ehemalige Adresse des Benutzers, zum Beispiel b.nutzer@example.com, und
       
   969 .I newaddress
       
   970 die neue Adresse, unter der die/der Benutzer/in erreichbar ist.
       
   971 .PP
       
   972 Beispiel:
       
   973 .PP
       
   974 .nf
       
   975 .B vmm relocatedadd b.nutzer@example.com b\-nutzer@firma.tld
       
   976 .fi
       
   977 .\" ------------------------------------
       
   978 .SS relocatedinfo (ri)
       
   979 .BI "vmm relocatedinfo " address
       
   980 .PP
       
   981 Dieser Unterbefehl zeigt die neue Adresse des Relocated Users mit mit der
       
   982 angegebenen Adresse.
       
   983 .PP
       
   984 Beispiel:
       
   985 .PP
       
   986 .nf
       
   987 .B vmm relocatedinfo b.nutzer@example.com
       
   988 Verschiebe\-Informationen
       
   989 ------------------------
       
   990         Der Benutzer »b.nutzer@example.com« wurde nach »b\-nutzer@firma.tld« verschoben
       
   991 .fi
       
   992 .\" ------------------------------------
       
   993 .SS relocateddelete (rd)
       
   994 .BI "vmm relocateddelete " address
       
   995 .PP
       
   996 Mit diesem Unterbefehl kann der Relocated User mit der angegebenen Adresse
       
   997 gelöscht werden.
       
   998 .PP
       
   999 Beispiel:
       
  1000 .PP
       
  1001 .nf
       
  1002 .B vmm relocateddelete b.nutzer@example.com
       
  1003 .fi
       
  1004 .\" -----------------------------------------------------------------------
       
  1005 .SH CATCH\-ALL UNTERBEFEHLE
       
  1006 .SS catchalladd (caa)
       
  1007 .BI "vmm catchalladd" " fqdn destination ..."
       
  1008 .PP
       
  1009 Mit diesem Unterbefehl können für eine Domain Adressen definiert werden, an
       
  1010 die E\-Mails geleitet werden, die an nicht\-existente Adressen innerhalb
       
  1011 dieser Domains adressiert sind.
       
  1012 Diese Adressen \(dqfangen alle\(dq diese E\-Mails auf, es sei denn es
       
  1013 bestehen spezifischere Aliase, Mailboxen oder Relocated\-Einträge.
       
  1014 .PP
       
  1015 WARNUNG: Catch\-all Adressen können dazu führen, dass ein Mailserver von
       
  1016 Spam überflutet wird, da Spammer zuweilen gerne alle möglichen Emailadressen
       
  1017 ausprobieren und man auf einmal zig tausend Nachrichten gerichtet an
       
  1018 Adressen von abba@example.org bis zztop@example.org weitergeleitet bekommt.
       
  1019 .PP
       
  1020 Beispiel:
       
  1021 .PP
       
  1022 .nf
       
  1023 .B vmm catchalladd example.com b.nutzer@example.org
       
  1024 .fi
       
  1025 .\" ------------------------------------
       
  1026 .SS catchallinfo (cai)
       
  1027 .BI "vmm catchallinfo " fqdn
       
  1028 .PP
       
  1029 Dieser Unterbefehl zeigt die für eine Domain definierten Catch\-all Aliase
       
  1030 an.
       
  1031 .PP
       
  1032 Beispiel:
       
  1033 .PP
       
  1034 .nf
       
  1035 .B vmm catchallinfo example.com
       
  1036 Catch-all Informationen
       
  1037 -----------------------
       
  1038   Nachrichten an unbekannte Adressen innerhalb der example.com Domäne werden
       
  1039   weitergeleitet an:
       
  1040          * b.nutzer@example.org
       
  1041 .fi
       
  1042 .\" ------------------------------------
       
  1043 .SS catchalldelete (cad)
       
  1044 .BI "vmm catchalldelete " fqdn
       
  1045 .RI [ destination " ...]"
       
  1046 .PP
       
  1047 Mit diesem Unterbefehl werden Catch\-all Aliase einer Domain wieder
       
  1048 gelöscht,
       
  1049 entweder nur das/die angegebene(n) Alias(e), oder alle, wenn keine
       
  1050 .I destination
       
  1051 Adresse angegeben wurde.
       
  1052 .PP
       
  1053 Beispiel:
       
  1054 .PP
       
  1055 .nf
       
  1056 .B vmm catchalldelete example.com b.nutzer@example.org
       
  1057 .fi
       
  1058 .\" -----------------------------------------------------------------------
       
  1059 .SH DATEIEN
       
  1060 .TP
       
  1061 .I /root/vmm.cfg
       
  1062 Wird verwendet, falls vorhanden.
       
  1063 .TP
       
  1064 .I /usr/local/etc/vmm.cfg
       
  1065 Wird verwendet, sollte obige Datei nicht gefunden werden.
       
  1066 .TP
       
  1067 .I /etc/vmm.cfg
       
  1068 Wird verwendet, falls die oben genannten Dateien nicht existieren.
       
  1069 .\" -----------------------------------------------------------------------
       
  1070 .SH SIEHE AUCH
       
  1071 .BR dsync (1),
       
  1072 .BR transport (5),
       
  1073 .BR vmm.cfg (5)
       
  1074 .\" -----------------------------------------------------------------------
       
  1075 .SH INTERNET RESSOURCEN
       
  1076 .TP
       
  1077 Homepage
       
  1078 http://vmm.localdomain.org/
       
  1079 .TP
       
  1080 Projekt\-Seite
       
  1081 http://sf.net/projects/vmm/
       
  1082 .TP
       
  1083 Bugtracker
       
  1084 https://bitbucket.org/pvo/vmm/issues
       
  1085 .\" -----------------------------------------------------------------------
       
  1086 .SH COPYING
       
  1087 vmm und die dazugehörigen Manualseiten wurden von Pascal Volk <user+vmm AT
       
  1088 localhost.localdomain.org> geschrieben und sind unter den Bedingungen der
       
  1089 BSD Lizenz lizenziert.