masqmail

view man/masqmail.aliases.5 @ 330:f899ca0835a8

find changesets by author, revision, files, or words in the commit message
Fixed local-part only address patterns in route conditions The man page claimed behavior that wasn't implemented up to now. Thanks to Juergen Daubert for the bug report.
author markus schnalke <meillo@marmaro.de>
date Wed, 13 Jul 2011 10:30:52 +0200
parents fa62b148bb14
children ef346dc67514
line source
1 .TH masqmail.aliases 5 2011-06-03 masqmail-0.3.2 "File Formats"
2
3 .SH NAME
4 masqmail.aliases \- masqmail alias file format
5
6
7 .SH DESCRIPTION
8
9 This man page describes the format of the masqmail alias file.
10 Its usual location is \fI/etc/aliases\fR.
11
12
13 .SH FILE FORMAT
14
15 The alias file consists of lines of the form:
16 local_part: item1, item2, ...
17 Items can be surrounded by double quotes `"'.
18 If within the quotes other quotes are needed for an address they can be
19 escaped with a leading backslash `\\'.
20
21 A leading backslash `\\' indicates that this address shall not be further expanded.
22
23 A leading pipe symbol `|' indicates that the item shall be treated as a pipe command.
24 The content of the message will then be sent to the standard input of the command.
25 The command will run under the user id and group id masqmail is running as.
26 If quotes are needed, the pipe symbol must appear within the quotes.
27
28 Loops will be detected, the offending address will be ignored.
29
30 Aliases will be expanded at delivery time.
31 This means that if there is a message still in the queue and you change
32 any alias which matches one of the recipient addresses,
33 the change will have effect next time a delivery is attemped.
34
35 There is no need to restart masqmail or run any command when the alias file has been changed.
36
37
38 .SH EXAMPLE
39
40 .nf
41 # postmaster is required by RFC 2821
42 postmaster: root
43
44 # forward abuse mail to another address
45 abuse: abuse@example.org
46
47 # copy root's mail also to meillo
48 root: \\root, meillo
49
50 # pass mail to a script
51 foo: |/usr/bin/foo
52 .fi
53
54
55 .SH AUTHOR
56
57 Masqmail was written by Oliver Kurth.
58 It is now maintained by Markus Schnalke <meillo@marmaro.de>.
59
60 You will find the newest version of masqmail at \fBhttp://marmaro.de/prog/masqmail/\fR.
61 There is also a mailing list, you will find information about it at masqmail's main site.
62
63
64 .SH BUGS
65
66 Please report bugs to the mailing list.
67
68
69 .SH SEE ALSO
70
71 \fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR,