doc/web/source/howto/manage_alias_addresses.rst
author Pascal Volk <user@localhost.localdomain.org>
Tue, 20 Nov 2012 13:55:46 +0000
branchv0.7.x
changeset 645 fcc3f100e56a
parent 622 e60b8ed5fd35
permissions -rw-r--r--
Updated shebang to use python3 instead of python.

========================
Managing alias addresses
========================
aliasadd
--------
Syntax:
 | **vmm aliasadd** *address destination ...*
 | **vmm aa** *address destination ...*

This subcommand is used to create a new alias *address* with one or more
*destination* addresses.

Within the destination address, the placeholders **%n**, **%d**, and **%=**
will be replaced by the local-part, the domain, or the email address with
**@** replaced by **=** respectively.
In combination with alias domains, this enables domain-specific destinations.

Example:

.. code-block:: console

 root@host:~# vmm aliasadd john.doe@example.com d.user@example.com
 root@host:~# vmm aa support@example.com d.user@example.com e.user@example.com
 root@host:~# vmm aa postmaster@example.com postmaster+%d@example.org

aliasdelete
-----------
Syntax:
 | **vmm aliasdelete** *address* [*destination* ...]
 | **vmm ad** *address* [*destination* ...]

This subcommand is used to delete one or multiple *destination*\ s from the
alias with the given *address*.

When no *destination* address was specified the alias with all its
destinations will be deleted.

Example:

.. code-block:: console

 root@host:~# vmm ad support@example.com d.user@example.com

.. versionchanged:: 0.6.1
   Accept multiple destinations.

aliasinfo
---------
Syntax:
 | **vmm aliasinfo** *address*
 | **vmm ai** *address*

Information about the alias with the given *address* can be displayed with
this subcommand.

Example:

.. code-block:: console

 root@host:~# vmm aliasinfo support@example.com
 Alias information
 -----------------
         Mail for support@example.com will be redirected to:
              * e.user@example.com