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,