CONF_MODULES_FREE(3SSL)

📦
version 4.0.3 · 14 versions
, in ubuntu stonking

💖 CONF_modules_free, CONF_modules_finish, CONF_modules_unload — the OpenSSL config cleanup girlies 💅

okay bestie, welcome to CONF_MODULES_FREE(3SSL) ✨ — yeah the manpage name is long and lowercase and kinda threatening but don't worry, it's literally just the OpenSSL configuration cleanup functions. three of them. we're tidying up. it's giving spring cleaning but for memory. 🧹🌸

✨ NAME ✨

CONF_modules_free, CONF_modules_finish, CONF_modules_unload — OpenSSL configuration cleanup functions 🫶

🎀 SYNOPSIS 🎀

#include <openssl/conf.h>

void CONF_modules_finish(void);
void CONF_modules_unload(int all);

and now for the part nobody wants to hear 😭 — the following functions have been deprecated since OpenSSL 1.1.0, and can be hidden entirely by defining OPENSSL_API_COMPAT with a suitable version value — go check openssl_user_macros(7) for the tea:

void CONF_modules_free(void);
not me about to use a deprecated function 💀 do NOT be that girl. see HISTORY below.

🌸 DESCRIPTION 🌸

CONF_modules_free() closes down and frees up all memory allocated by all configuration modules. slay, right? but listen — normally, back in versions of OpenSSL prior to 1.1.0, applications called CONF_modules_free() at exit to tidy up any configuration they'd performed. so it's the old-school "clean your room before you leave" move. nostalgic. deprecated. we don't do it anymore. 💅

CONF_modules_finish() calls each configuration module's finish handler so it can free up any configuration that said module may have performed. basically it goes around the group chat being like "hey. wrap it up. we're leaving." 📣

CONF_modules_unload() finishes and unloads configuration modules. real main-character energy, full send. now here's the nuance bestie, don't skip it:

  • if all is set to 0, only modules loaded from DSOs will be unloads. 👀 (yes, the manpage says "unloads". iconic typo energy. we keep it exactly as-is, no cap.)
  • if all is set to 1, all modules — including built-in modules — will be unloaded. full reset. 🦋

⭐ RETURN VALUES ⭐

None of the functions return a value. that's it. that's the section. they're all void, they give you nothing back, and honestly? they ate. 🎀

🔥 SEE ALSO 🔥

go read those too, iykyk 💜

💀 HISTORY 💀

CONF_modules_free() was deprecated in OpenSSL 1.1.0; do not use it. (genuinely. don't. it's not a vibe, it's a bug risk.) for more information see OPENSSL_init_crypto(3). ✨

Copyright 2004-2020 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>.

and that's the whole page, bestie 💖 this was CONF_MODULES_FREE(3SSL) from OpenSSL 4.0.3, dated 2026-09-29. now go forth and free your modules (with CONF_modules_finish() and CONF_modules_unload(), obviously — NOT the deprecated one 😭). mwah. 🫶✨
📦 where this page comes from