SSL_GET_CIPHERS(3)

NAME
SSL_get_ciphers, SSL_get_cipher_list - get list of available SSL_CIPHERs

SYNOPSIS
#include <openssl/ssl.h>
STACK_OF(SSL_CIPHER) *
SSL_get_ciphers(const SSL *ssl);
const char *
SSL_get_cipher_list(const SSL *ssl, int priority);

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

SSL_get_ciphers() returns a pointer to an internal cipher stack, which will be freed later on when the SSL object is freed. Therefore, the calling code must not free the return value itself.

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

SSL_get_cipher_list() 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 SSL_get_cipher_list() with priority starting from 0 to obtain the sorted list of available ciphers, until NULL is returned.

SEE ALSO
ssl(3), SSL_CIPHER_get_name(3), SSL_CTX_set_cipher_list(3)