masqmail
annotate man/masqmail.aliases.5 @ 337:fe00f7952a7c
Minor fixes in man pages, reported by lintian(1)
author | markus schnalke <meillo@marmaro.de> |
---|---|
date | Mon, 29 Aug 2011 19:32:38 +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, |