masqmail
annotate man/masqmail.aliases.5 @ 352:4905a1d9e6a7
minor improvement of output of devel/are-options-documented
| author | markus schnalke <meillo@marmaro.de> |
|---|---|
| date | Sun, 04 Sep 2011 10:14:36 +0200 |
| parents | 8bf7820a0e0e |
| children | 35c5239ebcc1 |
| 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, |