============================
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 local-parts in domain example.com will be sent to:
          * user@example.org

.. versionadded:: 0.6.0