Mercurial > masqmail

annotate docs/masqmail.aliases.5 @ 42:03817f849106

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
decided to release the next version as 0.2.22 (not as 0.3.0) I'll keep the 0.2 branch as the stable version which gets only bugfixed. Soon I'll split off a 0.3 branch for further (incompatible) development.
author meillo@marmaro.de
date Thu, 13 May 2010 17:34:23 +0200
parents 8071dc6c6ed1
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
42
03817f849106 decided to release the next version as 0.2.22 (not as 0.3.0)
meillo@marmaro.de
parents: 40
diff changeset
1 .TH masqmail.aliases 5 2010-05-07 masqmail-0.2.22 "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.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
24 The content of the message will then be sent to the standard input of a command.
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
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
38 .SH AUTHOR
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
39
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
40 Masqmail was written by Oliver Kurth.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
41 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
42
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
43 You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
26
607221b0dac1 added myself as maintainer; updated URL of the website
meillo@marmaro.de
parents: 3
diff changeset
44 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
45
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
46
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
47 .SH BUGS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
48
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
49 Please report bugs to the mailing list.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
50
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
51
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
52 .SH SEE ALSO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
53
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
54 \fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR,