SSL_GROUP_TO_NAME(3SSL)

📦
version 4.0.3 · 13 versions
, in ubuntu stonking

💖 SSL_GROUP_TO_NAME 💖

okay bestie, welcome to the SSL_GROUP_TO_NAME(3SSL) page, aka the OpenSSL manual page that's literally just about looking up a group's name. yes. one function. iconic behaviour. let's get into it 💅

✨ NAME ✨

SSL_group_to_name — get the name of a group 🎀

🌸 SYNOPSIS 🌸

#include <openssl/ssl.h>

const char *SSL_group_to_name(SSL *ssl, int id);

🦋 DESCRIPTION 🦋

so, SSL_group_to_name() is the little function you use to retrieve the TLS group name that goes with a given TLS group ID. and where does that mapping come from, you ask? from groups registered via built-in or external providers 💖 — and also as returned by a call to SSL_get1_groups() or SSL_get_shared_group(). so if you got an id from one of those, this is the girl that turns it into a name fr fr.

👑 RETURN VALUES 👑

if it returns something non-NULL, you're winning: SSL_group_to_name() hands you the TLS group name that corresponds to the given id, as a NUL-terminated string ✨

if SSL_group_to_name() returns NULL, then an error happened 😭 — possibly because no corresponding tlsname was registered during provider initialisation. so no vibes were found, basically.

⚠️ also, important: the return value is valid only during the lifetime of the SSL object ssl. so do not go holding onto that pointer after the SSL object's gone, bestie. that's giving undefined-behaviour energy and we do not claim it 🙈

🌈 SEE ALSO 🌈

like, go read that one too, it's the whole vibe iykyk 🫶

Copyright 2021-2024 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, periodt 💅 mwah. this was OpenSSL 4.0.3, dated 2026-09-29, page SSL_GROUP_TO_NAME(3SSL) — thanks for reading, love u, go call SSL_group_to_name() responsibly 🎀🌈⭐

📦 where this page comes from