masqmail-0.2

annotate docs/masqmail.aliases.5 @ 29:7cdd30429cc9

clarified the situation by changing a comment
author meillo@marmaro.de
date Thu, 06 May 2010 12:46:53 +0200
parents 8c55886cacd8
children 8ea86ac25658
rev   line source
meillo@0 1 .TH masqmail.aliases 5 User Manuals
meillo@0 2 .SH NAME
meillo@0 3 masqmail.aliases \- masqmail alias file format
meillo@0 4 .SH DESCRIPTION
meillo@0 5
meillo@0 6 This man page describes the format of the masqmail alias file. Its usual location is \fI/etc/aliases\f1.
meillo@0 7
meillo@0 8 .SH FILE FORMAT
meillo@0 9
meillo@0 10 The alias file consists of lines of the form:
meillo@0 11 local_part: item1, item2, ...
meillo@0 12 Items can be surrounded by quotes '"'. If within the quotes other quotes are needed for an address they can be escaped with a leading backslash '\'.
meillo@0 13
meillo@0 14 A leading '\' indicates that this address shall not be further expanded.
meillo@0 15
meillo@0 16 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 a 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.
meillo@0 17
meillo@0 18 Loops will be detected, the offending address will be ignored.
meillo@0 19
meillo@0 20 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.
meillo@0 21
meillo@0 22 There is no need to restart masqmail or run any command when the alias file has been changed.
meillo@0 23
meillo@0 24 .SH AUTHOR
meillo@0 25
meillo@26 26 masqmail was written by Oliver Kurth. It is now maintained by Markus Schnalke <meillo@marmaro.de>.
meillo@0 27
meillo@26 28 You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\f1.
meillo@26 29 There is also a mailing list, you will find information about it at masqmail's main site.
meillo@0 30
meillo@0 31 .SH BUGS
meillo@0 32
meillo@0 33 You should report them to the mailing list.
meillo@0 34
meillo@0 35 .SH SEE ALSO
meillo@0 36
meillo@0 37 \fBmasqmail.conf (5)\f1, \fBmasqmail (8)\f1,
meillo@0 38
meillo@0 39 .SH COMMENTS
meillo@0 40
meillo@0 41 This man page was written using \fBxml2man (1)\f1 by the same author.
meillo@0 42