doc/web/source/howto/manage_catch-all_addresses.rst
author Pascal Volk <user@localhost.localdomain.org>
Tue, 06 Nov 2012 19:46:06 +0000
branchv0.7.x
changeset 639 d50fe67778c6
parent 622 e60b8ed5fd35
child 682 697350dd9369
permissions -rw-r--r--
setup.py: PEP-314-ified. Distutils setup() function now has the 'requires` keyword parameter.

============================
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 those *destination*\ s which were specified explicitly.

Example:

.. code-block:: console

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

.. versionadded:: 0.6.0

.. versionchanged:: 0.6.1
   Accept multiple destinations.

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