SSL_CIPHER_get_cipher_nid (3)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/SSL_CIPHER_get_cipher_nid.3ssl".)

NAME

SSL_CIPHER_get_cipher_nid, SSL_CIPHER_get_digest_nid, SSL_CIPHER_get_kx_nid, SSL_CIPHER_get_auth_nid, SSL_CIPHER_is_aead, SSL_CIPHER_get_name, SSL_CIPHER_get_bits, SSL_CIPHER_get_version, SSL_CIPHER_description - get SSL_CIPHER properties

SYNOPSIS

 #include <openssl/ssl.h>

 const char *SSL_CIPHER_get_name(const SSL_CIPHER *cipher);
 int SSL_CIPHER_get_bits(const SSL_CIPHER *cipher, int *alg_bits);
 char *SSL_CIPHER_get_version(const SSL_CIPHER *cipher);
 char *SSL_CIPHER_description(const SSL_CIPHER *cipher, char *buf, int size);
 int SSL_CIPHER_get_cipher_nid(const SSL_CIPHER *c);
 int SSL_CIPHER_get_digest_nid(const SSL_CIPHER *c);
 int SSL_CIPHER_get_kx_nid(const SSL_CIPHER *c);
 int SSL_CIPHER_get_auth_nid(const SSL_CIPHER *c);
 int SSL_CIPHER_is_aead(const SSL_CIPHER *c);

DESCRIPTION

SSL_CIPHER_get_name() returns a pointer to the name of cipher. If the cipher is it returns ``()''.

SSL_CIPHER_get_bits() returns the number of secret bits used for cipher. If cipher is

is returned.

SSL_CIPHER_get_version() returns string which indicates the

protocol version that first defined the cipher. It returns ``()'' if cipher is

SSL_CIPHER_get_cipher_nid() returns the cipher

corresponding to c. If there is no cipher (e.g. for ciphersuites with no encryption) then NID_undef is returned.

SSL_CIPHER_get_digest_nid() returns the digest

corresponding to the used by c. If there is no digest (e.g. for ciphersuites) then NID_undef is returned.

SSL_CIPHER_get_kx_nid() returns the key exchange

corresponding to the method used by c. If there is no key exchange, then NID_undef is returned. Examples (not comprehensive):

 NID_kx_rsa
 NID_kx_ecdhe
 NID_kx_dhe
 NID_kx_psk

SSL_CIPHER_get_auth_nid() returns the authentication

corresponding to the method used by c. If there is no authentication, then NID_undef is returned. Examples (not comprehensive):

 NID_auth_rsa
 NID_auth_ecdsa
 NID_auth_psk

SSL_CIPHER_is_aead() returns 1 if the cipher c is

(e.g. or ChaCha20/Poly1305), and 0 if it is not

SSL_CIPHER_description() returns a textual description of the cipher used into the buffer buf of length len provided. If buf is provided, it must be at least 128 bytes, otherwise a buffer will be allocated using OPENSSL_malloc(). If the provided buffer is too small, or the allocation fails,

is returned.

The string returned by SSL_CIPHER_description() consists of several fields separated by whitespace:

<ciphername>

Textual representation of the cipher name.

<protocol version>

Protocol version, such as TLSv1.2, when the cipher was first defined.

Kx=<key exchange>

Key exchange method such as

RSA

,

ECDHE

, etc.

Au=<authentication>

Authentication method such as

RSA

, None, etc.. None is the representation of anonymous ciphers.

Enc=<symmetric encryption method>

Encryption method, with number of secret bits, such as

AESGCM

(128).

Mac=<message authentication code>

Message digest, such as

SHA256

.

Some examples for the output of SSL_CIPHER_description():

 ECDHE-RSA-AES256-GCM-SHA256 TLSv1.2 Kx=ECDH     Au=RSA  Enc=AESGCM(256) Mac=AEAD
 RSA-PSK-AES256-CBC-SHA384 TLSv1.0 Kx=RSAPSK   Au=RSA  Enc=AES(256)  Mac=SHA384

HISTORY

SSL_CIPHER_get_version() was updated to always return the correct protocol string in OpenSSL 1.1.

SSL_CIPHER_description() was changed to return

on error, rather than a fixed string, in OpenSSL 1.1

SEE ALSO

ssl(3), SSL_get_current_cipher(3), SSL_get_ciphers(3), ciphers(1)

COPYRIGHT

Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the OpenSSL license (the ``License''). You may not use this file except in compliance with the License. You can obtain a copy in the file

in the source distribution or at <www.openssl.org/source/license.html>.