masqmail-0.2

annotate docs/xml/masqmail.aliases.5.xml @ 0:08114f7dcc23

this is masqmail-0.2.21 from oliver kurth
author meillo@marmaro.de
date Fri, 26 Sep 2008 17:05:23 +0200
parents
children
rev   line source
meillo@0 1 <?xml version="1.0" standalone='no'?>
meillo@0 2 <!DOCTYPE spec SYSTEM "man.dtd">
meillo@0 3
meillo@0 4 <manpage name="masqmail.aliases" section="5" desc="masqmail alias file format">
meillo@0 5
meillo@0 6 <description>
meillo@0 7 <p>This man page describes the format of the masqmail alias file. Its usual location is <file>/etc/aliases</file>.</p>
meillo@0 8 </description>
meillo@0 9
meillo@0 10 <section name="File Format">
meillo@0 11 <p>The alias file consists of lines of the form:</p>
meillo@0 12 <pre>
meillo@0 13 local_part: item1, item2, ...
meillo@0 14 </pre>
meillo@0 15
meillo@0 16 <p>Items can be surrounded by quotes '"'. If within the quotes other
meillo@0 17 quotes are needed for an address they can be escaped with a leading
meillo@0 18 backslash '\'.</p>
meillo@0 19
meillo@0 20 <p>A leading '\' indicates that this address shall not be further
meillo@0 21 expanded.</p>
meillo@0 22
meillo@0 23 <p>A leading pipe symbol '|' indicates that the item shall be treated
meillo@0 24 as a pipe command. The content of the message will then be sent to the
meillo@0 25 standard input of a command. The command will run under the user id
meillo@0 26 and group id masqmail is running as. If quotes are needed, the pipe
meillo@0 27 symbol must appear <i>within</i> the quotes.</p>
meillo@0 28
meillo@0 29 <p>Loops will be detected, the offending address will be ignored.</p>
meillo@0 30
meillo@0 31 <p>Aliases will be expanded at <i>delivery</i> time. This means that
meillo@0 32 if there is a message still in the queue and you change any alias
meillo@0 33 which matches one of the recipient addresses, the change will have
meillo@0 34 effect next time a delivery is attemped.</p>
meillo@0 35
meillo@0 36 <p>There is no need to restart masqmail or run any command when the
meillo@0 37 alias file has been changed.</p>
meillo@0 38 </section>
meillo@0 39
meillo@0 40 <section name = "Author">
meillo@0 41 <p>masqmail was written by Oliver Kurth
meillo@0 42 &lt;oku@masqmail.cx&gt;</p><p>You will find the newest version of
meillo@0 43 masqmail at <url href="http://masqmail.cx/masqmail/"/> or search for it
meillo@0 44 in freshmeat (<url href="http://www.freshmeat.net"/>). There is also a mailing list,
meillo@0 45 you will find information about it at masqmails main site.</p>
meillo@0 46 </section>
meillo@0 47
meillo@0 48 <section name = "Bugs">
meillo@0 49 <p>You should report them to the mailing list.</p>
meillo@0 50 </section>
meillo@0 51
meillo@0 52 <section name = "See also">
meillo@0 53 <p>
meillo@0 54 <manref name="masqmail.conf" section="5" href="masqmail.conf.5.html"/>, <manref name="masqmail" section="8" href="masqmail.8.html"/>,
meillo@0 55 </p>
meillo@0 56 </section>
meillo@0 57
meillo@0 58 <section name = "Comments">
meillo@0 59 <p>This man page was written using <manref name="xml2man" section="1"
meillo@0 60 href="http://masqmail.cx/xml2man/"/> by the same author.</p>
meillo@0 61 </section>
meillo@0 62
meillo@0 63 </manpage>