view conf/doc/post.rf @ 0:bce86c4163a3

Initial revision
author kono
date Mon, 18 Apr 2005 23:46:02 +0900
parents
children 441a2190cfae
line wrap: on
line source

.\"	@(MHWARNING)
.\" @(#)$Id$
.SC POST 8
.NA
post \- deliver a message
.SY
@(MHETCPATH)/post 
\%[\-alias\ aliasfile]
\%[\-filter\ filterfile] \%[\-nofilter]
@BEGIN: TMA
\%[\-encrypt] \%[\-noencrypt] 
@END: TMA
\%[\-format] \%[\-noformat]
@BEGIN: MIME
\%[\-mime] \%[\-nomime]
@END: MIME
\%[\-msgid] \%[\-nomsgid]
\%[\-verbose] \%[\-noverbose]
\%[\-watch] \%[\-nowatch]
\%[\-width\ columns]
file
\%[\-help]
.DE
\fIPost\fR is the program called by \fIsend\fR\0(1)
to deliver the message in \fIfile\fR to local and remote users.
In fact, all of the functions attributed to \fIsend\fR
on its manual page are performed by \fIpost\fR,
with \fIsend\fR acting as a relatively simple preprocessor.
Thus, it is \fIpost\fR which parses the various header fields,
appends From: and Date: lines,
@BEGIN: MMDFMTS
and interacts with the \fIMMDF\fR transport system.
@END: MMDFMTS
@BEGIN: MHMTS
and delivers and/or queues the messages.
@END: MHMTS
@BEGIN: SENDMTS
and interacts with the \fISendMail\fR transport system.
@END: SENDMTS
\fIPost\fR will not normally be called directly by the user.

\fIPost\fR
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 `\-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 `\-width\ columns' switch can be used to indicate the preferred length
of the header components that contain addresses.

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 `\-filter\ filterfile' is specified,
then this copy is filtered (re\-formatted)
prior to being sent to the blind recipients.
@BEGIN: MIME
Otherwise,
to use the MIME rules for encapsulation,
specify the `\-mime' switch.
@END: MIME

The `\-alias\ 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 `\-alias'.
In any event,
the primary alias file is read first.

The `\-msgid' switch indicates that
a \*(lqMessage\-ID:\*(rq or \*(lqResent\-Message\-ID:\*(rq
field should be added to the header.

The `\-verbose' switch indicates that the user should be informed of each
step of the posting/filing process.

The `\-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).

\fIPost\fR consults the envariable \fB$SIGNATURE\fR to
determine the sender's personal name in constructing the \*(lqFrom:\*(rq line
of the message.
.Fi
^@(MHETCPATH)/mtstailor~^tailor file
^@(MHBINPATH)/refile~^Program to process Fcc:s
^@(MHETCPATH)/mhl~^Program to process Bcc:s
^@(MHETCPATH)/MailAliases~^Primary alias file
.Pr
\fIpost\fR does \fBNOT\fR consult the user's \&.mh\(ruprofile
.Sa
\fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822),
.br
mhmail(1), send(1), mh\-mail(5), mh\-alias(5)
.De
`\-alias @(MHETCPATH)/MailAliases'
@BEGIN: TMA
`\-noencrypt'
@END: TMA
.Ds
`\-format'
@BEGIN: MIME
.Ds
`\-nomime'
@END: MIME
.Ds
`\-nomsgid'
.Ds
`\-noverbose'
.Ds
`\-nowatch'
.Ds
`\-width\ 72'
.Ds
`\-nofilter'
.Co
None
.Bu
\*(lqReply\-To:\*(rq fields are allowed to have groups in them according to the
822 specification,
but \fIpost\fR won't let you use them.
.En