X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fpost.man8;fp=man%2Fpost.man8;h=6c58c14e34aefdcce012fcdbcb9c51f4bfb00b3f;hb=5aaedc4256d58afe2481d667afdcb5162a914ba9;hp=0000000000000000000000000000000000000000;hpb=2676fdf95667cfa0fec45372dbb956c8645c1119;p=mmh diff --git a/man/post.man8 b/man/post.man8 new file mode 100644 index 0000000..6c58c14 --- /dev/null +++ b/man/post.man8 @@ -0,0 +1,223 @@ +.\" +.\" %nmhwarning% +.\" +.TH POST %manext8% "%nmhdate%" MH.6.8 [%nmhversion%] +.SH NAME +post \- deliver a message +.SH SYNOPSIS +.HP 5 +.na +.B %libdir%/post +.RB [ \-alias +.IR aliasfile ] +.RB [ \-filter +.IR filterfile ] +.RB [ \-nofilter ] +.RB [ \-format " | " \-noformat ] +.RB [ \-mime " | " \-nomime ] +.RB [ \-msgid " | " \-nomsgid ] +.RB [ \-verbose " | " \-noverbose ] +.RB [ \-watch " | " \-nowatch ] +.RB [ \-width +.IR columns ] +.I file +.RB [ \-version ] +.RB [ \-help ] +.ad +.SH DESCRIPTION +.B Post +is the default program called by +.B send +to deliver +the message in +.I file +to local and remote users. In fact, most of +the features attributed to +.B send +in its manual page are performed by +.BR post , +with +.B send +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. +.B Post +will not normally be called directly by the user. +.PP +.B Post +searches the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, +\*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq header lines of the specified +message for destination addresses, checks these addresses for validity, +and formats them so as to conform to ARPAnet Internet Message Format +protocol, unless the +.B \-noformat +flag is set. This will normally cause +\*(lq@\fIlocal\-site\fR\*(rq to be appended to each local destination +address, as well as any local return addresses. The +.B \-width +.I columns +switch can be used to indicate the preferred length of the header +components that contain addresses. +.PP +If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for +delivery, and the \*(lqBcc:\*(rq field will be removed from the message +sent to sighted recipients. The blind recipients will receive an entirely +new message with a minimal set of headers. Included in the body of the +message will be a copy of the message sent to the sighted recipients. +If +.B \-filter +.I filterfile +is specified, then this copy is filtered +(re\-formatted) by +.B mhl +prior to being sent to the blind recipients. +Alternately, if the +.B \-mime +switch is given, then +.B post +will use +the MIME rules for encapsulation. +.PP +The +.B \-alias +.I aliasfile +switch can be used to specify a file that post +should take aliases from. More than one file can be specified, each +being preceded with +.BR \-alias . +In any event, the primary alias file is +read first. \" TODO: clarify. What means ``primary''? +.PP +The +.B \-msgid +switch indicates that a \*(lqMessage\-ID:\*(rq or +\*(lqResent\-Message\-ID:\*(rq field should be added to the header. +.PP +The +.B \-verbose +switch indicates that the user should be informed of +each step of the posting/filing process. +.PP +The +.B \-watch +switch indicates that the user would like to watch the +transport system's handling of the message (e.g., local and \*(lqfast\*(rq +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. +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 +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. +.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 . +.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). +.PP +If nmh is using the SMTP MTA, the +.B \-server +and the +.B \-port +switches can be used to override the default mail server (defined by the +.RI servers +entry in +.I %etcdir%/mts.conf +). + +.SH FILES +.fc ^ ~ +.nf +.ta \w'%etcdir%/ExtraBigFileName 'u +^%etcdir%/mts.conf~^nmh mts configuration file +^%bindir%/refile~^Program to process Fcc:s +^%libdir%/mhl~^Program to process Bcc:s +.fi + +.SH "PROFILE COMPONENTS" +.B post +does +.B NOT +consult the user's profile. + +.SH "SEE ALSO" +mhmail(1), send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5), +.I "Standard for the Format of ARPA Internet Text Messages" +(RFC\-822) + +.SH DEFAULTS +.nf +.RB ` \-format ' +.RB ` \-nomime ' +.RB ` \-nomsgid ' +.RB ` \-noverbose ' +.RB ` \-nowatch ' +.RB ` "\-width\ 72" ' +.RB ` \-nofilter ' +.fi + +.SH CONTEXT +None + +.SH BUGS +\*(lqReply\-To:\*(rq fields are allowed to have groups in them according +to the 822 specification, but +.B post +won't let you use them.