libressl-SSL_CTX_set_ssl_version(3)

libressl-SSL_CTX_set_ssl_version3

Choose a new tls/ssl method

Usage

SSL Library (libssl, -lssl) libcrypto

#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_CTX_get_ssl_method(SSL_CTX *ctx);

const SSL_METHOD *

SSL_get_ssl_method(SSL *ssl);

Overview

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 called.

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

SSL_CTX_get_ssl_method() and SSL_get_ssl_method() return a function pointer to the TLS/SSL method set in ctx and ssl, respectively.

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.

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.

History

SSL_CTX_set_ssl_version(), SSL_set_ssl_method(), and SSL_get_ssl_method() first appeared in SSLeay 0.8.0 and have been available since OpenBSD 2.4. SSL_CTX_get_ssl_method() first appeared in OpenSSL 1.1.0 and has been available since OpenBSD 7.0.

From libressl 4.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.