5dfa9af9838d1085c2f884f031c6a1faa85b5d2d
[mmh] / man / post.man
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH POST %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 post \- deliver a message
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B %libdir%/post 
11 .RB [ \-alias
12 .IR aliasfile ]
13 .RB [ \-filter
14 .IR filterfile ]
15 .RB [ \-nofilter ]
16 .RB [ \-format " | " \-noformat ]
17 .RB [ \-mime " | " \-nomime ]
18 .RB [ \-msgid " | " \-nomsgid ]
19 .RB [ \-verbose " | " \-noverbose ]
20 .RB [ \-watch " | " \-nowatch ]
21 .RB [ \-width
22 .IR columns ]
23 .RB [ \-server
24 .IR servername ]
25 .RB [ \-port
26 .IR portname/number ]
27 .RB [ \-sasl ]
28 .RB [ \-nosasl ]
29 .RB [ \-saslmaxssf
30 .IR ssf ]
31 .RB [ \-saslmech
32 .IR mechanism ]
33 .RB [ \-user
34 .IR username ]
35 .RB [ \-tls ]
36 .RB [ \-notls ]
37 .I file
38 .RB [ \-version ]
39 .RB [ \-help ]
40 .ad
41 .SH DESCRIPTION
42 .B Post
43 is the default program called by
44 .B send
45 to deliver
46 the message in
47 .I file
48 to local and remote users.  In fact, most of
49 the features attributed to
50 .B send
51 in its manual page are performed by
52 .BR post ,
53 with
54 .B send
55 acting as a relatively simple preprocessor.
56 Thus, it is
57 .B post
58 which parses the various header fields, appends a
59 \*(lqDate:\*(rq line, and interacts with the mail transport system.
60 .B Post
61 will not normally be called directly by the user.
62 .PP
63 .B Post
64 searches the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq,
65 \*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq header lines of the specified
66 message for destination addresses, checks these addresses for validity,
67 and formats them so as to conform to ARPAnet Internet Message Format
68 protocol, unless the
69 .B \-noformat
70 flag is set.  This will normally cause
71 \*(lq@\fIlocal\-site\fR\*(rq to be appended to each local destination
72 address, as well as any local return addresses.  The
73 .B \-width
74 .I columns
75 switch can be used to indicate the preferred length of the header
76 components that contain addresses.
77 .PP
78 If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
79 delivery, and the \*(lqBcc:\*(rq field will be removed from the message
80 sent to sighted recipients.  The blind recipients will receive an entirely
81 new message with a minimal set of headers.  Included in the body of the
82 message will be a copy of the message sent to the sighted recipients.
83 If
84 .B \-filter
85 .I filterfile
86 is specified, then this copy is filtered
87 (re\-formatted) by
88 .B mhl
89 prior to being sent to the blind recipients.
90 Alternately, if the
91 .B \-mime
92 switch is given, then
93 .B post
94 will use
95 the MIME rules for encapsulation.
96 .PP
97 The
98 .B \-alias
99 .I aliasfile
100 switch can be used to specify a file that post
101 should take aliases from.  More than one file can be specified, each
102 being preceded with
103 .BR \-alias .
104 In any event, the primary alias file is
105 read first.
106 .PP
107 The
108 .B \-msgid
109 switch indicates that a \*(lqMessage\-ID:\*(rq or
110 \*(lqResent\-Message\-ID:\*(rq field should be added to the header.
111 .PP
112 The
113 .B \-verbose
114 switch indicates that the user should be informed of
115 each step of the posting/filing process.
116 .PP
117 The
118 .B \-watch
119 switch indicates that the user would like to watch the
120 transport system's handling of the message (e.g., local and \*(lqfast\*(rq
121 delivery).
122 .PP
123 Under normal circumstances,
124 .B post
125 uses the \*(lqFrom:\*(rq line in the message draft as the identity of
126 the the originating mailbox.  A \*(lqFrom:\*(rq line is required in
127 all message draft.  By default the message composition utilities such
128 as
129 .BR comp ,
130 .B repl
131 and
132 .B mhmail
133 will automatically place a \*(lqFrom:\*(rq line in the message draft.
134 There are two ways to override this behavior, however.
135 Note that they apply equally to \*(lqResent\-From:\*(rq lines in messages sent
136 with
137 .BR dist .
138 .PP
139 The first way is to supply a \*(lqSender:\*(rq line.  The value of this
140 field will be used as the originating mailbox identity when submitting the
141 message to the mail transport system.  If multiple addresses are
142 given in the \*(lqFrom:\*(rq line, a \*(lqSender:\*(rq line is
143 .BR required .
144 If an \*(lqEnvelope-From:\*(rq line is supplied when multiple addresses
145 are given in the \*(lqFrom:\*(rq line, a \*(lqSender:\*(rq header will
146 be generated using the value of the \*(lqEnvelope-From:\*(rq line,
147 .B if
148 the \*(lqEnvelope-From:\*(rq line is not blank.
149 .PP
150 The second way is to supply a \*(lqEnvelope-From:\*(rq line.  The value
151 of this field will be used as the originating mailbox identity when
152 submitting the message to the mail transport system.  This will override
153 both the value of the \*(lqFrom:\*(rq line and a \*(lqSender:\*(rq line
154 (if one is supplied).  The \*(lqEnvelope-From:\*(rq line is allowed to
155 have a blank value; if the value is blank, then the mail transport system
156 will be instructed to not send any bounces in response to the message.
157 Not all mail transport systems support this feature.
158 .PP
159 If nmh is using the SMTP MTA, the
160 .B \-server
161 and the
162 .B \-port
163 switches can be used to override the default mail server (defined by the
164 .RI servers
165 entry in
166 .I %etcdir%/mts.conf
167 ).
168 .PP
169 If
170 .B nmh
171 has been compiled with SASL support, the
172 .B \-sasl
173 and
174 .B \-nosasl
175 switches will enable and disable
176 the use of SASL authentication with the SMTP MTA.  Depending on the
177 SASL mechanism used, this may require an additional password prompt from the
178 user (but the
179 .RI \*(lq \&.netrc \*(rq
180 file can be used to store this password).
181 .B \-saslmech
182 switch can be used to select a particular SASL mechanism,
183 and the the
184 .B \-user
185 switch can be used to select a authorization userid
186 to provide to SASL other than the default.
187 .PP
188 If SASL authentication is successful, 
189 .BR nmh
190 will attempt to negotiate a security layer for session encryption.
191 Encrypted data is labelled with `(sasl-encrypted)' and `(sasl-decrypted)' when
192 viewing the SMTP transaction with the
193 .B \-snoop
194 switch.  The
195 .B \-saslmaxssf
196 switch can be used to select the maximum value of the Security Strength Factor.
197 This is an integer value and the exact meaning of this value depends on the
198 underlying SASL mechanism.  A value of 0 disables encryption.
199 .PP
200 If
201 .B nmh
202 has been compiled with TLS support, the
203 .B \-tls
204 and
205 .B \-notls
206 switches will require and disable the negotiation of TLS support when
207 connecting to the
208 SMTP MTA.  Encrypted data is labelled with `(tls-encrypted)' and
209 `(tls-decrypted)' when viewing the SMTP transction with the
210 .B \-snoop
211 switch.
212
213 .SH FILES
214 .fc ^ ~
215 .nf
216 .ta \w'%etcdir%/ExtraBigFileName  'u
217 ^%etcdir%/mts.conf~^nmh mts configuration file
218 ^%etcdir%/MailAliases~^global nmh alias file
219 ^%bindir%/refile~^Program to process Fcc:s
220 ^%libdir%/mhl~^Program to process Bcc:s
221 .fi
222
223 .SH "PROFILE COMPONENTS"
224 .B post
225 does
226 .B NOT
227 consult the user's
228 .I \&.mh\(ruprofile
229
230 .SH "SEE ALSO"
231 mhmail(1), send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5),
232 .I "Standard for the Format of ARPA Internet Text Messages"
233 (RFC\-822)
234
235 .SH DEFAULTS
236 .nf
237 .RB ` \-alias "' defaults to %etcdir%/MailAliases"
238 .RB ` \-format '
239 .RB ` \-nomime '
240 .RB ` \-nomsgid '
241 .RB ` \-noverbose '
242 .RB ` \-nowatch '
243 .RB ` "\-width\ 72" '
244 .RB ` \-nofilter '
245 .fi
246
247 .SH CONTEXT
248 None
249
250 .SH BUGS
251 \*(lqReply\-To:\*(rq fields are allowed to have groups in them according
252 to the 822 specification, but
253 .B post
254 won't let you use them.