]> diplodocus.org Git - nmh/commitdiff
Garbage collect the saslmaxssf flag, and update documentation for
authorKen Hornstein <kenh@pobox.com>
Fri, 23 Sep 2016 03:27:36 +0000 (23:27 -0400)
committerKen Hornstein <kenh@pobox.com>
Fri, 23 Sep 2016 03:27:36 +0000 (23:27 -0400)
new -initialtls flag and -notls flags for inc.

man/inc.man
man/post.man
man/send.man
man/whom.man
uip/inc.c
uip/send.c
uip/whatnowsbr.c

index b8a924546d9baac84c5bbc7939824d7273f3d49c..c6e56184a309453815b5bdec5e16ac9bd15c79b6 100644 (file)
@@ -39,6 +39,8 @@ inc \- incorporate new mail
 .IR mechanism ]
 .RB [ \-authservice
 .IR service ]
 .IR mechanism ]
 .RB [ \-authservice
 .IR service ]
+.RB [ \-initialtls ]
+.RB [ \-notls ]
 .RB [ \-snoop ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-snoop ]
 .RB [ \-version ]
 .RB [ \-help ]
@@ -276,8 +278,10 @@ for its other features.
 If
 .B nmh
 has been compiled with OAuth support, the
 If
 .B nmh
 has been compiled with OAuth support, the
+.B \-sasl
+and
 .B \-saslmech xoauth2
 .B \-saslmech xoauth2
-switch will enable OAuth authentication.  The
+switches will enable OAuth authentication.  The
 .B \-user
 switch must be used, and the
 .I user-name
 .B \-user
 switch must be used, and the
 .I user-name
@@ -291,10 +295,21 @@ and grant authorization to that account.  See the
 .B mhlogin
 man page for more details.
 .PP
 .B mhlogin
 man page for more details.
 .PP
-Gmail only supports POP3 over TLS, but
-.B inc
-has no TLS support.  To work around this, use something like
-.B -proxy 'openssl s_client -connect %h:995 -CAfile /etc/ssl/certs/ca-certificates.crt -quiet'
+If
+.B nmh
+has been compiled with TLS support, the
+.B \-initialtls
+switch will require the negotiation of TLS when connecting
+to the remote POP server.  The
+.B \-initialtls
+switch will negotiate TLS immediately after the connection has taken place,
+before any POP commands are sent or received.  Data encrypted by TLS is
+labeled `(tls-encrypted)' and `(tls-decrypted)` with viewing the POP
+transaction with the
+.B \-snoop
+switch.  The
+.B \-notls
+switch will disable all attempts to negotiate TLS.
 .SH FILES
 .PD 0
 .TP 20
 .SH FILES
 .PD 0
 .TP 20
index 1023676a8e494c9654b42d48542f33d32f0b2090..55d63b899db99e8fa0deb6c37f143bfb2c29eca4 100644 (file)
@@ -32,8 +32,6 @@ post \- deliver a message
 .IR portname/number ]
 .RB [ \-sasl ]
 .RB [ \-nosasl ]
 .IR portname/number ]
 .RB [ \-sasl ]
 .RB [ \-nosasl ]
-.RB [ \-saslmaxssf
-.IR ssf ]
 .RB [ \-saslmech
 .IR mechanism ]
 .RB [ \-user
 .RB [ \-saslmech
 .IR mechanism ]
 .RB [ \-user
@@ -236,11 +234,6 @@ switch.
 Base64-encoded data is wrapped with `b64<>'.
 (Beware that the SMTP transaction may contain authentication information either
 in plaintext or easily decoded base64.)
 Base64-encoded data is wrapped with `b64<>'.
 (Beware that the SMTP transaction may contain authentication information either
 in plaintext or easily decoded base64.)
-The
-.B \-saslmaxssf
-switch can be used to select the maximum value of the Security Strength Factor.
-This is an integer value and the exact meaning of this value depends on the
-underlying SASL mechanism.  A value of 0 disables encryption.
 .PP
 If
 .B nmh
 .PP
 If
 .B nmh
index 680f1d4656afa28dacd109450f7da57d84f97a61..5a2f31391631114b549bcf52f2be7ab164df777d 100644 (file)
@@ -40,8 +40,6 @@ send \- send a message
 .IR port-name/number ]
 .RB [ \-sasl ]
 .RB [ \-nosasl ]
 .IR port-name/number ]
 .RB [ \-sasl ]
 .RB [ \-nosasl ]
-.RB [ \-saslmaxssf
-.IR ssf ]
 .RB [ \-saslmech
 .IR mechanism ]
 .RB [ \-authservice
 .RB [ \-saslmech
 .IR mechanism ]
 .RB [ \-authservice
@@ -427,17 +425,14 @@ switch; see the
 man page description of
 .B \-snoop
 for its other features.
 man page description of
 .B \-snoop
 for its other features.
-The
-.B \-saslmaxssf
-switch can be used to select the maximum value of the Security Strength Factor.
-This is an integer value and the exact meaning of this value depends on the
-underlying SASL mechanism.  A value of 0 disables encryption.
 .PP
 If
 .B nmh
 has been compiled with OAuth support, the
 .PP
 If
 .B nmh
 has been compiled with OAuth support, the
+.B \-sasl
+and
 .B \-saslmech xoauth2
 .B \-saslmech xoauth2
-switch will enable OAuth authentication.  The
+switches will enable OAuth authentication.  The
 .B \-user
 switch must be used, and the
 .I user-name
 .B \-user
 switch must be used, and the
 .I user-name
@@ -448,7 +443,7 @@ be specified with the
 switch.  Before using this, the user must authorize nmh by running
 .B mhlogin
 and grant authorization to that account.  See the
 switch.  Before using this, the user must authorize nmh by running
 .B mhlogin
 and grant authorization to that account.  See the
-.B mhlogin
+.IR mhlogin (1)
 man page for more details.
 .PP
 If
 man page for more details.
 .PP
 If
index cbad25f5718608530c983fb42c2bdc62bc72a671..2e992e771f8a26b901c2142b7651e5f8d2416908 100644 (file)
@@ -29,6 +29,7 @@ whom \- report to whom a message would go
 .RB [ \-user
 .IR username ]
 .RB [ \-tls ]
 .RB [ \-user
 .IR username ]
 .RB [ \-tls ]
+.RB [ \-initialtls ]
 .RB [ \-notls ]
 .RI [ file ]
 .RB [ \-draft ]
 .RB [ \-notls ]
 .RI [ file ]
 .RB [ \-draft ]
@@ -106,16 +107,13 @@ switch; see the
 .B post
 man page description of
 .B \-snoop
 .B post
 man page description of
 .B \-snoop
-for its other features.  The
-.B \-saslmaxssf
-switch can be used to select the maximum value of the Security Strength Factor.
-This is an integer value and the exact meaning of this value depends on the
-underlying SASL mechanism.  A value of 0 disables encryption.
+for its other features.
 .PP
 If
 .B nmh
 has been compiled with TLS support, the
 .PP
 If
 .B nmh
 has been compiled with TLS support, the
-.B \-tls
+.BR \-tls ,
+.BR \-initialtls ,
 and
 .B \-notls
 switches will require and disable the negotiation of TLS support when connecting to the
 and
 .B \-notls
 switches will require and disable the negotiation of TLS support when connecting to the
@@ -126,7 +124,7 @@ switch; see the
 .B post
 man page description of
 .B \-snoop
 .B post
 man page description of
 .B \-snoop
-for its other features.
+and the TLS flags for more details.
 .PP
 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 additional alias files given by the
 .PP
 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 additional alias files given by the
index 61d7ea9b4d95ffb1fbeba14a8fe619ebd6f01678..565163cbb6823056b8570e978ba56c7cf2376dc6 100644 (file)
--- a/uip/inc.c
+++ b/uip/inc.c
@@ -80,7 +80,7 @@
     X("nosasl", SASLminc(3), NOSASLSW) \
     X("saslmech", SASLminc(5), SASLMECHSW) \
     X("initialtls", TLSminc(-10), INITTLSSW) \
     X("nosasl", SASLminc(3), NOSASLSW) \
     X("saslmech", SASLminc(5), SASLMECHSW) \
     X("initialtls", TLSminc(-10), INITTLSSW) \
-    X("noinitialtls", TLSminc(-12), NOINITTLSSW) \
+    X("notls", TLSminc(-12), NOTLSSW) \
     X("authservice", SASLminc(0), AUTHSERVICESW) \
     X("proxy command", 0, PROXYSW) \
 
     X("authservice", SASLminc(0), AUTHSERVICESW) \
     X("proxy command", 0, PROXYSW) \
 
@@ -366,7 +366,7 @@ main (int argc, char **argv)
                tls++;
                continue;
 
                tls++;
                continue;
 
-           case NOINITTLSSW:
+           case NOTTLSSW:
                tls = 0;
                continue;
 
                tls = 0;
                continue;
 
index 5dcdce0ef6ce88a42fa9ae5000403198be017054..4a6e0399cb2e9570918dc9d8f4a8964c80a44f07 100644 (file)
@@ -63,7 +63,6 @@
     X("snoop", 5, SNOOPSW) \
     X("sasl", SASLminc(4), SASLSW) \
     X("nosasl", SASLminc(6), NOSASLSW) \
     X("snoop", 5, SNOOPSW) \
     X("sasl", SASLminc(4), SASLSW) \
     X("nosasl", SASLminc(6), NOSASLSW) \
-    X("saslmaxssf", SASLminc(6), SASLMXSSFSW) \
     X("saslmech mechanism", SASLminc(6), SASLMECHSW) \
     X("authservice", SASLminc(0), AUTHSERVICESW) \
     X("user username", SASLminc(-4), USERSW) \
     X("saslmech mechanism", SASLminc(6), SASLMECHSW) \
     X("authservice", SASLminc(0), AUTHSERVICESW) \
     X("user username", SASLminc(-4), USERSW) \
@@ -287,7 +286,6 @@ main (int argc, char **argv)
                case WIDTHSW: 
                case CLIESW: 
                case SERVSW: 
                case WIDTHSW: 
                case CLIESW: 
                case SERVSW: 
-               case SASLMXSSFSW:
                case PORTSW:
                case MTSSM:
                case MTSSW:
                case PORTSW:
                case MTSSM:
                case MTSSW:
index 03c0bbba62002c53b5203a7f8ac213ba3ad0793f..8498f92cc4ab763407168351e7b72f7cbdbc7d55 100644 (file)
@@ -947,7 +947,6 @@ buildfile (char **argp, char *file)
     X("nodraftfolder", -3, SNDRFSW) \
     X("sasl", SASLminc(4), SASLSW) \
     X("nosasl", SASLminc(6), NOSASLSW) \
     X("nodraftfolder", -3, SNDRFSW) \
     X("sasl", SASLminc(4), SASLSW) \
     X("nosasl", SASLminc(6), NOSASLSW) \
-    X("saslmaxssf", SASLminc(10), SASLMXSSFSW) \
     X("saslmech", SASLminc(5), SASLMECHSW) \
     X("authservice", SASLminc(0), AUTHSERVICESW) \
     X("user username", SASLminc(4), USERSW) \
     X("saslmech", SASLminc(5), SASLMECHSW) \
     X("authservice", SASLminc(0), AUTHSERVICESW) \
     X("user username", SASLminc(4), USERSW) \
@@ -1165,7 +1164,6 @@ sendit (char *sp, char **arg, char *file, int pushed)
                case WIDTHSW:
                case CLIESW:
                case SERVSW:
                case WIDTHSW:
                case CLIESW:
                case SERVSW:
-               case SASLMXSSFSW:
                case USERSW:
                case PORTSW:
                case MTSSM:
                case USERSW:
                case PORTSW:
                case MTSSM: