gnutls_dh_get_prime_bits(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

✨ gnutls_dh_get_prime_bits ✨

okay bestie, welcome to the gnutls manual, we're doing the whole tour 💖 this one's a little function that tells you how thicc your Diffie-Hellman prime was. iconic behaviour honestly.

🎀 NAME 🎀

gnutls_dh_get_prime_bits — an API function, and yes it does exactly what the name says 🌸

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

int gnutls_dh_get_prime_bits(gnutls_session_t session);

🌈 ARGUMENTS 🌈

  • gnutls_session_t session — it's a gnutls session, babes. that's the whole vibe. hand it your session and it'll spill the tea 🫖

💅 DESCRIPTION 💅

so this function returns the bits of the prime that got used in the last Diffie-Hellman key exchange with the peer. main character energy ✨

use it for both anonymous and ephemeral Diffie-Hellman, fr fr, it's got you either way 🫶

⚠️ but listen — some ciphers, like RSA and DSA without DHE, literally do not do a Diffie-Hellman key exchange at all. so for those, this function just returns 0. not a bug, just not that kind of party 💀

⭐ RETURNS ⭐

you get the Diffie-Hellman bit strength back, slay 👑

  • if no Diffie-Hellman key exchange was done → it returns 0
  • if things go sideways → it returns a negative error code 😭

🙈 REPORTING BUGS 🙈

found something cursed? report bugs to <bugs@gnutls.org> and they'll handle it 💌

home page: https://www.gnutls.org — go say hi 🌐

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. (basically: go off, just keep the receipts 🧾✨)

🔍 SEE ALSO 🔍

the full documentation for gnutls is maintained as a Texinfo manual. if the /usr/share/doc/gnutls/ directory does not contain the HTML form, visit:

https://www.gnutls.org/manual/

and that's the whole page bestie, no notes 💅

this was gnutls version 3.8.13, and the page itself goes by gnutls_dh_get_prime_bits(3) — mwah, take care of her 🎀💖🦋

📦 where this page comes from