# HG changeset patch
# User martin f. krafft <madduck@madduck.net>
# Date 1334094635 -7200
# Node ID b2084e7f68542b59a1d60fcb56922677fca8f5d9
# Parent  09fa019bb330b7432e3b8ca164b70967b345831b
Add catchall subcommands to manpages

diff -r 09fa019bb330 -r b2084e7f6854 man/de/man1/vmm.1
--- a/man/de/man1/vmm.1	Tue Apr 10 23:50:18 2012 +0200
+++ b/man/de/man1/vmm.1	Tue Apr 10 23:50:35 2012 +0200
@@ -868,6 +868,55 @@
 .B vmm relocateddelete b.nutzer@example.com
 .fi
 .\" -----------------------------------------------------------------------
+.SH CATCH-ALL UNTERBEFEHLE
+.SS catchalladd (caa)
+.BI "vmm catchalladd" " domain destination ..."
+.PP
+Mit diesem Unterbefehl können für eine Domain Adressen definiert werden, an
+die E-mails geleitet werden, die an nicht-existente Adressen innerhalb dieser
+Domains adressiert sind. Diese Adressen \"fangen alle\" diese E-mails auf, es
+sei denn es bestehen spezifischere Aliase, Mailboxes oder Relocated-Einträge.
+.PP
+WARNUNG: Catch-all Adressen können dazu führen, daß ein Mailserver von Spam
+überflutet wird, da Spammer zuweilen gerne alle möglichen Emailadressen
+ausprobieren und man auf einmal zig tausend Nachrichten gerichtet an Adressen
+von abba@example.org bis zztop@example.org weitergeleitet bekommt.
+.PP
+Beispiel:
+.PP
+.nf
+.B vmm catchalladd example.com b.nutzer@example.org
+.fi
+.\" ------------------------------------
+.SS catchallinfo (cai)
+.BI "vmm catchallinfo " domain
+.PP
+Dieser Unterbefehl zeigt die für eine Domain definierten Catch-All Aliase an.
+.PP
+Beispiel:
+.PP
+.nf
+.B vmm catchallinfo example.com
+Catch-all Informationen
+-----------------------
+  Nachrichten an unbekannte Adressen innerhalb der example.com Domäne werden
+  weitergeleitet an:
+         * b.nutzer@example.org
+.fi
+.\" ------------------------------------
+.SS catchalldelete (cadd)
+.BI "vmm catchalldelete " domain
+.RI [ destination ]
+.PP
+Mit diesem Unterbefehl werden Catch-All Aliase einer Domain wieder gelöscht,
+entweder nur das angegebene Alias, oder alle, wenn keines angegeben wurde.
+.PP
+Beispiel:
+.PP
+.nf
+.B vmm catchalldelete example.com b.nutzer@example.org
+.fi
+.\" -----------------------------------------------------------------------
 .SH DATEIEN
 .TP
 .I /root/vmm.cfg
@@ -898,4 +947,4 @@
 .SH COPYING
 vmm und die dazugehörigen Manualseiten wurden von Pascal Volk <user+vmm AT
 localhost.localdomain.org> geschrieben und sind unter den Bedingungen der
-BSD Lizenz lizenziert.
\ No newline at end of file
+BSD Lizenz lizenziert.
diff -r 09fa019bb330 -r b2084e7f6854 man/man1/vmm.1
--- a/man/man1/vmm.1	Tue Apr 10 23:50:18 2012 +0200
+++ b/man/man1/vmm.1	Tue Apr 10 23:50:35 2012 +0200
@@ -832,6 +832,54 @@
 .B vmm relocateddelete b.user@example.com
 .fi
 .\" -----------------------------------------------------------------------
+.SH CATCH-ALL SUBCOMMANDS
+.SS catchalladd (caa)
+.BI "vmm catchalladd" " domain destination ..."
+.PP
+This subcommand allows to specify destination addresses for a domain, which
+shall receive mail addressed to unknown local parts within that domain. Those
+catch-all aliases hence "catch all" mail to any address in the domain (unless
+a more specific alias, mailbox or relocated entry exists).
+.PP
+WARNING: Catch-all addresses can cause mail server flooding because spammers
+like to deliver mail to all possible combinations of names, e.g. to all
+addresses between abba@example.org and zztop@example.org.
+.PP
+Example:
+.PP
+.nf
+.B vmm catchalladd example.com user@example.org
+.fi
+.\" ------------------------------------
+.SS catchallinfo (cai)
+.BI "vmm catchallinfo " domain
+.PP
+This subcommand displays information about catch-all aliases defined for
+a domain.
+.PP
+Example:
+.PP
+.nf
+.B vmm catchallinfo example.com
+Catch-all information
+---------------------
+  Mail to unknown localparts in domain sarah-machwirth.de will be sent to:
+         * user@example.org
+.fi
+.\" ------------------------------------
+.SS catchalldelete (cadd)
+.BI "vmm catchalldelete " domain
+.RI [ destination ]
+.PP
+With this subcommand, catch-all aliases defined for a domain can be removed,
+either all of them, or a single one if specified explicitly.
+.PP
+Example:
+.PP
+.nf
+.B vmm catchalldelete example user@example.com
+.fi
+.\" -----------------------------------------------------------------------
 .SH FILES
 .TP
 .I /root/vmm.cfg
@@ -862,4 +910,4 @@
 .SH COPYING
 vmm and its manual pages were written by Pascal Volk <user+vmm AT
 localhost.localdomain.org> and are licensed under the terms of the BSD
-License.
\ No newline at end of file
+License.