valias.1

NAME

valias - add/modify/delete alias for virtual users

SYNOPSYS

valias [options] [alias | address | domain_name]

DESCRIPTION

valias adds valias entries for virtual users in the table valias. valias entries are equivalent to .qmail files. valias is useful in cases where large number of forwarding/aliases are to be maintained and having numerous physical files on the file system could prove to be cumbersome/inefficient or impossible (i.e. > 32768 on some filesystems).

OPTIONS

-v
Set Verbose mode

-s
Show aliases (domain_name needs to be given). Give @domain_name for all aliases for the domain.

-S
Track all aliases which deliver to address.

-d address
Delete address corresponding to alias alias

-i address
Insert new address for the alias. If the alias does not exist, it will be created. An address has one of the 3 forms. See dot-qmail(5) for more details.

 1. &user@domain  - Forward mails to user@domain
 2. Maildir       - copy mails to a Maildir with path Maildir
 3. | Command     - pipe the mail through command Command

-u old_address -i new_address
Change address for an existing alias

-m
Ignore requirement of alias to be local (option for clustered domain only)

alias
Should be a local deliverable address on the host where valias is executed.

RETURN VALUE

0 in case of success, 1 in case of any failure.

SEE ALSO

dot-qmail(5), vcalias(8), vgroup(1), vdelivermail(8), vrenamedomain(1), vreorg(8)