[#SSL_bytes_to_cipher_list]
= SSL_bytes_to_cipher_list
:mrdocs:

Parse a wire‐format cipher suite list into SSL_CIPHER and SCSV stacks.

== Synopsis

Declared in `<openssl/ssl.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
SSL_bytes_to_cipher_list(
    xref:SSL.adoc[SSL]* s,
    unsigned char const* bytes,
    size_t len,
    int isv2format,
    xref:stack_st_SSL_CIPHER.adoc[stack_st_SSL_CIPHER]** sk,
    xref:stack_st_SSL_CIPHER.adoc[stack_st_SSL_CIPHER]** scsvs);
----

== Return Value

1 on success, or 0 on failure; unsupported suites are ignored.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *s*
| SSL object used to resolve suite IDs against the library's known ciphers.
| *bytes*
| Wire encoding of cipher suites (2 octets each for TLS, or 3 for SSLv2 format).
| *len*
| Length of `bytes.`
| *isv2format*
| Non‐zero if `bytes` uses the three‐octet SSLv2 cipher format.
| *sk*
| On success, receives a new stack of supported SSL_CIPHER objects (caller frees).
| *scsvs*
| On success, receives a new stack of signalling cipher suite values (caller frees).
|===


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