5084ec451f6e9c978356ab144e7ab0b528b99bf5
[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 .B comp
130 and
131 .B repl
132 will automatically place a \*(lqFrom:\*(rq line in the message draft.
133 There are two ways to override this behavior, however.
134 Note that they apply equally to \*(lqResent\-From:\*(rq lines in messages sent
135 with
136 .BR dist .
137 .PP
138 The first way is to supply a \*(lqSender:\*(rq line.  The value of this
139 field will be used as the originating mailbox identity when submitting the
140 message to the mail transport system.  If multiple addresses are
141 given in the \*(lqFrom:\*(rq line, a \*(lqSender:\*(rq line is
142 .BR required .
143 If an \*(lqEnvelope-From:\*(rq line is supplied when multiple addresses
144 are given in the \*(lqFrom:\*(rq line, a \*(lqSender:\*(rq header will
145 be generated using the value of the \*(lqEnvelope-From:\*(rq line,
146 .B if
147 the \*(lqEnvelope-From:\*(rq line is not blank.
148 .PP
149 The second way is to supply a \*(lqEnvelope-From:\*(rq line.  The value
150 of this field will be used as the originating mailbox identity when
151 submitting the message to the mail transport system.  This will override
152 both the value of the \*(lqFrom:\*(rq line and a \*(lqSender:\*(rq line
153 (if one is supplied).  The \*(lqEnvelope-From:\*(rq line is allowed to
154 have a blank value; if the value is blank, then the mail transport system
155 will be instructed to not send any bounces in response to the message.
156 Not all mail transport systems support this feature.
157 .PP
158 If nmh is using the SMTP MTA, the
159 .B \-server
160 and the
161 .B \-port
162 switches can be used to override the default mail server (defined by the
163 .RI servers
164 entry in
165 .I %etcdir%/mts.conf
166 ).
167 .PP
168 If
169 .B nmh
170 has been compiled with SASL support, the
171 .B \-sasl
172 and
173 .B \-nosasl
174 switches will enable and disable
175 the use of SASL authentication with the SMTP MTA.  Depending on the
176 SASL mechanism used, this may require an additional password prompt from the
177 user (but the
178 .RI \*(lq \&.netrc \*(rq
179 file can be used to store this password).
180 .B \-saslmech
181 switch can be used to select a particular SASL mechanism,
182 and the the
183 .B \-user
184 switch can be used to select a authorization userid
185 to provide to SASL other than the default.
186 .PP
187 If SASL authentication is successful, 
188 .BR nmh
189 will attempt to negotiate a security layer for session encryption.
190 Encrypted data is labelled with `(sasl-encrypted)' and `(sasl-decrypted)' when
191 viewing the SMTP transaction with the
192 .B \-snoop
193 switch.  The
194 .B \-saslmaxssf
195 switch can be used to select the maximum value of the Security Strength Factor.
196 This is an integer value and the exact meaning of this value depends on the
197 underlying SASL mechanism.  A value of 0 disables encryption.
198 .PP
199 If
200 .B nmh
201 has been compiled with TLS support, the
202 .B \-tls
203 and
204 .B \-notls
205 switches will require and disable the negotiation of TLS support when
206 connecting to the
207 SMTP MTA.  Encrypted data is labelled with `(tls-encrypted)' and
208 `(tls-decrypted)' when viewing the SMTP transction with the
209 .B \-snoop
210 switch.
211
212 .SH FILES
213 .fc ^ ~
214 .nf
215 .ta \w'%etcdir%/ExtraBigFileName  'u
216 ^%etcdir%/mts.conf~^nmh mts configuration file
217 ^%etcdir%/MailAliases~^global nmh alias file
218 ^%bindir%/refile~^Program to process Fcc:s
219 ^%libdir%/mhl~^Program to process Bcc:s
220 .fi
221
222 .SH "PROFILE COMPONENTS"
223 .B post
224 does
225 .B NOT
226 consult the user's
227 .I \&.mh\(ruprofile
228
229 .SH "SEE ALSO"
230 mhmail(1), send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5),
231 .I "Standard for the Format of ARPA Internet Text Messages"
232 (RFC\-822)
233
234 .SH DEFAULTS
235 .nf
236 .RB ` \-alias "' defaults to %etcdir%/MailAliases"
237 .RB ` \-format '
238 .RB ` \-nomime '
239 .RB ` \-nomsgid '
240 .RB ` \-noverbose '
241 .RB ` \-nowatch '
242 .RB ` "\-width\ 72" '
243 .RB ` \-nofilter '
244 .fi
245
246 .SH CONTEXT
247 None
248
249 .SH BUGS
250 \*(lqReply\-To:\*(rq fields are allowed to have groups in them according
251 to the 822 specification, but
252 .B post
253 won't let you use them.