annotate man/masqmail.aliases.5 @ 179:ec3fe72a3e99

Fixed an important bug with folded headers! g_strconcat() returns a *copy* of the string, but hdr->value still pointed to the old header (which probably was a memory leak, too). If the folded part had been quite small it was likely that the new string was at the same position as the old one, thus making everything go well. But if pretty long headers were folded several times it was likely that the new string was allocated somewhere else in memory, thus breaking things. In result mails to lots of recipients (folded header) were frequently only sent to the ones in the first line. Sorry for the inconvenience.
author meillo@marmaro.de
date Fri, 03 Jun 2011 09:52:17 +0200
parents a2bec9a14324
children 49ebdea079c6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
173
a2bec9a14324 updated date and version in man pages
meillo@marmaro.de
parents: 156
diff changeset
1 .TH masqmail.aliases 5 2010-07-23 masqmail-0.2.28 "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
95
e01fed4846e4 masqmail's homepage moved prog.marmaro.de/masqmail -> marmaro.de/prog/masqmail
meillo@marmaro.de
parents: 57
diff changeset
43 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
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,