doc/web/source/howto/manage_catch-all_addresses.rst
changeset 591 2b165e90e225
child 622 e60b8ed5fd35
equal deleted inserted replaced
590:9d343514b832 591:2b165e90e225
       
     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 a single one if 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 catchallinfo
       
    46 ------------
       
    47 Syntax:
       
    48  | **vmm catchallinfo** *fqdn*
       
    49  | **vmm cai** *fqdn*
       
    50 
       
    51 This subcommand displays information about catch-all aliases defined for
       
    52 a domain.
       
    53 
       
    54 Example:
       
    55 
       
    56 .. code-block:: console
       
    57 
       
    58  root@host:~# vmm catchallinfo example.com
       
    59  Catch-all information
       
    60  ---------------------
       
    61    Mail to unknown localparts in domain example.com will be sent to:
       
    62           * user@example.org
       
    63 
       
    64 .. versionadded:: 0.6.0
       
    65