meillo@380: .TH masqmail.aliases 5 2012-01-18 masqmail-0.3.4 "File Formats" meillo@34: meillo@0: .SH NAME meillo@0: masqmail.aliases \- masqmail alias file format meillo@34: meillo@34: meillo@0: .SH DESCRIPTION meillo@0: meillo@34: This man page describes the format of the masqmail alias file. meillo@34: Its usual location is \fI/etc/aliases\fR. meillo@34: meillo@0: meillo@0: .SH FILE FORMAT meillo@0: meillo@0: The alias file consists of lines of the form: meillo@0: local_part: item1, item2, ... meillo@34: Items can be surrounded by double quotes `"'. meillo@34: If within the quotes other quotes are needed for an address they can be meillo@34: escaped with a leading backslash `\\'. meillo@0: meillo@34: A leading backslash `\\' indicates that this address shall not be further expanded. meillo@0: meillo@34: A leading pipe symbol `|' indicates that the item shall be treated as a pipe command. meillo@313: The content of the message will then be sent to the standard input of the command. meillo@34: The command will run under the user id and group id masqmail is running as. meillo@34: If quotes are needed, the pipe symbol must appear within the quotes. meillo@0: meillo@0: Loops will be detected, the offending address will be ignored. meillo@0: meillo@34: Aliases will be expanded at delivery time. meillo@34: This means that if there is a message still in the queue and you change meillo@34: any alias which matches one of the recipient addresses, meillo@34: the change will have effect next time a delivery is attemped. meillo@0: meillo@0: There is no need to restart masqmail or run any command when the alias file has been changed. meillo@0: meillo@34: meillo@308: .SH EXAMPLE meillo@308: meillo@308: .nf meillo@308: # postmaster is required by RFC 2821 meillo@308: postmaster: root meillo@308: meillo@308: # forward abuse mail to another address meillo@308: abuse: abuse@example.org meillo@308: meillo@308: # copy root's mail also to meillo meillo@308: root: \\root, meillo meillo@308: meillo@308: # pass mail to a script meillo@308: foo: |/usr/bin/foo meillo@308: .fi meillo@308: meillo@308: meillo@0: .SH AUTHOR meillo@0: meillo@34: Masqmail was written by Oliver Kurth. meillo@34: It is now maintained by Markus Schnalke . meillo@0: meillo@95: You will find the newest version of masqmail at \fBhttp://marmaro.de/prog/masqmail/\fR. meillo@26: There is also a mailing list, you will find information about it at masqmail's main site. meillo@0: meillo@34: meillo@0: .SH BUGS meillo@0: meillo@34: Please report bugs to the mailing list. meillo@34: meillo@0: meillo@0: .SH SEE ALSO meillo@0: meillo@34: \fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR,