Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

SSL_CTX_set_ssl_version (3openssl)

Name

SSL_CTX_set_ssl_version - choose a new TLS/SSL method

Synopsis

#include <openssl/ssl.h>

int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *method);
int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method);
const SSL_METHOD *SSL_get_ssl_method(SSL *ssl);

Description

OpenSSL                                      SSL_CTX_set_ssl_version(3openssl)



NAME
       SSL_CTX_set_ssl_version, SSL_set_ssl_method, SSL_get_ssl_method -
       choose a new TLS/SSL method

SYNOPSIS
        #include <openssl/ssl.h>

        int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *method);
        int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method);
        const SSL_METHOD *SSL_get_ssl_method(SSL *ssl);

DESCRIPTION
       SSL_CTX_set_ssl_version() sets a new default TLS/SSL method for SSL
       objects newly created from this ctx. SSL objects already created with
       SSL_new(3) are not affected, except when SSL_clear(3) is being called.

       SSL_set_ssl_method() sets a new TLS/SSL method for a particular ssl
       object. It may be reset, when SSL_clear() is called.

       SSL_get_ssl_method() returns a function pointer to the TLS/SSL method
       set in ssl.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE      |
       +---------------+--------------------------+
       |Availability   | library/security/openssl |
       +---------------+--------------------------+
       |Stability      | Pass-through uncommitted |
       +---------------+--------------------------+

NOTES
       The available method choices are described in SSL_CTX_new(3).

       When SSL_clear(3) is called and no session is connected to an SSL
       object, the method of the SSL object is reset to the method currently
       set in the corresponding SSL_CTX object.

       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       https://www.openssl.org/source/openssl-1.0.2ze.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.openssl.org/.

RETURN VALUES
       The following return values can occur for SSL_CTX_set_ssl_version() and
       SSL_set_ssl_method():

       0   The new choice failed, check the error stack to find out the
           reason.

       1   The operation succeeded.

SEE ALSO
       SSL_CTX_new(3), SSL_new(3), SSL_clear(3), ssl(3),
       SSL_set_connect_state(3)




1.0.2ze                           2022-05-03
                                             SSL_CTX_set_ssl_version(3openssl)