[#SSL_CIPHER_description]
= SSL&lowbar;CIPHER&lowbar;description
:mrdocs:

Write a human&hyphen;readable description of a cipher suite into a buffer&period;

== Synopsis

Declared in `&lt;openssl&sol;ssl&period;h&gt;`

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

== Return Value

Pointer to the NUL&hyphen;terminated description (possibly newly allocated), or NULL on error &sol; undersized buffer&period;

== Parameters

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


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