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