1 <?xml version="1.0" standalone='no'?>

2 <!DOCTYPE spec SYSTEM "man.dtd">

3

4 <manpage name="masqmail.aliases" section="5" desc="masqmail alias file format">

5

6 <description>

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

8 </description>

9

10 <section name="File Format">

11 <p>The alias file consists of lines of the form:</p>

12 <pre>

13 local_part: item1, item2, ...

14 </pre>

15

16 <p>Items can be surrounded by quotes '"'. If within the quotes other

17 quotes are needed for an address they can be escaped with a leading

18 backslash '\'.</p>

19

20 <p>A leading '\' indicates that this address shall not be further

21 expanded.</p>

22

23 <p>A leading pipe symbol '|' indicates that the item shall be treated

24 as a pipe command. The content of the message will then be sent to the

25 standard input of a command. The command will run under the user id

26 and group id masqmail is running as. If quotes are needed, the pipe

27 symbol must appear <i>within</i> the quotes.</p>

28

29 <p>Loops will be detected, the offending address will be ignored.</p>

30

31 <p>Aliases will be expanded at <i>delivery</i> time. This means that

32 if there is a message still in the queue and you change any alias

33 which matches one of the recipient addresses, the change will have

34 effect next time a delivery is attemped.</p>

35

36 <p>There is no need to restart masqmail or run any command when the

37 alias file has been changed.</p>

38 </section>

39

40 <section name = "Author">

41 <p>masqmail was written by Oliver Kurth

42 &lt;oku@masqmail.cx&gt;</p><p>You will find the newest version of

43 masqmail at <url href="http://masqmail.cx/masqmail/"/> or search for it

44 in freshmeat (<url href="http://www.freshmeat.net"/>). There is also a mailing list,

45 you will find information about it at masqmails main site.</p>

46 </section>

47

48 <section name = "Bugs">

49 <p>You should report them to the mailing list.</p>

50 </section>

51

52 <section name = "See also">

53 <p>

54 <manref name="masqmail.conf" section="5" href="masqmail.conf.5.html"/>, <manref name="masqmail" section="8" href="masqmail.8.html"/>,

55 </p>

56 </section>

57

58 <section name = "Comments">

59 <p>This man page was written using <manref name="xml2man" section="1"

60 href="http://masqmail.cx/xml2man/"/> by the same author.</p>

61 </section>

62

63 </manpage>