doc/web/source/howto/manage_catch-all_addresses.rst
changeset 760 b678a1c43027
parent 748 659c4476c57c
child 761 e4e656f19771
equal deleted inserted replaced
748:659c4476c57c 760:b678a1c43027
     1 ============================
       
     2 Managing catch-all addresses
       
     3 ============================
       
     4 catchalladd
       
     5 -----------
       
     6 Syntax:
       
     7  | **vmm catchalladd** *fqdn destination ...*
       
     8  | **vmm caa** *fqdn destination ...*
       
     9 
       
    10 This subcommand allows to specify destination addresses for a domain, which
       
    11 shall receive mail addressed to unknown local-parts within that domain.
       
    12 Those catch-all aliases hence "catch all" mail to  any address in the domain
       
    13 (unless a more specific alias, mailbox or relocated entry exists).
       
    14 
       
    15 .. warning::
       
    16    Catch-all addresses can cause mail server flooding because spammers like
       
    17    to deliver mail to all possible combinations of names, e.g. to all
       
    18    addresses between abba\@example.org and zztop\@example.org.
       
    19 
       
    20 Example:
       
    21 
       
    22 .. code-block:: console
       
    23 
       
    24  root@host:~# vmm catchalladd example.com user@example.org
       
    25 
       
    26 .. versionadded:: 0.6.0
       
    27 
       
    28 catchalldelete
       
    29 --------------
       
    30 Syntax:
       
    31  | **vmm catchalldelete** *fqdn* [*destination* ...]
       
    32  | **vmm cad** *fqdn* [*destination* ...]
       
    33 
       
    34 With this subcommand, catch-all aliases defined for a domain can be removed,
       
    35 either all of them, or those *destination*\ s which were specified explicitly.
       
    36 
       
    37 Example:
       
    38 
       
    39 .. code-block:: console
       
    40 
       
    41  root@host:~# vmm catchalldelete example.com user@example.com
       
    42 
       
    43 .. versionadded:: 0.6.0
       
    44 
       
    45 .. versionchanged:: 0.6.1
       
    46    Accept multiple destinations.
       
    47 
       
    48 catchallinfo
       
    49 ------------
       
    50 Syntax:
       
    51  | **vmm catchallinfo** *fqdn*
       
    52  | **vmm cai** *fqdn*
       
    53 
       
    54 This subcommand displays information about catch-all aliases defined for
       
    55 a domain.
       
    56 
       
    57 Example:
       
    58 
       
    59 .. code-block:: console
       
    60 
       
    61  root@host:~# vmm catchallinfo example.com
       
    62  Catch-all information
       
    63  ---------------------
       
    64    Mail to unknown localparts in domain example.com will be sent to:
       
    65           * user@example.org
       
    66 
       
    67 .. versionadded:: 0.6.0
       
    68