SSL_GROUP_TO_NAME(3ossl)

📦
version 15.1 · 3 versions
, in freebsd 15.1

💅 SSL_GROUP_TO_NAME(3ossl) 💅

okay so this is the manpage for SSL_group_to_name, bestie — it lives in section 3 of the OpenSSL docs. tiny page, huge "wait what's my group called again" energy. let's get into it 🫶

✨ NAME ✨

SSL_group_to_name — get the name of a group. that's it. that's the whole vibe check. 🌸

✨ SYNOPSIS ✨

#include <openssl/ssl.h>

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

like yeah, you include the header, you call the function, you get a const char * back. iconic signature, no notes. 🎀

✨ DESCRIPTION ✨

so SSL_group_to_name() is the glow-up you call when you want the TLS group name that goes with a given TLS group ID. it's giving "i have the id but i need the name for the group chat" 😭

and where do these registered groups even come from?? literally either built-in providers or external providers — they're registered there. and the id you're passing in is the same kind of thing you'd get back from a call to SSL_get1_groups() or SSL_get_shared_group(). so if you got your id from one of those, you're in the right place. pop off. ✨

✨ RETURN VALUES ✨

if it comes back non-NULL, SSL_group_to_name() hands you the TLS group name for that id, as a NUL-terminated string. clean, readable, slay. 💖

if it returns NULL?? that means an error happened — and possibly the reason is that no corresponding tlsname got registered during provider initialisation. so like... the group exists but it forgot its name tag at orientation 🙈

⚠️ okay important one, bestie: the return value is only valid during the lifetime of the SSL object ssl. so do not go stashing that pointer somewhere and using it after the SSL object is gone. it is NOT yours to keep, it is a borrow. no cap. 💀

✨ SEE ALSO ✨

  • ssl(7) — go read it, 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>. 🔥

k that's the whole page, mwah 💋 — this one's from OpenSSL 3.5.6, dated 2026-04-07, and yes the manual name is SSL_GROUP_TO_NAME(3ossl) in case you need to cite your sources 🧚‍♀️💜

📦 where this page comes from