gnutls_certificate_set_dh_params(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_certificate_set_dh_params(3) 💅

okay bestie, welcome to the gnutls manual, specifically the page for gnutls_certificate_set_dh_params(3). it's an API function and it's giving "short but important", so let's get into it 🫶

✨ NAME ✨

gnutls_certificate_set_dh_params — it's an API function, bestie. that's the whole name. no notes. 💅

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

void gnutls_certificate_set_dh_params(gnutls_certificate_credentials_t
res, gnutls_dh_params_t dh_params);

like, it's a void function, so it doesn't hand you anything back. it just does the thing. very "no thoughts, just vibes" of it honestly ✨

🦋 ARGUMENTS 🦋

  • gnutls_certificate_credentials_t res — this one is a gnutls_certificate_credentials_t type. it's the credentials handle you're blessing with these parameters 💖
  • gnutls_dh_params_t dh_params — the Diffie-Hellman parameters. the actual DH lore. 🌸

💜 DESCRIPTION 💜

so what does this even do? this function sets the Diffie-Hellman parameters for a certificate server to use. those parameters get used in Ephemeral Diffie-Hellman cipher suites. iconic behavior, truly. 👑

but okay, listen, this part matters and i need you to actually read it:

Note that only a pointer to the parameters is stored in the certificate handle. so you must not deallocate the parameters before the certificate is deallocated. like, do NOT free that thing early, bestie, i am begging 😭 that's a whole use-after-free situation and we do not claim that energy.

💀 DEPRECATED 💀

yeah so... this function is unnecessary and discouraged on GnuTLS 3.6.0 or later. it's giving legacy. 🙈

since 3.6.0, DH parameters are negotiated following RFC7919. so if you're on a newer GnuTLS, this whole function is basically a "thanks, but no thanks" situation. periodt. 💅

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, tell the gnutls girlies:

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.

(translation: share it, remix it, just keep the receipts. that's the license, bestie, it's very generous of them 🫶)

👀 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 page!! you made it to the end, i'm so proud of you 🥹 this was gnutls 3.8.13, from the gnutls manual set, and honestly? she ate. go read the Texinfo manual if you want the full saga. mwah 💋✨💖

📦 where this page comes from