masqmail
annotate man/masqmail.aliases.5 @ 323:29de6a1c4538
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:47:27 +0200 |
| parents | 86d8a3cf517d |
| children | 8bf7820a0e0e |
| rev | line source |
|---|---|
| meillo@291 | 1 .TH masqmail.aliases 5 2010-12-08 masqmail-0.3.1 "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, |