doc/web/source/howto/manage_catch-all_addresses.rst
author Pascal Volk <user@localhost.localdomain.org>
Sat, 29 Sep 2012 15:57:24 +0000
changeset 621 d8b60e53334f
parent 591 2b165e90e225
child 622 e60b8ed5fd35
permissions -rw-r--r--
VMM/cli/clihelp: Added missing help messages. Added descriptions of subcommands listaddresses, listaliases, listrelocated and listusers.

============================
Managing catch-all addresses
============================
catchalladd
-----------
Syntax:
 | **vmm catchalladd** *fqdn destination ...*
 | **vmm caa** *fqdn destination ...*

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

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

Example:

.. code-block:: console

 root@host:~# vmm catchalladd example.com user@example.org

.. versionadded:: 0.6.0

catchalldelete
--------------
Syntax:
 | **vmm catchalldelete** *fqdn* [*destination*]
 | **vmm cad** *fqdn* [*destination*]

With this subcommand, catch-all aliases defined for a domain can be removed,
either all of them, or a single one if specified explicitly.

Example:

.. code-block:: console

 root@host:~# vmm catchalldelete example.com user@example.com

.. versionadded:: 0.6.0

catchallinfo
------------
Syntax:
 | **vmm catchallinfo** *fqdn*
 | **vmm cai** *fqdn*

This subcommand displays information about catch-all aliases defined for
a domain.

Example:

.. code-block:: console

 root@host:~# vmm catchallinfo example.com
 Catch-all information
 ---------------------
   Mail to unknown localparts in domain example.com will be sent to:
          * user@example.org

.. versionadded:: 0.6.0