gnutls_dh_params_export_pkcs3(3)

✨ gnutls_dh_params_export_pkcs3(3) ✨

okay bestie, welcome to the gnutls manual, section 3 — this is the one about gnutls_dh_params_export_pkcs3, and yes it's a whole API function, and yes it's lowkey iconic 💅

---

🌸 NAME 🌸

gnutls_dh_params_export_pkcs3 — an API function, no cap. it takes your DH params and yeets them out into PKCS3 format 🦋

---

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

int gnutls_dh_params_export_pkcs3(gnutls_dh_params_t params,
gnutls_x509_crt_fmt_t format, unsigned char * params_data, size_t *
params_data_size);

like literally just include <gnutls/gnutls.h> and you're in 💖

---

⭐ ARGUMENTS ⭐

• gnutls_dh_params_t params — this is where your DH parameters live. it holds them. that's its whole job 🫶
• gnutls_x509_crt_fmt_t format — the format you want the output in. it's one of PEM or DER, pick your fighter ✨
• unsigned char * params_data — this buffer is gonna contain a PKCS3 DHParams structure, encoded as PEM or DER 🌈
• size_t * params_data_size — holds the size of params_data going in, and gets replaced by the actual size of the parameters coming out. it's giving glow-up, it changes 🔥

---

💜 DESCRIPTION 💜

so what does this function actually do? it exports the dh parameters you hand it into a PKCS3 DHParams structure. and not just any random format — this is the exact format that the "openssl dhparam" tool generates, so you know it's legit 👑

and here's the thing: if the buffer you provided is not long enough to hold the output, you're not getting a silent truncation situation, no ma'am — instead GNUTLS_E_SHORT_MEMORY_BUFFER gets returned, and you go make your buffer bigger 💀

also, if the structure ends up PEM encoded, it will have a header of "BEGIN DH PARAMETERS". periodt. that's the header. don't argue with it 🎀

---

🦋 RETURNS 🦋

on success, GNUTLS_E_SUCCESS (0) is returned. slay ✨ otherwise you get a negative error code back, which is the universe telling you something went wrong 😭

---

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, bestie — report it to <bugs@gnutls.org>. 📧

home page: https://www.gnutls.org — go, look, it's giving official 🌐

---

👑 COPYRIGHT 👑

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. fr fr, go forth and redistribute 💖

---

🌟 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 🫶 this came to you from gnutls, version 3.8.13, and it's gnutls_dh_params_export_pkcs3(3) — go export those params, you're the main character now 💅✨