doc/web/source/howto/manage_alias_addresses.rst
changeset 760 b678a1c43027
parent 748 659c4476c57c
child 761 e4e656f19771
equal deleted inserted replaced
748:659c4476c57c 760:b678a1c43027
     1 ========================
       
     2 Managing alias addresses
       
     3 ========================
       
     4 aliasadd
       
     5 --------
       
     6 Syntax:
       
     7  | **vmm aliasadd** *address destination ...*
       
     8  | **vmm aa** *address destination ...*
       
     9 
       
    10 This subcommand is used to create a new alias *address* with one or more
       
    11 *destination* addresses.
       
    12 
       
    13 Within the destination address, the placeholders **%n**, **%d**, and **%=**
       
    14 will be replaced by the local-part, the domain, or the email address with
       
    15 **@** replaced by **=** respectively.
       
    16 In combination with alias domains, this enables domain-specific destinations.
       
    17 
       
    18 Example:
       
    19 
       
    20 .. code-block:: console
       
    21 
       
    22  root@host:~# vmm aliasadd john.doe@example.com d.user@example.com
       
    23  root@host:~# vmm aa support@example.com d.user@example.com e.user@example.com
       
    24  root@host:~# vmm aa postmaster@example.com postmaster+%d@example.org
       
    25 
       
    26 aliasdelete
       
    27 -----------
       
    28 Syntax:
       
    29  | **vmm aliasdelete** *address* [*destination* ...]
       
    30  | **vmm ad** *address* [*destination* ...]
       
    31 
       
    32 This subcommand is used to delete one or multiple *destination*\ s from the
       
    33 alias with the given *address*.
       
    34 
       
    35 When no *destination* address was specified the alias with all its
       
    36 destinations will be deleted.
       
    37 
       
    38 Example:
       
    39 
       
    40 .. code-block:: console
       
    41 
       
    42  root@host:~# vmm ad support@example.com d.user@example.com
       
    43 
       
    44 .. versionchanged:: 0.6.1
       
    45    Accept multiple destinations.
       
    46 
       
    47 aliasinfo
       
    48 ---------
       
    49 Syntax:
       
    50  | **vmm aliasinfo** *address*
       
    51  | **vmm ai** *address*
       
    52 
       
    53 Information about the alias with the given *address* can be displayed with
       
    54 this subcommand.
       
    55 
       
    56 Example:
       
    57 
       
    58 .. code-block:: console
       
    59 
       
    60  root@host:~# vmm aliasinfo support@example.com
       
    61  Alias information
       
    62  -----------------
       
    63          Mail for support@example.com will be redirected to:
       
    64               * e.user@example.com
       
    65