SSL_GROUP_TO_NAME(3ossl)

📦 version 3.5.0, in opensuse-leap 16.0

💅 SSL_GROUP_TO_NAME — get name of group

okay so real talk, bestie: this is the 3ossl manual page for SSL_group_to_name, and it's honestly one of the shorter ones — a little snack, not a whole meal. but it's important so let's go 💖

✨ SYNOPSIS ✨

#include <openssl/ssl.h>

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

that's it. two lines. we love a low-effort icon 🎀

🌸 DESCRIPTION 🌸

SSL_group_to_name() is the function you call when you've got a TLS group ID (just a number, kinda boring, no personality) and you want the actual TLS group name that goes with it — the cute little string version, basically.

where do these names come from? from providers, bestie 💅 — either the built-in ones or external providers. they get registered during provider initialisation, and that's how this lookup even knows what to tell you.

and like, you probably got that id from somewhere legit, right? specifically from a call to SSL_get1_groups() or SSL_get_shared_group(). that's the vibe — those are the functions handing you the IDs in the first place. iykyk 🦋

🔥 RETURN VALUES 🔥

so if things went well and the return is non-NULL, you get back the TLS group name that corresponds to the given id, as a NUL-terminated string. slay. 🎀

if SSL_group_to_name() returns NULL, that means an error happened — and honestly it might just be that no corresponding tlsname was ever registered during provider initialisation. like, nobody introduced them. awkward. 😭

⚠️ heads up, bestie: the return value is only valid during the lifetime of the SSL object ssl. the moment that object's gone, the string's gone too — do NOT hold onto it and act surprised later. 🫶

🌈 SEE ALSO 🌈

that's the whole list. iconic minimalism. 👑

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

okay that's the whole page, you're officially educated 🧚 this was version 3.5.0, dated 2026-09-25 — go forth and get those group names, bestie, and remember: the string is borrowed, not yours 💅✨⭐

📦 where this page comes from