masqmail: man/masqmail.8 annotate

annotate man/masqmail.8 @ 286:e2f6eefbd573

further, minor, improvements to man/masqmail.8

author	markus schnalke <meillo@marmaro.de>
date	Tue, 07 Dec 2010 17:21:07 -0300
parents	bdcc2b42eb0f
children	792e0201c1b3

rev	line source
228 9397d10fd771 updated date and version of man pages meillo@marmaro.de parents: 192 diff changeset	1 .TH masqmail 8 2010-07-23 masqmail-0.3.0 "Maintenance Commands"
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 \- An offline Mail Transfer Agent
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	5
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	6 .SH SYNOPSIS
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	7
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	8 .BR masqmail\ [ \-t ] \ [ \-oi ] \ [ \-f\ \fIADDRESS ] \ \fIRECIPIENT...
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	9
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	10 .B mailq
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	11 .br
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	12 .B masqmail \-bp
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	13
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	14 .B runq
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	15 .br
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	16 .B masqmail \-q
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	17
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	18 .BR masqmail\ \-qo\ [ \fINAME ]
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	19
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	20 .BI mailrm\ MSGID...
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	21 .br
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	22 .BI masqmail\ -Mrm\ MSGID...
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	23
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	24 .BR masqmail\ [ \-C\ \fIFILE ] \ [ \-odq ]\ \-bs
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	25
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	26 .BR masqmail\ [ \-C\ \fIFILE ] \ [ \-odq ]\ \-bd\ \-q\fIINTERVAL
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	27
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	28 (This list is a selection.)
0 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
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	31 .SH DESCRIPTION
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	32
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	33 Masqmail is a mail server designed for hosts that do not have a permanent internet connection
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	34 e.g. a home network or a single host at home.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	35 It has special support for connections to different ISPs.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	36 It replaces sendmail or other MTAs such as qmail or exim.
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
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	39 .SH OPERATION MODES
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	40
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	41 Masqmail operates in one of several exclusive modes.
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	42
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	43 The daemon mode has two flavors that may be,
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	44 and usually are, used in combination:
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	45 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	46 .B Daemon (listen)
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	47 .B \-bd
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	48 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	49 .B smtpd
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	50
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	51 Run as daemon.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	52 Act as SMTP server and accept SMTP connections,
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	53 on port 25 if not configured differently.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	54
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	55 This is normally used in the startup script at system boot
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	56 and together with \fB\-q\fIINTERVAL\fR (see below).
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	57
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	58 Alternatively masqmail can be run with the \fB\-bs\fR option
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	59 from inetd.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	60
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	61 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	62 .B Daemon (queue)
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	63 .B \-q\fIINTERVAL
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	64
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	65 Run as daemon.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	66 Do regular queue runs at the specified time interval.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	67 This is normally used together with \fB\-bd\fR (see above).
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	68
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	69 An argument may be a time interval i.e. a numerical value followed by one
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	70 of the letters s,m,h,d,w which are interpreted as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	71 seconds, minutes, hours, days or weeks respectively.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	72 Example: \fB\-q30m\fR.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	73 Combinations like \fB\-q1h30m\fR, which sendmail accepts, are not possible.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	74
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	75 Alternatively single queue runs (\fB\-q\fR) can be started from cron.
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	76
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	77 .P
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	78 The queue processing mode has two flavors that may be
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	79 used in combination:
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	80
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	81 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	82 .B Single queue run (normal)
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	83 .B \-q
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	84 (without argument)
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	85 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	86 .B runq
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	87
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	88 Do a single queue run.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	89 Try to deliver all messages in the queue.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	90 Masqmail sends to addresses on the local host, on the local net,
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	91 and if it detects an online connection to remote ones too.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	92 That means, masqmail sends all queued mail it can.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	93 .B \-q
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	94 includes
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	95 .B \-qo
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	96 (without argument).
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	97
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	98 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	99 .B Single queue run (online)
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	100 .B \-qo \fR[\fB\fINAME\fR]
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	101
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	102 Do a single queue run and deliver only using one specific online route.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	103
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	104 If a connection name is given, then this one will be used.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	105
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	106 If no connection name is given, it will be determined with the configured
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	107 method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR) and,
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	108 if none is available no mail will be delivered.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	109
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	110 The specified route configuration is read and queued mail to matching
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	111 remote recipients will be sent.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	112 The \fINAME\fR is defined in the configuration
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	113 (see \fBonline_routes.\fINAME\fR).
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	114
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	115 You may want to use this option in scripts that run as soon as a link
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	116 to the internet has been set up (e.g. ip-up).
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	117
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	118 .P
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	119 The other modes are simple ones:
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	120
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	121 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	122 .B Rebuild alias database
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	123 .B \-bi
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	124 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	125 .B newaliases
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	126
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	127 A no-op for masqmail, just exit.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	128 Old sendmail rebuilds its alias database when invoked with this option.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	129 Masqmail reads directly from its alias file
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	130 (see config option `alias_file'),
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	131 thus no database needs to be updated.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	132
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	133 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	134 .B Accept messages
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	135 .BR \-bm ,
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	136 also the default mode
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	137
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	138 Accept a text message on stdin.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	139 This is the default mode of operation.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	140 One will hardly use this switch as it is the default.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	141
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	142 The command line options
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	143 .BR \-f , \-F , \-i / \-oi , \-t
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	144 are only used in this mode.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	145
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	146 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	147 .B Print queue
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	148 .B \-bp
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	149 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	150 .B mailq
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	151
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	152 Show the messages in the queue.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	153
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	154 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	155 .B Stand-alone SMTP server
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	156 .B \-bs
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	157
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	158 Act as SMTP server by reading commands from stdin
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	159 and writing to stdout.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	160 Some mailers (e.g. pine) use this option as an interface.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	161 It can also be used to call masqmail from inetd.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	162
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	163 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	164 .B Print version
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	165 .B \-bV
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	166 or if called without arguments
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	167
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	168 Print version information, then exit.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	169
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	170 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	171 .B Queue manipulation mode
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	172 .B \-Mrm
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	173 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	174 .B mailrm
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	175
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	176 Remove given messages from the queue.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	177 Privileged users may remove any message, other users only their own.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	178 The message identifiers are listed when printing the queue
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	179 (see \fB\-bp\fR).
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	180
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	181 .P
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	182 The default mode:
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	183 .P
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	184 When no mode had been specified by either one of the above command line
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	185 options or by calling masqmail under a special name,
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	186 then the default mode \fB\-bm\fR
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	187 (i.e. accept messages on stdin) is entered.
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	188 However, if neither address arguments are specified nor
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	189 \fB\-t\fR is given, then mail can not be sent,
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	190 hence something more useful is done: \fB\-bV\fP is assumed.
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	191
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	192
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	193 .SH OPTIONS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	194
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	195 Since masqmail is intended to replace sendmail,
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	196 it uses the same command line options,
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	197 but not all are implemented.
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	198 The \fB\-qo\fP option is additional, and unique to masqmail.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	199
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	200 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	201 \fB\-\-\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	202
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	203 Not a `real' option, it means that all following arguments are to be understood
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	204 as arguments and not as options even if they begin with a leading dash `\-'.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	205 Mutt is known to call sendmail with this option.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	206
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	207 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	208 \fB\-bd\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	209
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	210 ``Daemon (listen)'' mode. See above.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	211
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	212 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	213 \fB\-bi\fR
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	214
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	215 ``Rebuild alias database'' mode. See above.
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	216
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	217 .TP
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	218 .B \-bm
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	219
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	220 ``Accept message'' mode. See above.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	221
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	222 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	223 \fB\-bp\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	224
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	225 ``Print queue'' mode. See above.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	226
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	227 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	228 \fB\-bs\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	229
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	230 ``Stand-alone SMTP server'' mode. See above.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	231
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	232 .TP
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	233 \fB\-bV \fR
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	234
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	235 ``Print version'' mode. See above.
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	236
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	237 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	238 \fB\-B \fIarg\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	239
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	240 \fIarg\fR is usually 8BITMIME.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	241 Some mailers use this to indicate that the message contains characters > 127.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	242 Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm,
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	243 which is very painful ;-).
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	244 Note though that this violates some conventions:
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	245 masqmail does not convert 8 bit messages to any MIME format if it encounters
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	246 a mail server which does not advertise its 8BITMIME capability,
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	247 masqmail does not advertise this itself.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	248 This is the same practice as that of exim (but different to sendmail).
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	249
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	250 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	251 \fB\-C \fIfilename\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	252
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	253 Use another configuration than \fI/etc/masqmail/masqmail.conf\fR.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	254 Useful for debugging purposes.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	255 If not invoked by a privileged user, masqmail will drop all privileges.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	256
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	257 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	258 \fB\-d \fInumber\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	259
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	260 Set the debug level.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	261 This takes precedence before the value of `debug_level' in the configuration file.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	262 Read the warning in the description of the latter.
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	263 Only root may set the debug level.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	264
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	265 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	266 \fB\-f [\fIaddress\fB]\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	267
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	268 Set the return path address to \fIaddress\fR.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	269 Only root, the user mail and anyone in group mail is allowed to do that.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	270
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	271 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	272 \fB\-F [\fIstring\fB]\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	273
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	274 Set the full sender name (in the From: header) to \fIstring\fR.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	275
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	276 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	277 \fB\-i\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	278
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	279 Same as \fB\-oi\fR, see below.
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	280 Kept for compatibility.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	281
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	282 .TP
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	283 \fB\-Mrm \fImsgid...\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	284
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	285 ``Queue manipulation'' mode. See above.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	286
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	287 .TP
247 3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	288 \fB\-m\fR
3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	289
258 05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	290 ``Me too''
05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	291 This switch is ignored as,
05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	292 masqmail never excludes the sender from any alias expansions.
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	293
258 05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	294 \fB\-m\fP is an ancient alias for \fB\-om\fP.
05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	295 Kept for compatibility.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	296
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	297 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	298 \fB\-odb\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	299
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	300 ``Deliver in Background''
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	301 Masqmail always does this.
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	302 Hence masqmail ignores this switch.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	303
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	304 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	305 \fB\-odq\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	306
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	307 ``Do Queueing''
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	308 Do not attempt to deliver immediately.
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	309 Any messages will be queued until the next queue running process picks them
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	310 up and delivers them.
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	311 You get the same effect by setting the do_queue option in
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	312 /etc/masqmail/masqmail.conf.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	313
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	314 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	315 \fB\-oi\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	316
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	317 A dot as a single character in a line does not terminate the message.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	318
258 05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	319 The same as \fB\-i\fP.
247 3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	320
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	321 .TP
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	322 \fB\-oXXX\fR
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	323
258 05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	324 Any other switch starting with `\-o' is ignored.
05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	325 This especially affects \-om, \-oem, \-oee.
247 3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	326
3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	327 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	328 \fB\-q
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	329
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	330 ``Single queue run (normal)'' mode. See above.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	331
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	332 .TP
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	333 \fB\-q\fIINTERVAL
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	334
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	335 ``Daemon (queue)'' mode. See above.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	336
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	337 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	338 \fB\-qo [\fIname\fB]\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	339
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	340 ``Single queue run (online)'' mode. See above.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	341
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	342 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	343 \fB\-t\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	344
276 1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	345 Read recipients from mail headers and add them to the ones specified on the
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	346 command line.
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	347 (Only To:, Cc:, and Bcc: headers are regarded.)
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	348
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	349 .B WARNING: The behavior changed with version 0.3.1!
103 c85fbf7014b1 improved man page in respect to the -t option meillo@marmaro.de parents: 99 diff changeset	350
276 1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	351 In earlier versions command line argument addresses were ``substracted''
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	352 from header addresses.
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	353
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	354 The old behavior was similar to exim's and smail's
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	355 (which are anchesters of masqmail).
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	356 The new behavior is similar to the one of current postfix versions,
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	357 which add the arguments to the set of header recipients.
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	358 (Earlier postfix failed in case of address arguments with \-t.)
103 c85fbf7014b1 improved man page in respect to the -t option meillo@marmaro.de parents: 99 diff changeset	359 Sendmail seems to behave differently, depending on the version.
c85fbf7014b1 improved man page in respect to the -t option meillo@marmaro.de parents: 99 diff changeset	360 See exim(8) for further information.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	361
276 1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	362 For masqmail the most simple approach had been taken.
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	363
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	364 As the behavior of \-t together with command line address arguments
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	365 differs among MTAs, one better not steps into this corner case.
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted markus schnalke <meillo@marmaro.de> parents: 259 diff changeset	366
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	367 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	368 \fB\-v\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	369
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	370 ``Verbose''
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	371 Log also to stdout.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	372 Currently, some log messages are marked as `write to stdout' and additionally,
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	373 all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	374 if this option is given. It is disabled in daemon mode.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	375
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	376
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	377 .SH ENVIRONMENT FOR PIPES AND MDAS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	378
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	379 For security reasons, before any pipe command from an alias expansion or an mda is called,
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	380 the environment variables will be completely discarded and newly set up. These are:
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	381
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	382 SENDER, RETURN_PATH \(en the return path.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	383
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	384 SENDER_DOMAIN \(en the domain part of the return path.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	385
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	386 SENDER_LOCAL \(en the local part of the return path.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	387
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	388 RECEIVED_HOST \(en the host the message was received from (unless local).
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	389
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	390 LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	391
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	392 MESSAGE_ID \(en the unique message id.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	393 This is not necessarily identical with the Message ID as given in the Message ID: header.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	394
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	395 QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	396
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	397
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	398 .SH FILES
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	399
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	400 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	401 .I /etc/masqmail/masqmail.conf
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	402 The main configuration for masqmail.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	403 Depending on the settings in this file, you will also have other configuration
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	404 files in \fI/etc/masqmail/\fR.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	405
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	406 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	407 .I /var/spool/masqmail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	408 The spool directory where masqmail stores its queued mails.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	409
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	410 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	411 .I /var/spool/mail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	412 The directory where locally delivered mail will be put,
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	413 if not configured differently in \fImasqmail.conf\fR.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	414
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	415 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	416 .I /var/log/masqmail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	417 The directory where masqmail stores its log messages.
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	418
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	419 .P
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	420 Any of the paths can be configured at compile time,
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	421 and (except the main config file) also in the main config file.
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	422 The typical paths are different, depending on the Unix system you use.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	423
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	424
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	425 .SH CONFORMING TO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	426
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	427 RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	428
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	429 RFC 1321 (MD5)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	430
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	431 RFC 2195 (CRAM-MD5)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	432
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	433
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	434 .SH AUTHOR
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	435
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	436 Masqmail was written by Oliver Kurth.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	437 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	438
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	439 You will find the newest version of masqmail on its website:
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	440 .BR http://marmaro.de/prog/masqmail/ .
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	441 There is also a mailing list;
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	442 you will find information about it on the website.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	443
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	444
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	445 .SH BUGS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	446
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	447 Bug reports of any kind are very welcome.
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	448 They help masqmail to become better.
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	449 Please report bugs to the mailing list (anyone can post).
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	450
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	451
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	452 .SH SEE ALSO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	453
192 89f951be358f REMOVED POP3 SUPPORT meillo@marmaro.de parents: 174 diff changeset	454 \fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.aliases(5)\fR

Mercurial > masqmail

annotate man/masqmail.8 @ 286:e2f6eefbd573