masqmail: man/masqmail.8 annotate

annotate man/masqmail.8 @ 351:4c046561582a

Minor refactoring

author	markus schnalke <meillo@marmaro.de>
date	Thu, 14 Jul 2011 14:12:32 +0200
parents	1ca9bc4c6552
children	08932c629849

rev	line source
335 ef346dc67514 updated dates and version markus schnalke <meillo@marmaro.de> parents: 325 diff changeset	1 .TH masqmail 8 2011-08-27 masqmail-0.3.3 "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
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 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
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 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,
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	91 and to remote ones, if available online routes permit.
285 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.
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	93 Online detection is done with the configured
310 f10a56dc7481 reworked online_detect to the simpler online_query meillo@marmaro.de parents: 291 diff changeset	94 method (see \fBonline_query\fR in \fBmasqmail.conf(5)\fR).
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	95
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	96 .TP
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	97 .B Single queue run (only named route)
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	98 .BI \-qo\ NAME
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	99
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	100 Do a single queue run and deliver only using the specified online route.
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	101
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	102 The route configuration for \fINAME\fP is read and queued mail
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	103 to matching remote recipients is sent.
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	104 (See \fBonline_routes.\fINAME\fR in the main config file.)
285 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 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	107 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	108
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	109 .B Obsolete behavior:
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	110 Up to now: If
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	111 .B \-qo
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	112 has no argument, the online connection is determinded
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	113 by online detect and, if available, mail is sent through it.
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	114 If none is available no mail is delivered.
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	115
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	116 This behavior is likely to change in future versions
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	117 because it is included in \-q.
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	118 We could do something more useful instead.
792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	119
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	120 .P
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	121 The other modes are simple ones:
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	122
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	123 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	124 .B Rebuild alias database
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	125 .B \-bi
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	126 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	127 .B newaliases
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	128
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	129 A no-op for masqmail, just exit.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	130 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	131 Masqmail reads directly from its alias file
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	132 (see config option `alias_file'),
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	133 thus no database needs to be updated.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	134
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	135 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	136 .B Accept messages
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	137 .BR \-bm ,
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	138 also the default mode
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	139
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	140 Accept a text message on stdin.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	141 This is the default mode of operation.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	142 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	143
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	144 The command line options
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	145 .BR \-f , \-F , \-i / \-oi , \-t
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	146 are only used in this mode.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	147
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	148 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	149 .B Print queue
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	150 .B \-bp
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	151 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	152 .B mailq
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	153
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	154 Show the messages in the queue.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	155
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	156 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	157 .B Stand-alone SMTP server
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	158 .B \-bs
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	159
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	160 Act as SMTP server by reading commands from stdin
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	161 and writing to stdout.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	162 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	163 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	164
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	165 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	166 .B Print version
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	167 .B \-bV
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	168 or if called without arguments
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	169
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	170 Print version information, then exit.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	171
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	172 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	173 .B Queue manipulation mode
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	174 .B \-Mrm
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	175 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	176 .B mailrm
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	177
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	178 Remove given messages from the queue.
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	179 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	180 The message identifiers are listed when printing the queue
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	181 (see \fB\-bp\fR).
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	182
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	183 .P
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	184 The default mode:
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	185 .P
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	186 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	187 options or by calling masqmail under a special name,
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	188 then the default mode \fB\-bm\fR
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	189 (i.e. accept messages on stdin) is entered.
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	190 However, if neither address arguments are specified nor
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	191 \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	192 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	193
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	194
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	195 .SH OPTIONS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	196
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	197 Since masqmail is intended to replace sendmail,
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	198 it uses the same command line options,
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	199 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	200 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	201
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	202 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	203 \fB\-\-\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	204
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	205 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	206 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	207 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	208
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	209 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	210 \fB\-bd\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	211
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	212 ``Daemon (listen)'' mode. See above.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	213
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	214 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	215 \fB\-bi\fR
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	216
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	217 ``Rebuild alias database'' mode. See above.
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	218
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	219 .TP
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	220 .B \-bm
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	221
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	222 ``Accept message'' mode. See above.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	223
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	224 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	225 \fB\-bp\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	226
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	227 ``Print queue'' mode. See above.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	228
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	229 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	230 \fB\-bs\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	231
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	232 ``Stand-alone SMTP server'' mode. See above.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	233
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	234 .TP
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	235 \fB\-bV \fR
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	236
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	237 ``Print version'' mode. See above.
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	238
853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	239 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	240 \fB\-B \fIarg\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	241
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	242 \fIarg\fR is usually 8BITMIME.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	243 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	244 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	245 which is very painful ;-).
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	246 Note though that this violates some conventions:
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	247 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	248 a mail server which does not advertise its 8BITMIME capability,
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	249 masqmail does not advertise this itself.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	250 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	251
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	252 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	253 \fB\-C \fIfilename\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	254
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	255 Use another configuration than \fI/etc/masqmail/masqmail.conf\fR.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	256 Useful for debugging purposes.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	257 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	258
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	259 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	260 \fB\-d \fInumber\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	261
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	262 Set the debug level.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	263 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	264 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	265 Only root may set the debug level.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	266
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	267 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	268 \fB\-f [\fIaddress\fB]\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	269
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	270 Set the return path address to \fIaddress\fR.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	271 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	272
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	273 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	274 \fB\-F [\fIstring\fB]\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	275
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	276 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	277
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	278 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	279 \fB\-i\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	280
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	281 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	282 Kept for compatibility.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	283
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	284 .TP
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	285 \fB\-Mrm \fImsgid...\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	286
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	287 ``Queue manipulation'' mode. See above.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	288
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	289 .TP
247 3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	290 \fB\-m\fR
3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	291
258 05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	292 ``Me too''
05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	293 This switch is ignored as,
05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	294 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	295
258 05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	296 \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	297 Kept for compatibility.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	298
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	299 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	300 \fB\-odb\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	301
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	302 ``Deliver in Background''
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	303 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	304 Hence masqmail ignores this switch.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	305
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	306 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	307 \fB\-odq\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	308
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	309 ``Do Queueing''
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	310 Do not attempt to deliver immediately.
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	311 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	312 up and delivers them.
346 1ca9bc4c6552 Minor clarifications in man pages (do_queue) markus schnalke <meillo@marmaro.de> parents: 335 diff changeset	313 You get the same (but global) effect by setting the do_queue option in
283 853b85616c98 improved man/masqmail.8 heavily markus schnalke <meillo@marmaro.de> parents: 276 diff changeset	314 /etc/masqmail/masqmail.conf.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	315
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	316 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	317 \fB\-oi\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	318
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	319 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	320
258 05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	321 The same as \fB\-i\fP.
247 3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	322
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	323 .TP
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	324 \fB\-oXXX\fR
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	325
258 05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	326 Any other switch starting with `\-o' is ignored.
05fa719b7002 fixed -oem by removing it ;-) markus schnalke <meillo@marmaro.de> parents: 252 diff changeset	327 This especially affects \-om, \-oem, \-oee.
247 3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	328
3c40f86d50e4 ignoring -m switch now markus schnalke <meillo@marmaro.de> parents: 228 diff changeset	329 .TP
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	330 \fB\-q
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 ``Single queue run (normal)'' mode. See above.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	333
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	334 .TP
bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	335 \fB\-q\fIINTERVAL
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	336
285 bdcc2b42eb0f Heavily reworked man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 283 diff changeset	337 ``Daemon (queue)'' mode. See above.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	338
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	339 .TP
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	340 \fB\-qo \fIname
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	341
290 792e0201c1b3 mark -qo (without argument) obsolete markus schnalke <meillo@marmaro.de> parents: 286 diff changeset	342 ``Single queue run (only named route)'' mode. See above.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	343
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	344 .TP
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	345 \fB\-t\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	346
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	347 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	348 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	349 (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	350
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 .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	352
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	353 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	354 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	355
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 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	357 (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	358 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	359 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	360 (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	361 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	362 See exim(8) for further information.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	363
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	364 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	365
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 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	367 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	368
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	369 .TP
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	370 \fB\-v\fR
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	371
252 1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem markus schnalke <meillo@marmaro.de> parents: 247 diff changeset	372 ``Verbose''
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	373 Log also to stdout.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	374 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	375 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	376 if this option is given. It is disabled in daemon mode.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	377
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	378
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	379 .SH ENVIRONMENT FOR PIPES AND MDAS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	380
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	381 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	382 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	383
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	384 SENDER, RETURN_PATH \(en the return path.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	385
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	386 SENDER_DOMAIN \(en the domain part of the return path.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	387
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	388 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	389
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	390 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	391
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	392 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	393
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	394 MESSAGE_ID \(en the unique message id.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	395 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	396
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	397 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	398
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	399
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	400 .SH FILES
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	401
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	402 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	403 .I /etc/masqmail/masqmail.conf
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	404 The main configuration for masqmail.
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	405 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	406 files in \fI/etc/masqmail/\fR.
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	407
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	408 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	409 .I /var/spool/masqmail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	410 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	411
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	412 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	413 .I /var/spool/mail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	414 The directory where locally delivered mail will be put,
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	415 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	416
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	417 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	418 .I /var/log/masqmail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	419 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	420
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	421 .P
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	422 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	423 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	424 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	425
0 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 .SH CONFORMING TO
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 821, 822, 1869, 1870, 2197, 2554 (SMTP)
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 1321 (MD5)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	432
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	433 RFC 2195 (CRAM-MD5)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	434
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	435
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	436 .SH AUTHOR
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	437
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	438 Masqmail was written by Oliver Kurth.
8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	439 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	440
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	441 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	442 .BR http://marmaro.de/prog/masqmail/ .
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	443 There is also a mailing list;
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	444 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	445
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	446
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	447 .SH BUGS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	448
286 e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	449 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	450 They help masqmail to become better.
e2f6eefbd573 further, minor, improvements to man/masqmail.8 markus schnalke <meillo@marmaro.de> parents: 285 diff changeset	451 Please report bugs to the mailing list (anyone can post).
34 8ea86ac25658 reformating of man page sources meillo@marmaro.de parents: 26 diff changeset	452
0 08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	453
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	454 .SH SEE ALSO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth meillo@marmaro.de parents: diff changeset	455
192 89f951be358f REMOVED POP3 SUPPORT meillo@marmaro.de parents: 174 diff changeset	456 \fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.aliases(5)\fR

Mercurial > masqmail

annotate man/masqmail.8 @ 351:4c046561582a