1 .TH POST %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
6 post \- deliver a message
16 .RB [ \-format " | " \-noformat ]
17 .RB [ \-mime " | " \-nomime ]
18 .RB [ \-msgid " | " \-nomsgid ]
20 .IR localname " | " random ]
21 .RB [ \-verbose " | " \-noverbose ]
22 .RB [ \-watch " | " \-nowatch ]
26 .IR smtp " | " sendmail/smtp " | " sendmail/pipe ]
47 is the default program called by
52 to local and remote users. In fact, most of
53 the features attributed to
55 in its manual page are performed by
59 acting as a relatively simple preprocessor.
62 which parses the various header fields, appends a
63 \*(lqDate:\*(rq line, and interacts with the mail transport system.
65 will not normally be called directly by the user.
68 searches the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq,
69 \*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq header lines of the specified
70 message for destination addresses, checks these addresses for validity,
71 and formats them so as to conform to ARPAnet Internet Message Format
74 flag is set. This will normally cause
75 \*(lq@\fIlocal\-site\fR\*(rq to be appended to each local destination
76 address, as well as any local return addresses. The
79 switch can be used to indicate the preferred length of the header
80 components that contain addresses.
82 If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
83 delivery, and the \*(lqBcc:\*(rq field will be removed from the message
84 sent to sighted recipients. The blind recipients will receive an entirely
85 new message with a minimal set of headers. Included in the body of the
86 message will be a copy of the message sent to the sighted recipients.
90 is specified, then this copy is filtered
93 prior to being sent to the blind recipients.
99 the MIME rules for encapsulation.
104 switch can be used to specify a file that post
105 should take aliases from. More than one file can be specified, each
108 In any event, the primary alias file is
113 switch indicates that a \*(lqMessage\-ID:\*(rq or
114 \*(lqResent\-Message\-ID:\*(rq field should be added to the header.
118 switch selects the style used for the part appearing after the @
119 in \*(lqMessage\-ID:\*(rq, \*(lqResent\-Message\-ID:\*(rq, and
120 \*(lqContent\-ID:\*(rq header fields. The two acceptable options are
122 (which is the default),
127 the local hostname is used. With
129 a random sequence of characters is used instead. Note that the
131 switch must be enabled for this switch to have any effect.
135 switch indicates that the user should be informed of
136 each step of the posting/filing process.
140 switch indicates that the user would like to watch the
141 transport system's handling of the message (e.g., local and \*(lqfast\*(rq
144 Under normal circumstances,
146 uses the \*(lqFrom:\*(rq line in the message draft as the identity of
147 the the originating mailbox. A \*(lqFrom:\*(rq line is required in
148 all message draft. By default the message composition utilities such
154 will automatically place a \*(lqFrom:\*(rq line in the message draft.
155 There are two ways to override this behavior, however.
156 Note that they apply equally to \*(lqResent\-From:\*(rq lines in messages sent
160 The first way is to supply a \*(lqSender:\*(rq line. The value of this
161 field will be used as the originating mailbox identity when submitting the
162 message to the mail transport system. If multiple addresses are
163 given in the \*(lqFrom:\*(rq line, a \*(lqSender:\*(rq line is
165 If an \*(lqEnvelope-From:\*(rq line is supplied when multiple addresses
166 are given in the \*(lqFrom:\*(rq line, a \*(lqSender:\*(rq header will
167 be generated using the value of the \*(lqEnvelope-From:\*(rq line,
169 the \*(lqEnvelope-From:\*(rq line is not blank.
171 The second way is to supply a \*(lqEnvelope-From:\*(rq line. The value
172 of this field will be used as the originating mailbox identity when
173 submitting the message to the mail transport system. This will override
174 both the value of the \*(lqFrom:\*(rq line and a \*(lqSender:\*(rq line
175 (if one is supplied). The \*(lqEnvelope-From:\*(rq line is allowed to
176 have a blank value; if the value is blank, then the mail transport system
177 will be instructed to not send any bounces in response to the message.
178 Not all mail transport systems support this feature.
180 The mail transport system default is provided in
182 but can be overriiden here with the
186 If nmh is using the SMTP MTA, the
190 switches can be used to override the default mail server (defined by the
198 has been compiled with SASL support, the
202 switches will enable and disable
203 the use of SASL authentication with the SMTP MTA. Depending on the
204 SASL mechanism used, this may require an additional password prompt from the
206 .RI \*(lq \&.netrc \*(rq
207 file can be used to store this password).
209 switch can be used to select a particular SASL mechanism,
212 switch can be used to select a authorization userid
213 to provide to SASL other than the default.
215 If SASL authentication is successful,
217 will attempt to negotiate a security layer for session encryption.
218 Encrypted data is labelled with `(sasl-encrypted)' and `(sasl-decrypted)' when
219 viewing the SMTP transaction with the
223 switch can be used to select the maximum value of the Security Strength Factor.
224 This is an integer value and the exact meaning of this value depends on the
225 underlying SASL mechanism. A value of 0 disables encryption.
229 has been compiled with TLS support, the
233 switches will require and disable the negotiation of TLS support when
235 SMTP MTA. Encrypted data is labelled with `(tls-encrypted)' and
236 `(tls-decrypted)' when viewing the SMTP transction with the
242 .ta \w'%etcdir%/ExtraBigFileName 'u
243 ^%etcdir%/mts.conf~^nmh mts configuration file
244 ^%etcdir%/MailAliases~^global nmh alias file
245 ^%bindir%/refile~^Program to process Fcc:s
246 ^%libdir%/mhl~^Program to process Bcc:s
248 .SH "PROFILE COMPONENTS"
255 mhmail(1), send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5),
256 .I "Standard for the Format of ARPA Internet Text Messages"
260 .RB ` \-alias "' defaults to %etcdir%/MailAliases"
264 .RB ` "\-messageid\ localname" '
267 .RB ` "\-width\ 72" '
273 \*(lqReply\-To:\*(rq fields are allowed to have groups in them according
274 to the 822 specification, but
276 won't let you use them.