doc/web/source/howto/manage_alias_addresses.rst
author Pascal Volk <user@localhost.localdomain.org>
Mon, 26 Nov 2012 22:07:20 +0000
branchv0.7.x
changeset 655 2bf68600e914
parent 622 e60b8ed5fd35
permissions -rw-r--r--
VMM/password: Code cleanups: - Rely no longer on Crypto.Hash for md4 support. Python's hashlib on FreeBSD, Linux and OpenBSD provides the md4 hash. - Dropped DIGEST-MD5 password hashing for Dovecot <= v1.1.12/v1.2.beta2

========================
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