OpenBSD manual page server

Manual Page Search Parameters

SSL_GET_CIPHERS(3) Library Functions Manual SSL_GET_CIPHERS(3)

SSL_get_ciphers, SSL_CTX_get_ciphers, SSL_get_cipher_listget list of available SSL_CIPHERs

#include <openssl/ssl.h>

STACK_OF(SSL_CIPHER) *
SSL_get_ciphers(const SSL *ssl);

STACK_OF(SSL_CIPHER) *
SSL_CTX_get_ciphers(const SSL_CTX *ctx);

const char *
SSL_get_cipher_list(const SSL *ssl, int priority);

() returns the stack of available SSL_CIPHERs for ssl, sorted by preference. If ssl is NULL or no ciphers are available, NULL is returned.

() returns the stack of available SSL_CIPHERs for ctx.

() and SSL_CTX_get_ciphers() return pointers to internal cipher stacks, which will be freed later on when the SSL or SSL_CTX object is freed. Therefore, the calling code must not free the return value itself.

The details of the ciphers obtained by () and SSL_CTX_get_ciphers() can be obtained using the SSL_CIPHER_get_name(3) family of functions.

() returns a pointer to the name of the SSL_CIPHER listed for ssl with priority. If ssl is NULL, no ciphers are available, or there are fewer ciphers than priority available, NULL is returned.

Call () with priority starting from 0 to obtain the sorted list of available ciphers, until NULL is returned.

ssl(3), SSL_CIPHER_get_name(3), SSL_CTX_set_cipher_list(3)

SSL_get_ciphers() and SSL_get_cipher_list() appeared before SSLeay 0.8 and have been available since OpenBSD 2.4.

SSL_CTX_get_ciphers() first appeared in OpenSSL 1.1.0 and has been available since OpenBSD 6.3.

March 24, 2018 OpenBSD-6.3