[#SSL_CIPHER_description]
= SSL_CIPHER_description
:mrdocs:

Write a human‐readable description of a cipher suite into a buffer.

== Synopsis

Declared in `<openssl/ssl.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
char*
SSL_CIPHER_description(
    xref:SSL_CIPHER.adoc[SSL_CIPHER] const* cipher,
    char* buf,
    int size);
----

== Return Value

Pointer to the NUL‐terminated description (possibly newly allocated), or NULL on error / undersized buffer.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *cipher*
| Cipher suite to describe.
| *buf*
| Destination buffer of at least 128 bytes, or NULL to allocate with OPENSSL_malloc (caller frees).
| *size*
| Capacity of `buf` in bytes when `buf` is non‐NULL.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#