components/openssl/openssl-1.0.1/patches/42_rm_sslv2.patch
author jenny.yung@oracle.com <jenny.yung@oracle.com>
Thu, 04 Jun 2015 15:40:26 -0700
branchs11-update
changeset 4414 bcb5766d82d0
child 4589 13498d090b19
permissions -rw-r--r--
PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support 20231102 problem in LIBRARY/OPENSSL
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
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    54
@@ -2016,12 +2016,24 @@
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
+
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    77
+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
    78
+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
    79
+DEPRECATED 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
    80
+
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    81
 # 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
    82
 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
    83
 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
    84
--- 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
    85
+++ 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
    86
@@ -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
    87
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    88
 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
    89
 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
    90
-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
    91
+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
    92
 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
    93
 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
    94
 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
    95
@@ -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
    96
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
    97
 =item <protocol version>
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
-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
   100
+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
   101
 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
   102
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   103
 =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
   104
--- 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
   105
+++ 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
   106
@@ -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
   107
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   108
 =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
   109
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   110
-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
   111
-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
   112
-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
   113
-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
   114
+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
   115
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   116
 =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
   117
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   118
@@ -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
   119
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   120
 =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
   121
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   122
-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
   123
+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
   124
 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
   125
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   126
-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
   127
-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
   128
+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
   129
 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
   130
 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
   131
 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
   132
 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
   133
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   134
-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
   135
-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
   136
-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
   137
-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
   138
-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
   139
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   140
 =back
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
-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
   143
+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
   144
 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
   145
 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
   146
 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
   147
 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
   148
 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
   149
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   150
-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
   151
-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
   152
+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
   153
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   154
 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
   155
 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
   156
--- 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
   157
+++ 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
   158
@@ -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
   159
 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
   160
 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
   161
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   162
-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
   163
-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
   164
-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
   165
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   166
 =head1 RETURN VALUES
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
 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
   169
--- 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
   170
+++ 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
   171
@@ -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
   172
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   173
 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
   174
 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
   175
-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
   176
-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
   177
-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
   178
+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
   179
+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
   180
 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
   181
 sensitive information.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   182
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   183
@@ -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
   184
 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
   185
 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
   186
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   187
-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
   188
-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
   189
-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
   190
-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
   191
-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
   192
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   193
 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
   194
 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
   195
 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
   196
@@ -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
   197
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   198
 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
   199
 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
   200
-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
   201
-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
   202
-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
   203
+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
   204
+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
   205
 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
   206
 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
   207
 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
   208
@@ -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
   209
 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
   210
 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
   211
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   212
-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
   213
-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
   214
-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
   215
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   216
 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
   217
 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
   218
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   219
@@ -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
   220
                               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
   221
       {
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   222
       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
   223
-      const char *version;
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   224
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   225
-      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
   226
-      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
   227
-	  /* 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
   228
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   229
       do      {
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   230
               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
   231
               /* 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
   232
--- 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
   233
+++ 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
   234
@@ -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
   235
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   236
 =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
   237
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   238
-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
   239
-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
   240
-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
   241
+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
   242
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   243
 =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
   244
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   245
-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
   246
-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
   247
-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
   248
-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
   249
-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
   250
-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
   251
+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
   252
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   253
 =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
   254
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   255
--- 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
   256
+++ 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
   257
@@ -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
   258
 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
   259
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   260
 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
   261
-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
   262
+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
   263
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   264
 =head1 RETURN VALUES
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
--- 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
   267
+++ 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
   268
@@ -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
   269
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   270
 =over 4
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
-=item SSLv2
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
-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
   275
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   276
 =item SSLv3
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
--- 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
   279
+++ 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
   280
@@ -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
   281
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   282
 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
   283
 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
   284
-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
   285
+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
   286
 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
   287
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   288
 =head1 RETURN VALUES
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   289
--- 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
   290
+++ 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
   291
@@ -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
   292
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   293
 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
   294
 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
   295
-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
   296
-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
   297
-the first call.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   298
+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
   299
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   300
 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
   301
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   302
--- 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
   303
+++ 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
   304
@@ -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
   305
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   306
 =head1 DESCRIPTION
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
-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
   309
+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
   310
 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
   311
 documented here.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   312
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   313
@@ -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
   314
 =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
   315
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   316
 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
   317
-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
   318
-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
   319
+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
   320
+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
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   322
 =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
   323
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   324
@@ -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
   325
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   326
 =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
   327
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   328
-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
   329
-SSLv3 protocols.
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 different
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   331
+protocol version.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   332
 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
   333
 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
   334
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   335
@@ -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
   336
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   337
 =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
   338
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   339
-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
   340
+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
   341
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   342
 =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
   343
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   344
-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
   345
+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
   346
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   347
 =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
   348
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   349
-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
   350
+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
   351
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   352
 =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
   353
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   354
@@ -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
   355
 =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
   356
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   357
 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
   358
-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
   359
+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
   360
 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
   361
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   362
 =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
   363
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   364
-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
   365
+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
   366
 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
   367
 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
   368
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   369
--- 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
   370
+++ 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
   371
@@ -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
   372
 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
   373
 [B<-v>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   374
 [B<-V>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   375
-[B<-ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   376
 [B<-ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   377
 [B<-tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   378
 [B<cipherlist>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   379
@@ -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
   380
 =item B<-v>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   381
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   382
 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
   383
-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
   384
+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
   385
 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
   386
 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
   387
-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
   388
-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
   389
-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
   390
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   391
 =item B<-V>
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
@@ -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
   394
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   395
 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
   396
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   397
-=item B<-ssl2>
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
-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
   400
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   401
 =item B<-tls1>
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
 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
   404
@@ -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
   405
 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
   406
 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
   407
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   408
-=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
   409
+=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
   410
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   411
-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
   412
+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
   413
 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
   414
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   415
 =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
   416
@@ -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
   417
  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
   418
  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
   419
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   420
-=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
   421
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   422
- 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
   423
- 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
   424
- 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
   425
- 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
   426
- 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
   427
- 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
   428
- 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
   429
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   430
 =head1 NOTES
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
 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
   433
--- 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
   434
+++ 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
   435
@@ -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
   436
 [B<-ign_eof>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   437
 [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
   438
 [B<-quiet>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   439
-[B<-ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   440
 [B<-ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   441
 [B<-tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   442
-[B<-no_ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   443
 [B<-no_ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   444
 [B<-no_tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   445
 [B<-bugs>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   446
@@ -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
   447
 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
   448
 1a2b3c4d.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   449
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   450
-=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
   451
+=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
   452
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   453
 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
   454
 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
   455
-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
   456
+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
   457
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   458
 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
   459
 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
   460
@@ -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
   461
 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
   462
 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
   463
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   464
-=item B<-serverpref>
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
-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
   467
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   468
 =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
   469
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   470
 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
   471
@@ -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
   472
 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
   473
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   474
 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
   475
-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
   476
-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
   477
+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
   478
+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
   479
 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
   480
 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
   481
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   482
@@ -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
   483
 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
   484
 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
   485
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   486
-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
   487
-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
   488
-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
   489
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   490
 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
   491
 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
   492
 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
   493
--- 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
   494
+++ 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
   495
@@ -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
   496
 [B<-serverpref>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   497
 [B<-quiet>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   498
 [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
   499
-[B<-ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   500
 [B<-ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   501
 [B<-tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   502
-[B<-no_ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   503
 [B<-no_ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   504
 [B<-no_tls1>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   505
 [B<-no_dhe>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   506
@@ -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
   507
 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
   508
 1a2b3c4d.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   509
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   510
-=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
   511
+=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
   512
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   513
 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
   514
 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
   515
-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
   516
+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
   517
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   518
 =item B<-bugs>
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
--- 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
   521
+++ 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
   522
@@ -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
   523
 [B<-verify depth>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   524
 [B<-nbio>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   525
 [B<-time seconds>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   526
-[B<-ssl2>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   527
 [B<-ssl3>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   528
 [B<-bugs>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   529
 [B<-cipher cipherlist>]
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   530
@@ -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
   531
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   532
 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
   533
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   534
-=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
   535
+=item B<-ssl3>
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   536
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   537
 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
   538
 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
   539
-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
   540
+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
   541
 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
   542
 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
   543
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   544
 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
   545
 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
   546
-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
   547
-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
   548
+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
   549
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   550
 =item B<-bugs>
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
@@ -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
   553
 for details.
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   554
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   555
 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
   556
-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
   557
+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
   558
 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
   559
 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
   560
 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
   561
--- 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
   562
+++ 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
   563
@@ -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
   564
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   565
 =item B<Protocol>
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
-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
   568
+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
   569
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   570
 =item B<Cipher>
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
@@ -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
   573
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   574
 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
   575
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   576
-=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
   577
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   578
-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
   579
-
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   580
 =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
   581
 
bcb5766d82d0 PSARC/2015/249 EOL of OpenSSL SSLv2/v3 support
jenny.yung@oracle.com <jenny.yung@oracle.com>
parents:
diff changeset
   582
 this is the session start time represented as an integer in standard Unix format.