1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/man/masqmail.aliases.5	Fri Sep 26 17:05:23 2008 +0200
     1.3 @@ -0,0 +1,41 @@
     1.4 +.TH masqmail.aliases 5 User Manuals
     1.5 +.SH NAME
     1.6 +masqmail.aliases \- masqmail alias file format
     1.7 +.SH DESCRIPTION
     1.8 +
     1.9 +This man page describes the format of the masqmail alias file. Its usual location is \fI/etc/aliases\f1.
    1.10 +
    1.11 +.SH FILE FORMAT
    1.12 +
    1.13 +The alias file consists of lines of the form:
    1.14 +local_part: item1, item2, ...
    1.15 +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 '\'.
    1.16 +
    1.17 +A leading '\' indicates that this address shall not be further expanded.
    1.18 +
    1.19 +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.
    1.20 +
    1.21 +Loops will be detected, the offending address will be ignored.
    1.22 +
    1.23 +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.
    1.24 +
    1.25 +There is no need to restart masqmail or run any command when the alias file has been changed.
    1.26 +
    1.27 +.SH AUTHOR
    1.28 +
    1.29 +masqmail was written by Oliver Kurth <oku@masqmail.cx>
    1.30 +
    1.31 +You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site.
    1.32 +
    1.33 +.SH BUGS
    1.34 +
    1.35 +You should report them to the mailing list.
    1.36 +
    1.37 +.SH SEE ALSO
    1.38 +
    1.39 +\fBmasqmail.conf (5)\f1, \fBmasqmail (8)\f1, 
    1.40 +
    1.41 +.SH COMMENTS
    1.42 +
    1.43 +This man page was written using \fBxml2man (1)\f1 by the same author.
    1.44 +