5 .TH POST %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
7 post \- deliver a message
16 .RB [ \-format " | " \-noformat ]
17 .RB [ \-mime " | " \-nomime ]
18 .RB [ \-msgid " | " \-nomsgid ]
19 .RB [ \-verbose " | " \-noverbose ]
20 .RB [ \-watch " | " \-nowatch ]
33 is the default program called by
38 to local and remote users. In fact, most of
39 the features attributed to
41 in its manual page are performed by
45 acting as a relatively simple preprocessor.
48 which parses the various header fields, appends
49 \*(lqFrom:\*(rq and \*(lqDate:\*(rq lines, and interacts with the mail transport system.
51 will not normally be called directly by the user.
54 searches the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq,
55 \*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq header lines of the specified
56 message for destination addresses, checks these addresses for validity,
57 and formats them so as to conform to ARPAnet Internet Message Format
60 flag is set. This will normally cause
61 \*(lq@\fIlocal\-site\fR\*(rq to be appended to each local destination
62 address, as well as any local return addresses. The
65 switch can be used to indicate the preferred length of the header
66 components that contain addresses.
68 If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
69 delivery, and the \*(lqBcc:\*(rq field will be removed from the message
70 sent to sighted recipients. The blind recipients will receive an entirely
71 new message with a minimal set of headers. Included in the body of the
72 message will be a copy of the message sent to the sighted recipients.
76 is specified, then this copy is filtered
79 prior to being sent to the blind recipients.
85 the MIME rules for encapsulation.
90 switch can be used to specify a file that post
91 should take aliases from. More than one file can be specified, each
94 In any event, the primary alias file is
99 switch indicates that a \*(lqMessage\-ID:\*(rq or
100 \*(lqResent\-Message\-ID:\*(rq field should be added to the header.
104 switch indicates that the user should be informed of
105 each step of the posting/filing process.
109 switch indicates that the user would like to watch the
110 transport system's handling of the message (e.g., local and \*(lqfast\*(rq
113 Under normal circumstances,
115 constructs the \*(lqFrom:\*(rq line of the
116 message from the user's login name, the full name from the GECOS field of the
117 passwd file, and the fully\-qualified name of the local machine (or the
119 \*(lqlocalname\*(rq in
121 if set). An example is \*(lqFrom: Dan Harkless
122 <dan@machine.company.com>\*(rq. There are four ways to override these values,
123 however. Note that they apply equally to \*(lqResent\-From:\*(rq lines in messages sent
127 The first way is GECOS\-based username masquerading. If the \*(lqmasquerade:\*(rq line
130 contains \*(lqmmailid\*(rq, this processing is activated. If a user's GECOS
131 field in the passwd file is of the form \*(lqFull Name <fakename>\*(rq then \*(lqfakename\*(rq
132 will be used in place of the real username. For instance, a GECOS field of \*(lqDan
133 Harkless <Dan.Harkless>\*(rq would result in \*(lqFrom: Dan Harkless
134 <Dan.Harkless@machine.company.com>\*(rq. Naturally if you were doing something like
135 this you'd want to set up an MTA alias (e.g. in /etc/aliases) from, for
136 instance, \*(lqDan.Harkless\*(rq to \*(lqdan\*(rq.
138 The second way to override default construction of \*(lqFrom:\*(rq is to set the
140 environment variable. This variable overrides the full name
141 from the GECOS field, even if GECOS\-based masquerading is being done. This
142 processing is always active, and does not need to be enabled from
145 The third way is controlled by the \*(lquser_extension\*(rq value of \*(lqmasquerade:\*(rq line
148 When that's turned on, setting the
149 .B $USERNAME_EXTENSION
150 environment variable will result in its value being appended the user's login
151 name. For instance, if I set
152 .B $USERNAME_EXTENSION
153 to \*(lq+www\*(rq, my \*(lqFrom:\*(rq
154 line will contain \*(lqDan Harkless <dan+www@machine.company.com>\*(rq (or
155 \*(lqDan.Harkless+www\*(rq if I'm using mmailid masquerading as well). Recent versions
158 automatically deliver all mail sent to
163 has a similar feature which uses '\-' as the delimiter by
164 default, but can use other characters as well.
166 The fourth method of address masquerading is to specify a \*(lqFrom:\*(rq line manually
167 in the message draft. It will be used as provided (after alias substitution),
168 but normally, to discourage email forgery, the user's
171 used in the SMTP envelope \*(lqFrom:\*(rq and in a \*(lqSender:\*(rq header. However, if the
172 \*(lqmasquerade:\*(rq line of
174 contains \*(lqdraft_from\*(rq, the SMTP envelope \*(lqFrom:\*(rq
175 will use the address given in the draft \*(lqFrom:\*(rq, and there will be no \*(lqSender:\*(rq
176 header. This is useful in pretending to send mail \*(lqdirectly\*(rq from a remote POP3
177 account, or when remote email robots give improper precedence to the envelope
178 \*(lqFrom:\*(rq. Note that your MTA may still reveal your real identity (e.g.
180 \*(lqX\-Authentication\-Warning:\*(rq header).
184 has been compiled with SASL support, the
187 the use of SASL authentication with the SMTP MTA. Depending on the
188 SASL mechanism used, this may require an additional password prompt from the
190 .RI \*(lq \&.netrc \*(rq
191 file can be used to store this password).
193 switch can be used to select a particular SASL mechanism,
196 switch can be used to select a authorization userid
197 to provide to SASL other than the default.
199 Currently SASL security layers are not supported for SMTP.
202 will always negotiate an unencrypted connection. This means that while the SMTP
203 authentication can be encrypted, the subsequent data stream can not. This is in
206 POP3 SASL support, where encryption is supported for both the
207 authentication and the data stream.
212 .ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
213 ^%etcdir%/mts.conf~^nmh mts configuration file
214 ^%etcdir%/MailAliases~^global nmh alias file
215 ^%bindir%/refile~^Program to process Fcc:s
216 ^%libdir%/mhl~^Program to process Bcc:s
219 .SH "PROFILE COMPONENTS"
227 mhmail(1), send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5),
228 .I "Standard for the Format of ARPA Internet Text Messages"
233 .RB ` \-alias "' defaults to %etcdir%/MailAliases"
239 .RB ` "\-width\ 72" '
247 \*(lqReply\-To:\*(rq fields are allowed to have groups in them according
248 to the 822 specification, but
250 won't let you use them.