SSL_get_ciphers - get list of available SSL_CIPHERs
#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); char *SSL_get_shared_ciphers(const SSL *s, char *buf, int size);
SSL_get_ciphers(3openssl) OpenSSL SSL_get_ciphers(3openssl)
NAME
SSL_get_ciphers, SSL_get_cipher_list, SSL_get_shared_ciphers - 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);
char *SSL_get_shared_ciphers(const SSL *s, char *buf, int size);
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_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 less ciphers than priority available, NULL is returned.
SSL_get_shared_ciphers() creates a colon separated and NUL terminated
list of SSL_CIPHER names that are available in both the client and the
server. buf is the buffer that should be populated with the list of
names and size is the size of that buffer. A pointer to buf is returned
on success or NULL on error. If the supplied buffer is not large enough
to contain the complete list of names then a truncated list of names
will be returned. Note that just because a ciphersuite is available
(i.e. it is configured in the cipher list) and shared by both the
client and the server it does not mean that it is enabled (for example
some ciphers may not be usable by a server if there is not a suitable
certificate configured). This function will return available shared
ciphersuites whether or not they are enabled. This is a server side
function only and must only be called after the completion of the
initial handshake.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------+
|Availability | library/security/openssl |
+---------------+--------------------------+
|Stability | Pass-through uncommitted |
+---------------+--------------------------+
NOTES
The details of the ciphers obtained by SSL_get_ciphers() can be
obtained using the SSL_CIPHER_get_name(3) family of functions.
Call SSL_get_cipher_list() with priority starting from 0 to obtain the
sorted list of available ciphers, until NULL is returned.
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
See DESCRIPTION
SEE ALSO
ssl(3), SSL_CTX_set_cipher_list(3), SSL_CIPHER_get_name(3)
1.0.2ze 2022-05-03 SSL_get_ciphers(3openssl)