NAME

       masqmail.aliases - masqmail alias file format

DESCRIPTION

       This man page describes the format of the masqmail alias file.  Its usual location is /etc/aliases.

FILE FORMAT

       The  alias  file consists of lines of the form: local_part: item1, item2, ...  Items can be surrounded by
       double quotes `"'.  If within the quotes other quotes are needed for an address they can be escaped  with
       a leading backslash `\'.

       A leading backslash `\' indicates that this address shall not be further expanded.

       A leading pipe symbol `|' indicates that the item shall be treated as a pipe command.  The content of the
       message  will  then be sent to the standard input of the command.  The command will run under the user id
       and group id masqmail is running as.  If quotes are needed,  the  pipe  symbol  must  appear  within  the
       quotes.

       Loops will be detected, the offending address will be ignored.

       Aliases  will be expanded at delivery time.  This means that if there is a message still in the queue and
       you change any alias which matches one of the recipient addresses, the change will have effect next  time
       a delivery is attemped.

       There is no need to restart masqmail or run any command when the alias file has been changed.

EXAMPLE

       # postmaster is required by RFC 2821
       postmaster: root

       # forward abuse mail to another address
       abuse: abuse@example.org

       # copy root's mail also to meillo
       root: \root, meillo

       # pass mail to a script
       foo: |/usr/bin/foo

AUTHOR

       Masqmail was written by Oliver Kurth.  It is now maintained by Markus Schnalke <meillo@marmaro.de>.

       You  will  find  the  newest  version  of  masqmail at http://marmaro.de/prog/masqmail/.  There is also a
       mailing list, you will find information about it at masqmail's main site.

BUGS

       Please report bugs to the mailing list.

SEE ALSO

       masqmail.conf(5), masqmail(8),

masqmail-0.3.4                                     2012-01-18                                masqmail.aliases(5)