SSL_CONF_CTX_NEW(3SSL)

📦
version 4.0.3 · 13 versions
, in ubuntu stonking

💖 SSL_CONF_CTX_new, SSL_CONF_CTX_free — the SSL configuration allocation functions 💖

okay so bestie, welcome to the SSL_CONF_CTX_NEW(3SSL) page from the OpenSSL manual 💅 these two little functions are literally the glow-up station for your SSL config contexts — you make one, you use it, you yeet it. that's the whole vibe. no cap. 🎀

✨ NAME ✨

SSL_CONF_CTX_new, SSL_CONF_CTX_free — the SSL configuration allocation functions, aka the "make me a context" and "okay bye context" girlies 🦋

🌸 SYNOPSIS 🌸

#include <openssl/ssl.h>

SSL_CONF_CTX *SSL_CONF_CTX_new(void);
void SSL_CONF_CTX_free(SSL_CONF_CTX *cctx);

like. that's it. that's the whole API surface. simple, clean, iconic. 👑

💫 DESCRIPTION 💫

so SSL_CONF_CTX_new() is the main character here — it allocates and initialises an SSL_CONF_CTX structure so you can go use it with all the SSL_CONF functions. freshly allocated, freshly initialised, ready to serve 🌈✨

and SSL_CONF_CTX_free() is the responsible bestie who frees up the context cctx. one important detail though:

if cctx is NULL, nothing is done. like, literally nothing. it just vibes. no crash, no drama, no problem 💀🫶

🎀 RETURN VALUES 🎀

  • SSL_CONF_CTX_new() hands you back either the shiny newly allocated SSL_CONF_CTX structure ✨ or NULL if an error occurs 😭 (yes, always check. always. that's the vibe check.)
  • SSL_CONF_CTX_free() does not return a value. it's a void girlie. gives nothing back and that's totally fine 💅

👑 SEE ALSO 👑

all the siblings, the whole squad, the group chat 🫶:

🦋 HISTORY 🦋

these functions were added in OpenSSL 1.0.2. vintage but still eating. 🔥

Copyright 2012-2016 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>.

k bye ily, go forth and allocate responsibly 🧚‍♀️

— OpenSSL 4.0.3, dated 2026-09-29, page SSL_CONF_CTX_NEW(3SSL), signing off 💖✨

📦 where this page comes from