components/openssl/openssl-1.0.1/patches/42_rm_sslv2.patch
author jenny.yung@oracle.com <jenny.yung@oracle.com>
Thu, 02 Jul 2015 15:29:20 -0700
branchs11-update
changeset 4589 13498d090b19
parent 4414 bcb5766d82d0
child 5557 0c86123e6de4
permissions -rw-r--r--
21274628 python/cryptography doesn't build on s12-76
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
4414
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     1
#
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     2
# This was developed in house.  Not applicable to the upstream.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     3
#
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     4
--- openssl-1.0.1/ssl/s2_meth.c      Fri May  8 09:38:33 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     5
+++ openssl-1.0.1/ssl/s2_meth.c.new       Fri May  8 09:51:53 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     6
@@ -74,6 +74,13 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     7
                          ssl2_accept, ssl2_connect, ssl2_get_method)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     8
 #else                           /* !OPENSSL_NO_SSL2 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
     9
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    10
+/* stub function */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    11
+const SSL_METHOD *
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    12
+SSLv2_method(void)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    13
+{
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    14
+       return (NULL);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    15
+}
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    16
+
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    17
 # if PEDANTIC
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    18
 static void *dummy = &dummy;
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    19
 # endif
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    20
--- openssl-1.0.1/ssl/s2_clnt.c      Fri May  8 09:37:51 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    21
+++ openssl-1.0.1/ssl/ss2_clnt.c.new       Fri May  8 09:53:12 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    22
@@ -1087,6 +1087,13 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    23
 }
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    24
 #else                           /* !OPENSSL_NO_SSL2 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    25
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    26
+/* stub function */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    27
+const SSL_METHOD *
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    28
+SSLv2_client_method(void)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    29
+{
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    30
+       return (NULL);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    31
+}
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    32
+
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    33
 # if PEDANTIC
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    34
 static void *dummy = &dummy;
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    35
 # endif
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    36
--- openssl-1.0.1/ssl/s2_srvr.c      Fri May  8 09:38:02 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    37
+++ openssl-1.0.1/ssl/s2_srvr.c.new       Fri May  8 09:53:43 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    38
@@ -1150,6 +1150,13 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    39
 }
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    40
 #else                           /* !OPENSSL_NO_SSL2 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    41
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    42
+/* stub function */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    43
+const SSL_METHOD *
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    44
+SSLv2_server_method(void)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    45
+{
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    46
+        return (NULL);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    47
+}
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    48
+
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    49
 # if PEDANTIC
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    50
 static void *dummy = &dummy;
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    51
 # endif
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    52
--- openssl-1.0.1/ssl/ssl.h	Tue May 26 11:13:15 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    53
+++ openssl-1.0.1/ssl/ssl.h.new	Tue May 26 11:32:09 2015
4589
13498d090b19 21274628 python/cryptography doesn't build on s12-76
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents: 4414
diff changeset
    54
@@ -2016,12 +2016,26 @@
4414
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    55
 /* This sets the 'default' SSL version that SSL_new() will create */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    56
 int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *meth);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    57
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    58
-# ifndef OPENSSL_NO_SSL2
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    59
-const SSL_METHOD *SSLv2_method(void); /* SSLv2 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    60
-const SSL_METHOD *SSLv2_server_method(void); /* SSLv2 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    61
-const SSL_METHOD *SSLv2_client_method(void); /* SSLv2 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    62
-# endif
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    63
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    64
+#ifndef __has_attribute
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    65
+# define __has_attribute(x) 0
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    66
+#endif
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    67
+
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    68
+/* Mark SSLv2_* functions deprecated */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    69
+#if __has_attribute(deprecated) \
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    70
+    || (defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 301)) \
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    71
+    || (defined(__SUNPRO_C) && (__SUNPRO_C >= 0x5130))
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    72
+# define DEPRECATED __attribute__((deprecated))
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    73
+#else
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    74
+# define DEPRECATED
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    75
+#endif
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    76
+
4589
13498d090b19 21274628 python/cryptography doesn't build on s12-76
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents: 4414
diff changeset
    77
+# ifndef OPENSSL_NO_SSL2
4414
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    78
+DEPRECATED const SSL_METHOD *SSLv2_method(void); /* SSLv2 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    79
+DEPRECATED const SSL_METHOD *SSLv2_server_method(void); /* SSLv2 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    80
+DEPRECATED const SSL_METHOD *SSLv2_client_method(void); /* SSLv2 */
4589
13498d090b19 21274628 python/cryptography doesn't build on s12-76
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents: 4414
diff changeset
    81
+# endif
4414
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    82
+
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    83
 # ifndef OPENSSL_NO_SSL3_METHOD
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    84
 const SSL_METHOD *SSLv3_method(void); /* SSLv3 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    85
 const SSL_METHOD *SSLv3_server_method(void); /* SSLv3 */
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    86
--- openssl-1.0.1/doc/ssl/SSL_CIPHER_get_name.pod	Tue May 26 11:13:15 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    87
+++ openssl-1.0.1/doc/ssl/SSL_CIPHER_get_name.pod.new	Tue May 26 11:32:09 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    88
@@ -25,7 +25,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    89
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    90
 SSL_CIPHER_get_version() returns string which indicates the SSL/TLS protocol
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    91
 version that first defined the cipher.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    92
-This is currently B<SSLv2> or B<TLSv1/SSLv3>.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    93
+This is currently B<TLSv1/SSLv3>.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    94
 In some cases it should possibly return "TLSv1.2" but does not;
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    95
 use SSL_CIPHER_description() instead.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    96
 If B<cipher> is NULL, "(NONE)" is returned.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    97
@@ -56,7 +56,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    98
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    99
 =item <protocol version>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   100
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   101
-Protocol version: B<SSLv2>, B<SSLv3>, B<TLSv1.2>. The TLSv1.0 ciphers are
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   102
+Protocol version: B<SSLv3>, B<TLSv1.2>. The TLSv1.0 ciphers are
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   103
 flagged with SSLv3. No new ciphers were added by TLSv1.1.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   104
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   105
 =item Kx=<key exchange>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   106
--- openssl-1.0.1/doc/ssl/SSL_CTX_new.pod	Tue Jan 20 04:33:36 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   107
+++ openssl-1.0.1/doc/ssl/SSL_CTX_new.pod.new	Tue May 26 11:37:24 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   108
@@ -25,10 +25,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   109
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   110
 =item SSLv2_method(void), SSLv2_server_method(void), SSLv2_client_method(void)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   111
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   112
-A TLS/SSL connection established with these methods will only understand
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   113
-the SSLv2 protocol. A client will send out SSLv2 client hello messages
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   114
-and will also indicate that it only understand SSLv2. A server will only
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   115
-understand SSLv2 client hello messages.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   116
+These functions are deprecated.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   117
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   118
 =item SSLv3_method(void), SSLv3_server_method(void), SSLv3_client_method(void)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   119
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   120
@@ -51,33 +48,25 @@ SSLv3 client hello messages.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   121
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   122
 =item SSLv23_method(void), SSLv23_server_method(void), SSLv23_client_method(void)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   123
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   124
-A TLS/SSL connection established with these methods may understand the SSLv2,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   125
+A TLS/SSL connection established with these methods may understand the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   126
 SSLv3, TLSv1, TLSv1.1 and TLSv1.2 protocols.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   127
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   128
-If the cipher list does not contain any SSLv2 ciphersuites (the default
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   129
-cipher list does not) or extensions are required (for example server name)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   130
+If extensions are required (for example server name)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   131
 a client will send out TLSv1 client hello messages including extensions and
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   132
 will indicate that it also understands TLSv1.1, TLSv1.2 and permits a
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   133
 fallback to SSLv3. A server will support SSLv3, TLSv1, TLSv1.1 and TLSv1.2
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   134
 protocols. This is the best choice when compatibility is a concern.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   135
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   136
-If any SSLv2 ciphersuites are included in the cipher list and no extensions
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   137
-are required then SSLv2 compatible client hellos will be used by clients and
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   138
-SSLv2 will be accepted by servers. This is B<not> recommended due to the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   139
-insecurity of SSLv2 and the limited nature of the SSLv2 client hello
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   140
-prohibiting the use of extensions.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   141
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   142
 =back
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   143
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   144
-The list of protocols available can later be limited using the SSL_OP_NO_SSLv2,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   145
+The list of protocols available can later be limited using the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   146
 SSL_OP_NO_SSLv3, SSL_OP_NO_TLSv1, SSL_OP_NO_TLSv1_1 and SSL_OP_NO_TLSv1_2
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   147
 options of the SSL_CTX_set_options() or SSL_set_options() functions.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   148
 Using these options it is possible to choose e.g. SSLv23_server_method() and
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   149
 be able to negotiate with all possible clients, but to only allow newer
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   150
 protocols like TLSv1, TLSv1.1 or TLS v1.2.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   151
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   152
-Applications which never want to support SSLv2 (even is the cipher string
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   153
-is configured to use SSLv2 ciphersuites) can set SSL_OP_NO_SSLv2.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   154
+Applications which never want to support SSLv3 can set SSL_OP_NO_SSLv3.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   155
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   156
 SSL_CTX_new() initializes the list of ciphers, the session cache setting,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   157
 the callbacks, the keys and certificates and the options to its default
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   158
--- openssl-1.0.1/doc/ssl/SSL_CTX_set_cipher_list.pod	Thu Mar 19 06:37:10 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   159
+++ openssl-1.0.1/doc/ssl/SSL_CTX_set_cipher_list.pod.new	Tue May 26 11:38:09 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   160
@@ -54,10 +54,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   161
 keys), the "no shared cipher" (SSL_R_NO_SHARED_CIPHER) error is generated
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   162
 and the handshake will fail.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   163
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   164
-If the cipher list does not contain any SSLv2 cipher suites (this is the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   165
-default) then SSLv2 is effectively disabled and neither clients nor servers
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   166
-will attempt to use SSLv2.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   167
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   168
 =head1 RETURN VALUES
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   169
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   170
 SSL_CTX_set_cipher_list() and SSL_set_cipher_list() return 1 if any cipher
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   171
--- openssl-1.0.1/doc/ssl/SSL_CTX_set_generate_session_id.pod	Thu Jan 15 06:43:49 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   172
+++ openssl-1.0.1/doc/ssl/SSL_CTX_set_generate_session_id.pod.new	Tue May 26 11:40:47 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   173
@@ -32,9 +32,8 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   174
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   175
 When a new session is established between client and server, the server
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   176
 generates a session id. The session id is an arbitrary sequence of bytes.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   177
-The length of the session id is 16 bytes for SSLv2 sessions and between
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   178
-1 and 32 bytes for SSLv3/TLSv1. The session id is not security critical
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   179
-but must be unique for the server. Additionally, the session id is
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   180
+The length of the session id is between 1 and 32 bytes. The session id is not
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   181
+security critical but must be unique for the server. Additionally, the session id is
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   182
 transmitted in the clear when reusing the session so it must not contain
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   183
 sensitive information.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   184
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   185
@@ -51,12 +50,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   186
 the callback B<must never> increase B<id_len> or write to the location
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   187
 B<id> exceeding the given limit.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   188
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   189
-If a SSLv2 session id is generated and B<id_len> is reduced, it will be
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   190
-restored after the callback has finished and the session id will be padded
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   191
-with 0x00. It is not recommended to change the B<id_len> for SSLv2 sessions.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   192
-The callback can use the L<SSL_get_version(3)|SSL_get_version(3)> function
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   193
-to check, whether the session is of type SSLv2.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   194
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   195
 The location B<id> is filled with 0x00 before the callback is called, so the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   196
 callback may only fill part of the possible length and leave B<id_len>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   197
 untouched while maintaining reproducibility.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   198
@@ -63,9 +56,8 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   199
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   200
 Since the sessions must be distinguished, session ids must be unique.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   201
 Without the callback a random number is used, so that the probability
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   202
-of generating the same session id is extremely small (2^128 possible ids
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   203
-for an SSLv2 session, 2^256 for SSLv3/TLSv1). In order to assure the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   204
-uniqueness of the generated session id, the callback must call
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   205
+of generating the same session id is extremely small (2^256 for SSLv3/TLSv1).
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   206
+In order to assure the uniqueness of the generated session id, the callback must call
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   207
 SSL_has_matching_session_id() and generate another id if a conflict occurs.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   208
 If an id conflict is not resolved, the handshake will fail.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   209
 If the application codes e.g. a unique host id, a unique process number, and
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   210
@@ -85,10 +77,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   211
 the external cache is not tested with SSL_has_matching_session_id()
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   212
 and the same race condition applies.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   213
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   214
-When calling SSL_has_matching_session_id() for an SSLv2 session with
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   215
-reduced B<id_len>, the match operation will be performed using the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   216
-fixed length required and with a 0x00 padded id.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   217
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   218
 The callback must return 0 if it cannot generate a session id for whatever
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   219
 reason and return 1 on success.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   220
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   221
@@ -104,12 +92,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   222
                               unsigned int *id_len)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   223
       {
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   224
       unsigned int count = 0;
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   225
-      const char *version;
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   226
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   227
-      version = SSL_get_version(ssl);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   228
-      if (!strcmp(version, "SSLv2"))
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   229
-	  /* we must not change id_len */;
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   230
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   231
       do      {
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   232
               RAND_pseudo_bytes(id, *id_len);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   233
               /* Prefix the session_id with the required prefix. NB: If our
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   234
--- openssl-1.0.1/doc/ssl/SSL_CTX_set_options.pod	Tue Jan 20 04:33:36 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   235
+++ openssl-1.0.1/doc/ssl/SSL_CTX_set_options.pod.new	Tue May 26 11:41:47 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   236
@@ -63,18 +63,11 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   237
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   238
 =item SSL_OP_MICROSOFT_SESS_ID_BUG
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   239
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   240
-www.microsoft.com - when talking SSLv2, if session-id reuse is
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   241
-performed, the session-id passed back in the server-finished message
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   242
-is different from the one decided upon.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   243
+As of OpenSSL 1.0.0 this option has no effect.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   244
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   245
 =item SSL_OP_NETSCAPE_CHALLENGE_BUG
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   246
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   247
-Netscape-Commerce/1.12, when talking SSLv2, accepts a 32 byte
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   248
-challenge but then appears to only use 16 bytes when generating the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   249
-encryption keys.  Using 16 bytes is ok but it should be ok to use 32.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   250
-According to the SSLv3 spec, one should use 32 bytes for the challenge
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   251
-when operating in SSLv2/v3 compatibility mode, but as mentioned above,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   252
-this breaks this server so 16 bytes is the way to go.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   253
+As of OpenSSL 1.0.0 this option has no effect.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   254
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   255
 =item SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   256
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   257
--- openssl-1.0.1/doc/ssl/SSL_get_default_timeout.pod	Thu Jan 15 06:43:49 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   258
+++ openssl-1.0.1/doc/ssl/SSL_get_default_timeout.pod.new	Tue May 26 11:42:15 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   259
@@ -24,7 +24,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   260
 timeout for the protocol will be used.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   261
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   262
 SSL_get_default_timeout() return this hardcoded value, which is 300 seconds
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   263
-for all currently supported protocols (SSLv2, SSLv3, and TLSv1).
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   264
+for all currently supported protocols.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   265
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   266
 =head1 RETURN VALUES
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   267
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   268
--- openssl-1.0.1/doc/ssl/SSL_get_version.pod	Thu Jan 15 06:43:49 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   269
+++ openssl-1.0.1/doc/ssl/SSL_get_version.pod.new	Tue May 26 11:42:45 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   270
@@ -21,9 +21,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   271
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   272
 =over 4
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   273
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   274
-=item SSLv2
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   275
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   276
-The connection uses the SSLv2 protocol.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   277
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   278
 =item SSLv3
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   279
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   280
--- openssl-1.0.1/doc/ssl/SSL_new.pod	Thu Jan 15 06:43:49 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   281
+++ openssl-1.0.1/doc/ssl/SSL_new.pod.new	Tue May 26 11:43:12 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   282
@@ -14,7 +14,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   283
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   284
 SSL_new() creates a new B<SSL> structure which is needed to hold the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   285
 data for a TLS/SSL connection. The new structure inherits the settings
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   286
-of the underlying context B<ctx>: connection method (SSLv2/v3/TLSv1),
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   287
+of the underlying context B<ctx>: connection method,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   288
 options, verification settings, timeout settings.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   289
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   290
 =head1 RETURN VALUES
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   291
--- openssl-1.0.1/doc/ssl/SSL_shutdown.pod	Thu Mar 19 06:37:10 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   292
+++ openssl-1.0.1/doc/ssl/SSL_shutdown.pod.new	Tue May 26 11:43:56 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   293
@@ -60,9 +60,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   294
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   295
 It is therefore recommended, to check the return value of SSL_shutdown()
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   296
 and call SSL_shutdown() again, if the bidirectional shutdown is not yet
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   297
-complete (return value of the first call is 0). As the shutdown is not
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   298
-specially handled in the SSLv2 protocol, SSL_shutdown() will succeed on
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   299
-the first call.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   300
+complete (return value of the first call is 0).
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   301
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   302
 The behaviour of SSL_shutdown() additionally depends on the underlying BIO. 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   303
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   304
--- openssl-1.0.1/doc/ssl/ssl.pod	Thu Mar 19 06:37:10 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   305
+++ openssl-1.0.1/doc/ssl/ssl.pod.new	Tue May 26 11:47:38 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   306
@@ -9,7 +9,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   307
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   308
 =head1 DESCRIPTION
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   309
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   310
-The OpenSSL B<ssl> library implements the Secure Sockets Layer (SSL v2/v3) and
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   311
+The OpenSSL B<ssl> library implements the Secure Sockets Layer (SSL v3) and
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   312
 Transport Layer Security (TLS v1) protocols. It provides a rich API which is
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   313
 documented here.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   314
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   315
@@ -45,8 +45,8 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   316
 =item B<SSL_METHOD> (SSL Method)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   317
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   318
 That's a dispatch structure describing the internal B<ssl> library
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   319
-methods/functions which implement the various protocol versions (SSLv1, SSLv2
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   320
-and TLSv1). It's needed to create an B<SSL_CTX>.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   321
+methods/functions which implement the various protocol versions (SSLv3
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   322
+TLSv1, ...). It's needed to create an B<SSL_CTX>.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   323
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   324
 =item B<SSL_CIPHER> (SSL Cipher)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   325
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   326
@@ -105,8 +104,8 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   327
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   328
 =item B<ssl23.h>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   329
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   330
-That's the sub header file dealing with the combined use of the SSLv2 and
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   331
-SSLv3 protocols.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   332
+That's the sub header file dealing with the combined use of different
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   333
+protocol version.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   334
 I<Usually you don't have to include it explicitly because
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   335
 it's already included by ssl.h>.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   336
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   337
@@ -132,15 +131,15 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   338
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   339
 =item const SSL_METHOD *B<SSLv2_client_method>(void);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   340
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   341
-Constructor for the SSLv2 SSL_METHOD structure for a dedicated client.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   342
+Constructor for the SSLv2 SSL_METHOD structure for a dedicated client. (deprecated)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   343
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   344
 =item const SSL_METHOD *B<SSLv2_server_method>(void);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   345
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   346
-Constructor for the SSLv2 SSL_METHOD structure for a dedicated server.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   347
+Constructor for the SSLv2 SSL_METHOD structure for a dedicated server. (deprecated)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   348
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   349
 =item const SSL_METHOD *B<SSLv2_method>(void);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   350
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   351
-Constructor for the SSLv2 SSL_METHOD structure for combined client and server.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   352
+Constructor for the SSLv2 SSL_METHOD structure for combined client and server. (deprecated)
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   353
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   354
 =item const SSL_METHOD *B<SSLv3_client_method>(void);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   355
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   356
@@ -189,12 +188,12 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   357
 =item const char *B<SSL_CIPHER_get_name>(SSL_CIPHER *cipher);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   358
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   359
 Return the internal name of I<cipher> as a string. These are the various
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   360
-strings defined by the I<SSL2_TXT_xxx>, I<SSL3_TXT_xxx> and I<TLS1_TXT_xxx>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   361
+strings defined by the I<SSL3_TXT_xxx> and I<TLS1_TXT_xxx>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   362
 definitions in the header files.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   363
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   364
 =item char *B<SSL_CIPHER_get_version>(SSL_CIPHER *cipher);
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   365
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   366
-Returns a string like "C<TLSv1/SSLv3>" or "C<SSLv2>" which indicates the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   367
+Returns a string like "C<TLSv1/SSLv3>" which indicates the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   368
 SSL/TLS protocol version to which I<cipher> belongs (i.e. where it was defined
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   369
 in the specification the first time).
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   370
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   371
--- openssl-1.0.1/doc/apps/ciphers.pod	Thu Mar 19 06:37:10 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   372
+++ openssl-1.0.1/doc/apps/ciphers.pod.new	Tue May 26 12:07:35 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   373
@@ -9,7 +9,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   374
 B<openssl> B<ciphers>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   375
 [B<-v>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   376
 [B<-V>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   377
-[B<-ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   378
 [B<-ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   379
 [B<-tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   380
 [B<cipherlist>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   381
@@ -27,12 +26,9 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   382
 =item B<-v>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   383
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   384
 Verbose option. List ciphers with a complete description of
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   385
-protocol version (SSLv2 or SSLv3; the latter includes TLS), key exchange,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   386
+protocol version, key exchange,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   387
 authentication, encryption and mac algorithms used along with any key size
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   388
 restrictions and whether the algorithm is classed as an "export" cipher.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   389
-Note that without the B<-v> option, ciphers may seem to appear twice
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   390
-in a cipher list; this is when similar ciphers are available for
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   391
-SSL v2 and for SSL v3/TLS v1.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   392
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   393
 =item B<-V>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   394
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   395
@@ -42,10 +38,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   396
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   397
 only include SSL v3 ciphers.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   398
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   399
-=item B<-ssl2>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   400
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   401
-only include SSL v2 ciphers.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   402
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   403
 =item B<-tls1>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   404
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   405
 only include TLS v1 ciphers.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   406
@@ -246,9 +232,9 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   407
 ciphers suites using FORTEZZA key exchange, authentication, encryption or all
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   408
 FORTEZZA algorithms. Not implemented.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   409
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   410
-=item B<TLSv1.2>, B<TLSv1>, B<SSLv3>, B<SSLv2>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   411
+=item B<TLSv1.2>, B<TLSv1>, B<SSLV3>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   412
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   413
-TLS v1.2, TLS v1.0, SSL v3.0 or SSL v2.0 cipher suites respectively. Note:
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   414
+TLS v1.2, TLS v1.0 or SSL v3.0  cipher suites respectively. Note:
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   415
 there are no ciphersuites specific to TLS v1.1.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   416
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   417
 =item B<AES128>, B<AES256>, B<AES>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   418
@@ -569,16 +555,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   419
  TLS_PSK_WITH_AES_128_CBC_SHA              PSK-AES128-CBC-SHA
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   420
  TLS_PSK_WITH_AES_256_CBC_SHA              PSK-AES256-CBC-SHA
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   421
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   422
-=head2 Deprecated SSL v2.0 cipher suites.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   423
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   424
- SSL_CK_RC4_128_WITH_MD5                 RC4-MD5
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   425
- SSL_CK_RC4_128_EXPORT40_WITH_MD5        EXP-RC4-MD5
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   426
- SSL_CK_RC2_128_CBC_WITH_MD5             RC2-MD5
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   427
- SSL_CK_RC2_128_CBC_EXPORT40_WITH_MD5    EXP-RC2-MD5
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   428
- SSL_CK_IDEA_128_CBC_WITH_MD5            IDEA-CBC-MD5
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   429
- SSL_CK_DES_64_CBC_WITH_MD5              DES-CBC-MD5
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   430
- SSL_CK_DES_192_EDE3_CBC_WITH_MD5        DES-CBC3-MD5
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   431
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   432
 =head1 NOTES
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   433
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   434
 The non-ephemeral DH modes are currently unimplemented in OpenSSL
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   435
--- openssl-1.0.1/doc/apps/s_client.pod	Thu Mar 19 06:37:10 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   436
+++ openssl-1.0.1/doc/apps/s_client.pod.new	Tue May 26 12:15:40 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   437
@@ -31,10 +31,8 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   438
 [B<-ign_eof>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   439
 [B<-no_ign_eof>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   440
 [B<-quiet>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   441
-[B<-ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   442
 [B<-ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   443
 [B<-tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   444
-[B<-no_ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   445
 [B<-no_ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   446
 [B<-no_tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   447
 [B<-bugs>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   448
@@ -196,11 +196,11 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   449
 given as a hexadecimal number without leading 0x, for example -psk
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   450
 1a2b3c4d.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   451
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   452
-=item B<-ssl2>, B<-ssl3>, B<-tls1>, B<-no_ssl2>, B<-no_ssl3>, B<-no_tls1>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   453
+=item B<-ssl3>, B<-tls1>, B<-no_ssl3>, B<-no_tls1>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   454
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   455
 these options disable the use of certain SSL or TLS protocols. By default
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   456
 the initial handshake uses a method which should be compatible with all
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   457
-servers and permit them to use SSL v3, SSL v2 or TLS as appropriate.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   458
+servers and permit them to use SSL v3 or TLS as appropriate.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   459
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   460
 Unfortunately there are a lot of ancient and broken servers in use which
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   461
 cannot handle this technique and will fail to connect. Some servers only
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   462
@@ -219,10 +219,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   463
 supported cipher in the list sent by the client. See the B<ciphers>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   464
 command for more information.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   465
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   466
-=item B<-serverpref>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   467
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   468
-use the server's cipher preferences; only used for SSLV2.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   469
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   470
 =item B<-starttls protocol>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   471
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   472
 send the protocol-specific message(s) to switch to TLS for communication.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   473
@@ -299,8 +295,8 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   474
 then an HTTP command can be given such as "GET /" to retrieve a web page.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   475
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   476
 If the handshake fails then there are several possible causes, if it is
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   477
-nothing obvious like no client certificate then the B<-bugs>, B<-ssl2>,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   478
-B<-ssl3>, B<-tls1>, B<-no_ssl2>, B<-no_ssl3>, B<-no_tls1> options can be tried
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   479
+nothing obvious like no client certificate then the B<-bugs>,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   480
+B<-ssl3>, B<-tls1>, B<-no_ssl3>, B<-no_tls1> options can be tried
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   481
 in case it is a buggy server. In particular you should play with these
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   482
 options B<before> submitting a bug report to an OpenSSL mailing list.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   483
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   484
@@ -322,10 +318,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   485
 If there are problems verifying a server certificate then the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   486
 B<-showcerts> option can be used to show the whole chain.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   487
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   488
-Since the SSLv23 client hello cannot include compression methods or extensions
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   489
-these will only be supported if its use is disabled, for example by using the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   490
-B<-no_sslv2> option.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   491
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   492
 The B<s_client> utility is a test tool and is designed to continue the
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   493
 handshake after any certificate verification errors. As a result it will
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   494
 accept any certificate chain (trusted or not) sent by the peer. None test
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   495
--- openssl-1.0.1/doc/apps/s_server.pod	Thu Mar 19 06:37:10 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   496
+++ openssl-1.0.1/doc/apps/s_server.pod.new	Tue May 26 12:15:02 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   497
@@ -38,10 +38,8 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   498
 [B<-serverpref>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   499
 [B<-quiet>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   500
 [B<-no_tmp_rsa>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   501
-[B<-ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   502
 [B<-ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   503
 [B<-tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   504
-[B<-no_ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   505
 [B<-no_ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   506
 [B<-no_tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   507
 [B<-no_dhe>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   508
@@ -216,11 +216,11 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   509
 given as a hexadecimal number without leading 0x, for example -psk
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   510
 1a2b3c4d.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   511
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   512
-=item B<-ssl2>, B<-ssl3>, B<-tls1>, B<-no_ssl2>, B<-no_ssl3>, B<-no_tls1>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   513
+=item B<-ssl3>, B<-tls1>, B<-no_ssl3>, B<-no_tls1>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   514
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   515
 these options disable the use of certain SSL or TLS protocols. By default
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   516
 the initial handshake uses a method which should be compatible with all
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   517
-servers and permit them to use SSL v3, SSL v2 or TLS as appropriate.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   518
+servers and permit them to use SSL v3 or TLS as appropriate.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   519
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   520
 =item B<-bugs>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   521
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   522
--- openssl-1.0.1/doc/apps/s_time.pod	Thu Jan 15 06:43:49 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   523
+++ openssl-1.0.1/doc/apps/s_time.pod.new	Tue May 26 12:20:09 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   524
@@ -19,7 +19,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   525
 [B<-verify depth>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   526
 [B<-nbio>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   527
 [B<-time seconds>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   528
-[B<-ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   529
 [B<-ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   530
 [B<-bugs>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   531
 [B<-cipher cipherlist>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   532
@@ -92,18 +90,17 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   533
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   534
 turns on non-blocking I/O.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   535
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   536
-=item B<-ssl2>, B<-ssl3>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   537
+=item B<-ssl3>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   538
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   539
 these options disable the use of certain SSL or TLS protocols. By default
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   540
 the initial handshake uses a method which should be compatible with all
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   541
-servers and permit them to use SSL v3, SSL v2 or TLS as appropriate.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   542
+servers and permit them to use SSL v3 or TLS as appropriate.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   543
 The timing program is not as rich in options to turn protocols on and off as
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   544
 the L<s_client(1)|s_client(1)> program and may not connect to all servers.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   545
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   546
 Unfortunately there are a lot of ancient and broken servers in use which
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   547
 cannot handle this technique and will fail to connect. Some servers only
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   548
-work if TLS is turned off with the B<-ssl3> option; others
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   549
-will only support SSL v2 and may need the B<-ssl2> option.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   550
+work if TLS is turned off with the B<-ssl3> option.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   551
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   552
 =item B<-bugs>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   553
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   554
@@ -137,7 +122,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   555
 for details.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   556
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   557
 If the handshake fails then there are several possible causes, if it is
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   558
-nothing obvious like no client certificate then the B<-bugs>, B<-ssl2>,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   559
+nothing obvious like no client certificate then the B<-bugs>,
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   560
 B<-ssl3> options can be tried
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   561
 in case it is a buggy server. In particular you should play with these
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   562
 options B<before> submitting a bug report to an OpenSSL mailing list.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   563
--- openssl-1.0.1/doc/apps/sess_id.pod	Thu Jan 15 06:43:49 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   564
+++ openssl-1.0.1/doc/apps/sess_id.pod.new	Tue May 26 12:21:07 2015
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   565
@@ -91,7 +91,7 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   566
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   567
 =item B<Protocol>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   568
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   569
-this is the protocol in use TLSv1, SSLv3 or SSLv2.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   570
+this is the protocol in use TLSv1.2, TLSv1.1, TLSv1 or SSLv3.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   571
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   572
 =item B<Cipher>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   573
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   574
@@ -110,10 +110,6 @@
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   575
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   576
 this is the SSL session master key.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   577
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   578
-=item B<Key-Arg>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   579
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   580
-the key argument, this is only used in SSL v2.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   581
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   582
 =item B<Start Time>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   583
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   584
 this is the session start time represented as an integer in standard Unix format.