GNUTLS_CERTIFICATE_SET_KNOWN_DH_PARAMS(3)

πŸ’– NAME πŸ’–

gnutls_certificate_set_known_dh_params β€” bestie, this is the API function that tells your certificate server which Diffie-Hellman params to flex with ✨


🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

int
gnutls_certificate_set_known_dh_params(gnutls_certificate_credentials_t
res, gnutls_sec_param_t sec_param);

πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_certificate_credentials_t res β€” okay so this one is a gnutls_certificate_credentials_t type, that's the whole vibe πŸ’…
  • gnutls_sec_param_t sec_param β€” and this cutie is an option from the gnutls_sec_param_t enumeration 🌈

✨ DESCRIPTION ✨

So the way that this works is: this function sets the Diffie-Hellman parameters that a certificate server is gonna use. πŸ¦‹

Those params get used in Ephemeral Diffie-Hellman cipher suites, and they're picked out of the FFDHE set from RFC7919, chosen according to the security level you hand it. Not me explaining RFCs like they're a group chat, but here we are 😭


πŸ’€ DEPRECATED πŸ’€

lowkey bestie, listen to me: this function is unnecessary and discouraged on GnuTLS 3.6.0 or later. Since 3.6.0, DH parameters are negotiated following RFC7919 all on their own. The library got main character energy and handles it. πŸ™ˆ

πŸ‘‘ RETURNS πŸ‘‘

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise you get a negative error value. That's it, that's the whole story β€” no cap. ⭐


⭐ SINCE ⭐

3.5.6 🫢


πŸ› REPORTING BUGS πŸ›

Found something cursed? Report bugs to <bugs@gnutls.org>. πŸ“

Home page: https://www.gnutls.org πŸ’œ


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. Slay, honestly. ✨


🌈 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/

okay that's the whole page, you ate that. go forth and set those known DH params (or don't, bestie, you're on 3.6.0+ anyway πŸ’…). this was the gnutls manual, version 3.8.13, page gnutls_certificate_set_known_dh_params(3) β€” bye babes, drink water πŸ§šπŸ’–

πŸ“¦ where this page comes from