X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/64e8827c5d5def0325ab7181fe939623c77e807c..630af73cbbf6d7a883bb3011937ad5e87508d18b:/man/send.man diff --git a/man/send.man b/man/send.man index c83a74fe..2691c899 100644 --- a/man/send.man +++ b/man/send.man @@ -1,7 +1,7 @@ .\" .\" %nmhwarning% .\" -.TH SEND %manext1% "January 23, 2014" "%nmhversion%" +.TH SEND %manext1% "March 23, 2016" "%nmhversion%" .SH NAME send \- send a message .SH SYNOPSIS @@ -32,6 +32,8 @@ send \- send a message .RB [ \-watch " | " \-nowatch ] .RB [ \-mts .IR smtp " | " sendmail/smtp " | " sendmail/pipe ] +.RB [ \-sendmail +.IR program ] .RB [ \-server .IR servername ] .RB [ \-port @@ -42,6 +44,8 @@ send \- send a message .IR ssf ] .RB [ \-saslmech .IR mechanism ] +.RB [ \-authservice +.IR service ] .RB [ \-snoop ] .RB [ \-user .IR username ] @@ -156,6 +160,10 @@ Content-Description: VERSION Content-Disposition: attachment; filename="VERSION" .fi .PP +See +.IR mhbuild (1) +for explanation of how the Content-Disposition value is selected. +.PP If .B \-push is specified, @@ -358,23 +366,33 @@ switch, the user can direct as to how long it should make header lines containing addresses. .PP The mail transport system default is provided in -.I %etcdir%/mts.conf +.I %nmhetcdir%/mts.conf but can be overriiden here with the .B \-mts switch. .PP +If nmh is using as its mail transport system +.BR sendmail/pipe , +the +.B \-sendmail +switch can be used to override the default +.B sendmail +program. +.PP If nmh is using the SMTP MTA, the .B \-server and the .B \-port switches can be used to override the default mail server (defined by the -.I %etcdir%/mts.conf +.I %nmhetcdir%/mts.conf .RI servers entry). The .B \-snoop switch can be used to view the SMTP transaction. (Beware that the SMTP transaction may contain authentication information either in -plaintext or easily decoded base64.) +plaintext or easily decoded base64.) If +.B \-saslmech xoauth2 +is used, the HTTP transaction is also shown. .PP If .B nmh @@ -395,7 +413,7 @@ and the .B \-user switch can be used to select a authorization userid to provide to SASL other than the default. The credentials profile entry in the -mh_profile(5) man page describes the ways to supply a username and +mh\-profile(5) man page describes the ways to supply a username and password. .PP If SASL authentication is successful, @@ -412,6 +430,24 @@ underlying SASL mechanism. A value of 0 disables encryption. .PP If .B nmh +has been compiled with OAuth support, the +.B \-saslmech xoauth2 +switch will enable OAuth authentication. The +.B \-user +switch must be used, and the +.I user-name +must be an email address the user has for the service, which must +be specified with the +.B \-authservice +.I service +switch. Before using this, the user must authorize nmh by running +.B mhlogin +and grant authorization to that account. See the +.B mhlogin +man page for more details. +.PP +If +.B nmh has been compiled with TLS support, the .B \-tls and @@ -432,6 +468,12 @@ The .B \-notls switch will disable all attempts to negotiate TLS. .PP +If port 465 is specified and none of the TLS switches were enabled, +.B \-initialtls +will be implied if TLS support was compiled in. Though port 465 for +SMTPS (SMTP over SSL) was deregistered by IANA in 1998, it is still +used for that service. +.PP The files specified by the profile entry \*(lqAliasfile:\*(rq and any additional alias files given by the .B \-alias @@ -446,7 +488,7 @@ for more information. .SH FILES .fc ^ ~ .nf -.ta \w'%etcdir%/ExtraBigFileName 'u +.ta \w'%nmhetcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile .fi .SH "PROFILE COMPONENTS" @@ -466,7 +508,9 @@ for more information. .IR dist (1), .IR file (1), .IR forw (1), +.IR mhbuild (1), .IR mhparam (1), +.IR mhlogin (1), .IR repl (1), .IR whatnow (1), .IR mh\-alias (5), @@ -476,7 +520,7 @@ for more information. .SH DEFAULTS .nf .RB ` file "' defaults to /draft" -.RB ` \-alias "' defaults to %etcdir%/MailAliases" +.RB ` \-alias "' defaults to %nmhetcdir%/MailAliases" .RB ` \-nodraftfolder ' .RB ` \-nofilter ' .RB ` \-format '