4 .TH SEND %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
16 .RB [ \-format " | " \-noformat ]
17 .RB [ \-forward " | " \-noforward ]
18 .RB [ \-mime " | " \-nomime ]
19 .RB [ \-msgid " | " \-nomsgid ]
20 .RB [ \-push " | " \-nopush ]
21 .RB [ \-verbose " | " \-noverbose ]
22 .RB [ \-watch " | " \-nowatch ]
26 .IR port-name/number ]
34 .IR header-field-name ]
36 .IR 0 " | " 1 " | " 2 ]
40 will cause each of the specified messages to be delivered
41 to each of the destinations in the \*(lqTo:\*(rq, \*(lqCc:\*(rq,
42 \*(lqBcc:\*(rq, \*(lqDcc:\*(rq, and \*(lqFcc:\*(rq fields of the message. If
44 is re\-distributing a message, as invoked from
47 corresponding \*(lqResent\-xxx\*(rq fields are examined instead.
54 delivery of the messages, although this can be changed by defining the
56 profile component. Most of the features attributed to
58 are actually performed by
66 option, the draft is scanned for a header whose field name matches the
68 .IR header-field-name .
69 The draft is converted to a MIME message if one or more matches are found.
70 This conversion occurs before all other processing.
72 The first part of the MIME message is the draft body if that body contains
73 any non-blank characters.
74 The body of each header field whose name matches the
76 is interpreted as a file name, and each file named is included as a separate
77 part in the MIME message.
79 For file names with dot suffixes, the context is scanned for a
81 entry for that suffix.
82 The content-type for the part is taken from that context entry if a match is
84 If no match is found or the file does not have a dot suffix, the content-type
85 is text/plain if the file contains only ASCII characters or application/octet-stream
86 if it contains characters outside of the ASCII range.
88 Each part contains a name attribute that is the last component of the path name.
91 attribute containing the file mode accompanies each part.
92 Finally, a description attribute is generated by running the
98 option specifies the MIME header field formats: a value of
103 attribute as noted above. A value of
105 suppresses both that and the \*(lqContent-Description\*(rq header, and
106 adds a \*(lqContent-Disposition\*(rq header. A value of
110 parameter to the \*(lqContent-Disposition\*(rq header. You can
111 specify one value in your profile, and override it for individual
116 Here are example message part headers, for an attachment, for each of the
122 Content-Type: text/plain; name="VERSION"; x-unix-mode="0644";
124 Content-Description: ASCII text
127 Content-Type: text/plain; name="VERSION"; charset="us-ascii"
128 Content-Disposition: attachment; filename="VERSION"
131 Content-Type: text/plain; name="VERSION"; charset="us-ascii"
132 Content-Disposition: attachment; filename="VERSION"; modification-date="Mon, 19 Dec 2005 22:39:51 -0600"
139 will detach itself from the user's
140 terminal and perform its actions in the background. If
142 and the draft can't be sent, then an error message will be sent (using
143 the mailproc) back to the user. If
145 is given, then a copy
146 of the draft will be attached to this failure notice. Using
150 in the background because the output is
151 trapped and analyzed by
158 will indicate the interactions
159 occurring with the transport system, prior to actual delivery.
164 will monitor the delivery of local
165 and network mail. Hence, by specifying both switches, a large detail
166 of information can be gathered about each step of the message's entry
167 into the transport system.
172 argument will send the current message in the draft folder.
174 always takes messages from the draft folder.
177 argument might be added in the future.)
180 man page for more information.
182 Once the transport system has successfully accepted custody of the
183 message, the message will be renamed with a leading comma, which allows
184 it to be retrieved until the next draft message is sent. If there are
185 errors in the formatting of the message,
188 (hopefully) helpful error message.
190 If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
191 delivery, and the \*(lqBcc:\*(rq field will be removed from the message
192 sent to sighted recipients. The blind recipients will receive an entirely
193 new message with a minimal set of headers. Included in the body of the
194 message will be a copy of the message sent to the sighted recipients.
196 If a \*(lqDcc:\*(rq field is encountered, its addresses will be used for
197 delivery, and the \*(lqDcc:\*(rq field will be removed from the message. The
198 blind recipients will receive the same message sent to the sighted
199 recipients. *WARNING* Recipients listed in the \*(lqDcc:\*(rq field receive no
200 explicit indication that they have received a \*(lqblind copy\*(rq.
201 This can cause blind recipients to
202 inadvertently reply to all of the sighted recipients of the
203 original message, revealing that they received a blind copy.
204 On the other hand, since a normal reply to a message sent
205 via a \*(lqBcc:\*(rq field
206 will generate a reply only to the sender of the original message,
207 it takes extra effort in most mailers to reply to the included
208 message, and so would usually only be done deliberately, rather
214 is specified, then this copy is filtered
217 prior to being sent to the blind recipients.
218 Alternately, if you specify the
223 use the MIME rules for encapsulation.
225 Prior to sending the message, the fields \*(lqFrom:\ user@local\*(rq,
226 and \*(lqDate:\ now\*(rq will be appended to the headers in the message.
227 If the environment variable
229 is set, then its value
230 is used as your personal name when constructing the \*(lqFrom:\*(rq
231 line of the message. If this environment variable is not set, then
233 will consult the profile entry \*(lqSignature\*(rq for
237 is specified, then a \*(lqMessage\-ID:\*(rq field will also
238 be added to the message.
242 is re\-distributing a message (when invoked by
244 then \*(lqResent\-\*(rq will be prepended to each of these
245 fields: \*(lqFrom:\*(rq, \*(lqDate:\*(rq, and \*(lqMessage\-ID:\*(rq.
246 If the message already contains a \*(lqFrom:\*(rq field, then a
247 \*(lqSender: user@local\*(rq field will be added as well. (An already
248 existing \*(lqSender:\*(rq field is an error!)
252 switch, each of the entries in the \*(lqTo:\*(rq
253 and \*(lqCc:\*(rq fields will be replaced with \*(lqstandard\*(rq
254 format entries. This standard format is designed to be usable by all
255 of the message handlers on the various systems around the Internet.
258 is given, then headers are output exactly as they appear
259 in the message draft.
261 If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied
262 to the specified folder for the sender in the format in which it will
263 appear to any non\-Bcc receivers of the message. That is, it will have
264 the appended fields and field reformatting. The \*(lqFcc:\*(rq fields
265 will be removed from all outgoing copies of the message.
270 switch, the user can direct
272 as to how long it should make header lines containing addresses.
274 If nmh is using the SMTP MTA, the
278 switches can be used to override the default mail server (defined by the
284 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
285 additional alias files given by the
289 read (more than one file, each preceded by
294 for more information.
299 .ta \w'%etcdir%/ExtraBigFileName 'u
300 ^$HOME/.mmh/profile~^The user profile
301 ^+drafts~^The draft folder
304 .SH "PROFILE COMPONENTS"
308 .ta \w'ExtraBigProfileName 'u
309 ^Path:~^To determine the user's mail storage
310 ^Draft\-Folder:~^To set the default draft\-folder
311 ^Aliasfile:~^For a default alias file
312 ^Signature:~^To determine the user's mail signature
313 ^mailproc:~^Program to post failure notices
314 ^postproc:~^Program to post the message
318 comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
322 .RB ` msg "' defaults to the current message in the draft folder"
331 .RB ` "\-width\ 72" '
332 .RB ` "\-attachformat\ 0" '
339 Under some configurations, it is not possible to monitor the mail delivery
342 is a no-op on those systems.