SSL_CTX_CTRL(3ossl)

📦
version 15.1 · 2 versions
, in freebsd 15.1

💅 SSL_CTX_CTRL — the OpenSSL manual, bestie edition 🎀

okay so this is <pink>SSL_CTX_CTRL(3ossl)</pink>, like the actual OpenSSL man page, and we're gonna get through it together. it's a short one. you'll slay this. 🦋

✨ NAME ✨

SSL_CTX_ctrl, SSL_CTX_callback_ctrl, SSL_ctrl, SSL_callback_ctrl — these are the internal handling functions for SSL_CTX and SSL objects, iykyk.

🌸 SYNOPSIS 🌸

#include <openssl/ssl.h>

long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg);
long SSL_CTX_callback_ctrl(SSL_CTX *, int cmd, void (*fp)());

long SSL_ctrl(SSL *ssl, int cmd, long larg, void *parg);
long SSL_callback_ctrl(SSL *, int cmd, void (*fp)());

like yes, that's a lot of asterisks and parens, but it's giving function-pointer realness, and honestly? iconic. 👑

💜 DESCRIPTION 💜

so the SSL_*_ctrl() family of functions is used to manipulate settings of the SSL_CTX and SSL objects. depending on the command cmd, the arguments larg, parg, or fp are evaluated. 🧚

🚨 the big one, bestie: these functions should never be called directly. not once. not "just to see what happens." all the functionalities you actually need are made available via other functions or macros. so like… use those. 💀

⭐ RETURN VALUES ⭐

the return values of the SSL*_ctrl() functions depend on the command supplied via the cmd parameter. that's it, that's the whole section. it's literally "it depends." 😭

🌈 SEE ALSO 🌈

Copyright 2001-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>.

🫶 and that's the whole page!! no notes, ate and left no crumbs. this was OpenSSL 3.5.6, dated 2026-04-07 — go forth and don't call these directly, mwah 💖✨🍓

📦 where this page comes from