SSL_GET0_GROUP_NAME(3SSL)

📦
version 4.0.3 · 6 versions
, in ubuntu stonking

💖 SSL_GET0_GROUP_NAME 💖

okay bestie, welcome to the OpenSSL 3SSL section of the manual, and today's main character is SSL_get0_group_name ✨ she's a little function with a big job and honestly? she ate.

🌸 NAME 🌸

SSL_get0_group_name — get the name of the group that was used for the key agreement of the current TLS session establishment 🎀

like. she tells you which group y'all agreed on. that's it. that's the whole vibe. no cap.

🦋 SYNOPSIS 🦋

#include <openssl/ssl.h>

const char *SSL_get0_group_name(SSL *s);

literally two lines. iconic. she's lowkey minimal and we respect it 💅

🌈 DESCRIPTION 🌈

so here's the tea ☕ — SSL_get0_group_name() returns the name of the group that was used for the key agreement of the current TLS session establishment.

that's it, that's the function. she's not complicated, she's not doing too much, she just knows what group got picked during the handshake and she's ready to spill 🫶

⭐ RETURN VALUES ⭐

here's where you gotta pay attention bestie, because the return value does a little bit of a duality thing:

  • if she returns something non-NULL, SSL_get0_group_name() is giving you the name of the group that was used for the key agreement of the current TLS session establishment. slay 🎉
  • if SSL_get0_group_name() returns NULL, an error occurred — possibly no TLS session has been established yet 🙈. see also SSL_get_negotiated_group(3) if you need to go deeper, iykyk.
⚠️ ok this part is important and it's giving serious caution-tape energy: the return value is valid only during the lifetime of the SSL object ssl. so do NOT go holding onto that pointer like it's your emotional support string after the SSL object has dipped. she's a guest star, not a series regular. 💀

👑 SEE ALSO 👑

💜 HISTORY 💜

this function was added in OpenSSL 3.2. so if you're on something older, she simply does not exist yet and you're gonna get a whole different kind of error, fr fr 🌸

Copyright 2023-2025 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 🌟 OpenSSL 4.0.3, dated 2026-09-29, manual page SSL_GET0_GROUP_NAME(3SSL) — go forth and query your groups responsibly 💖✨🦋

📦 where this page comes from