[#SSL_SESSION_get_master_key]
= SSL_SESSION_get_master_key
:mrdocs:

Copy the session master secret into a caller buffer (sensitive; avoid exposing).

== Synopsis

Declared in `<openssl/ssl.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
size_t
SSL_SESSION_get_master_key(
    xref:SSL_SESSION.adoc[SSL_SESSION] const* sess,
    unsigned char* out,
    size_t outlen);
----

== Return Value

Number of bytes copied, or the full master‐secret length when `outlen` is 0.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *sess*
| Session whose master key is read.
| *out*
| Buffer that receives up to `outlen` bytes of the master secret; ignored if `outlen` is 0.
| *outlen*
| Capacity of `out,` or 0 to query the master‐secret length only.
|===


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