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