X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fpost.man;h=bd048c0df717fa550e96bbe469eaca61c2c2bfcd;hb=9f8f8b1e1d553774865f2c177191c359c3dc652c;hp=f0ab42060a2a89c94b2fbab3904f092bf79f3395;hpb=537e02c38f4bb27e746ef51706d26fe40141c5a6;p=mmh diff --git a/man/post.man b/man/post.man index f0ab420..bd048c0 100644 --- a/man/post.man +++ b/man/post.man @@ -16,10 +16,14 @@ post \- deliver a message .RB [ \-format " | " \-noformat ] .RB [ \-mime " | " \-nomime ] .RB [ \-msgid " | " \-nomsgid ] +.RB [ \-messageid +.IR localname " | " random ] .RB [ \-verbose " | " \-noverbose ] .RB [ \-watch " | " \-nowatch ] .RB [ \-width .IR columns ] +.RB [ \-mts +.IR smtp " | " sendmail/smtp " | " sendmail/pipe ] .RB [ \-server .IR servername ] .RB [ \-port @@ -33,6 +37,7 @@ post \- deliver a message .RB [ \-user .IR username ] .RB [ \-tls ] +.RB [ \-notls ] .I file .RB [ \-version ] .RB [ \-help ] @@ -54,8 +59,8 @@ with acting as a relatively simple preprocessor. Thus, it is .B post -which parses the various header fields, appends -\*(lqFrom:\*(rq and \*(lqDate:\*(rq lines, and interacts with the mail transport system. +which parses the various header fields, appends a +\*(lqDate:\*(rq line, and interacts with the mail transport system. .B Post will not normally be called directly by the user. .PP @@ -109,6 +114,23 @@ switch indicates that a \*(lqMessage\-ID:\*(rq or \*(lqResent\-Message\-ID:\*(rq field should be added to the header. .PP The +.B \-messageid +switch selects the style used for the part appearing after the @ +in \*(lqMessage\-ID:\*(rq, \*(lqResent\-Message\-ID:\*(rq, and +\*(lqContent\-ID:\*(rq header fields. The two acceptable options are +.B localname +(which is the default), +and +.BR random . +With +.BR localname , +the local hostname is used. With +.BR random , +a random sequence of characters is used instead. Note that the +.B \-msgid +switch must be enabled for this switch to have any effect. +.PP +The .B \-verbose switch indicates that the user should be informed of each step of the posting/filing process. @@ -121,72 +143,45 @@ delivery). .PP Under normal circumstances, .B post -constructs the \*(lqFrom:\*(rq line of the -message from the user's login name, the full name from the GECOS field of the -passwd file, and the fully\-qualified name of the local machine (or the -value of -\*(lqlocalname\*(rq in -.IR mts.conf , -if set). An example is \*(lqFrom: Dan Harkless -\*(rq. There are four ways to override these values, -however. Note that they apply equally to \*(lqResent\-From:\*(rq lines in messages sent +uses the \*(lqFrom:\*(rq line in the message draft as the identity of +the the originating mailbox. A \*(lqFrom:\*(rq line is required in +all message draft. By default the message composition utilities such +as +.BR comp , +.B repl +and +.B mhmail +will automatically place a \*(lqFrom:\*(rq line in the message draft. +There are two ways to override this behavior, however. +Note that they apply equally to \*(lqResent\-From:\*(rq lines in messages sent with .BR dist . .PP -The first way is GECOS\-based username masquerading. If the \*(lqmasquerade:\*(rq line -in -.I mts.conf -contains \*(lqmmailid\*(rq, this processing is activated. If a user's GECOS -field in the passwd file is of the form \*(lqFull Name \*(rq then \*(lqfakename\*(rq -will be used in place of the real username. For instance, a GECOS field of \*(lqDan -Harkless \*(rq would result in \*(lqFrom: Dan Harkless -\*(rq. Naturally if you were doing something like -this you'd want to set up an MTA alias (e.g. in /etc/aliases) from, for -instance, \*(lqDan.Harkless\*(rq to \*(lqdan\*(rq. +The first way is to supply a \*(lqSender:\*(rq line. The value of this +field will be used as the originating mailbox identity when submitting the +message to the mail transport system. If multiple addresses are +given in the \*(lqFrom:\*(rq line, a \*(lqSender:\*(rq line is +.BR required . +If an \*(lqEnvelope-From:\*(rq line is supplied when multiple addresses +are given in the \*(lqFrom:\*(rq line, a \*(lqSender:\*(rq header will +be generated using the value of the \*(lqEnvelope-From:\*(rq line, +.B if +the \*(lqEnvelope-From:\*(rq line is not blank. .PP -The second way to override default construction of \*(lqFrom:\*(rq is to set the -.B $SIGNATURE -environment variable. This variable overrides the full name -from the GECOS field, even if GECOS\-based masquerading is being done. This -processing is always active, and does not need to be enabled from -.IR mts.conf . +The second way is to supply a \*(lqEnvelope-From:\*(rq line. The value +of this field will be used as the originating mailbox identity when +submitting the message to the mail transport system. This will override +both the value of the \*(lqFrom:\*(rq line and a \*(lqSender:\*(rq line +(if one is supplied). The \*(lqEnvelope-From:\*(rq line is allowed to +have a blank value; if the value is blank, then the mail transport system +will be instructed to not send any bounces in response to the message. +Not all mail transport systems support this feature. .PP -The third way is controlled by the \*(lquser_extension\*(rq value of \*(lqmasquerade:\*(rq line -of -.IR mts.conf . -When that's turned on, setting the -.B $USERNAME_EXTENSION -environment variable will result in its value being appended the user's login -name. For instance, if I set -.B $USERNAME_EXTENSION -to \*(lq+www\*(rq, my \*(lqFrom:\*(rq -line will contain \*(lqDan Harkless \*(rq (or -\*(lqDan.Harkless+www\*(rq if I'm using mmailid masquerading as well). Recent versions -of -.B sendmail -automatically deliver all mail sent to -.IR user + string -to -.IR user . -.B qmail -has a similar feature which uses '\-' as the delimiter by -default, but can use other characters as well. -.PP -The fourth method of address masquerading is to specify a \*(lqFrom:\*(rq line manually -in the message draft. It will be used as provided (after alias substitution), -but normally, to discourage email forgery, the user's -.B real -address will be -used in the SMTP envelope \*(lqFrom:\*(rq and in a \*(lqSender:\*(rq header. However, if the -\*(lqmasquerade:\*(rq line of -.I mts.conf -contains \*(lqdraft_from\*(rq, the SMTP envelope \*(lqFrom:\*(rq -will use the address given in the draft \*(lqFrom:\*(rq, and there will be no \*(lqSender:\*(rq -header. This is useful in pretending to send mail \*(lqdirectly\*(rq from a remote POP3 -account, or when remote email robots give improper precedence to the envelope -\*(lqFrom:\*(rq. Note that your MTA may still reveal your real identity (e.g. -.BR sendmail 's -\*(lqX\-Authentication\-Warning:\*(rq header). +The mail transport system default is provided in +.I %etcdir%/mts.conf +but can be overriiden here with the +.B \-mts +switch. .PP If nmh is using the SMTP MTA, the .B \-server @@ -233,7 +228,10 @@ If .B nmh has been compiled with TLS support, the .B \-tls -switch will require the negotiation of TLS support when connecting to the +and +.B \-notls +switches will require and disable the negotiation of TLS support when +connecting to the SMTP MTA. Encrypted data is labelled with `(tls-encrypted)' and `(tls-decrypted)' when viewing the SMTP transction with the .B \-snoop @@ -267,6 +265,7 @@ mhmail(1), send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5), .RB ` \-format ' .RB ` \-nomime ' .RB ` \-nomsgid ' +.RB ` "\-messageid\ localname" ' .RB ` \-noverbose ' .RB ` \-nowatch ' .RB ` "\-width\ 72" '