SSL_STATE_STRING(3ossl)

🌸 NAME 🌸

okay bestie, welcome to the 3ossl manual page for SSL_state_string, SSL_state_string_long — they get you a textual description of the state of an SSL object. icon behavior, honestly 💅

---

✨ SYNOPSIS ✨

#include <openssl/ssl.h>

const char *SSL_state_string(const SSL *ssl);
const char *SSL_state_string_long(const SSL *ssl);

---

🎀 DESCRIPTION 🎀

So SSL_state_string() returns an abbreviated string that indicates the current state of the SSL object ssl. The returned NUL-terminated string contains 6 or fewer characters — tiny, cute, efficient 💖

And SSL_state_string_long() returns a descriptive string indicating the current state of that same SSL object ssl. It’s giving “tell me everything” energy 🌸

---

🦋 NOTES 🦋

During its use, an SSL object passes several states. The state is internally maintained. Querying the state information is not very informative before or when a connection has been established — lowkey not the moment, bestie. It however can be of significant interest during the handshake 👑

When using nonblocking sockets, the function call performing the handshake may return with SSL_ERROR_WANT_READ or SSL_ERROR_WANT_WRITE condition, so that SSL_state_string[_long]() may be called.

For both blocking or nonblocking sockets, the details state information can be used within the info_callback function set with the SSL_set_info_callback() call. iykyk ✨

---

💜 RETURN VALUES 💜

The page is honestly giving placeholder energy here: “Detailed description of possible states to be included later.” So that’s the whole mood for now 🫶

---

🌈 SEE ALSO 🌈

• ssl(7)
• SSL_CTX_set_info_callback(3)

---

👑 COPYRIGHT 👑

Copyright 2001-2021 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.

---

mwah 💋 this page is from OpenSSL 3.5.6, dated 2026-04-07 — periodt, that’s the whole manual page bestie 🎀