Mercurial > masqmail

annotate man/masqmail.aliases.5 @ 364:72653295b75d

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