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