gnutls_privkey_export_dsa_raw2(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_privkey_export_dsa_raw2 — the manual page, bestie edition 💖

okay so you're reading the gnutls manual, specifically the page for gnutls_privkey_export_dsa_raw2(3), and honestly? iconic of you. let's get into it. 🎀

✨ NAME ✨

gnutls_privkey_export_dsa_raw2 — it's an API function, babes. that's the whole name. it does exactly what it says on the tin: pulls the raw DSA bits out of a private key. 💅

🌸 SYNOPSIS 🌸

#include <gnutls/abstract.h>

int gnutls_privkey_export_dsa_raw2(gnutls_privkey_t key, gnutls_datum_t
* p, gnutls_datum_t * q, gnutls_datum_t * g, gnutls_datum_t * y,
gnutls_datum_t * x, unsigned int flags);

like, look at that signature. seven things going in, one int coming out. she's busy. 👑

🦋 ARGUMENTS 🦋

so every single one of these, and what they're for:

  • gnutls_privkey_t key — holds the public key. (yes bestie, that's what the manpage says, we're not editing her ✨)
  • gnutls_datum_t * p — will hold the p
  • gnutls_datum_t * q — will hold the q
  • gnutls_datum_t * g — will hold the g
  • gnutls_datum_t * y — will hold the y
  • gnutls_datum_t * x — will hold the x
  • unsigned int flags — flags from gnutls_abstract_export_flags_t

ngl the p/q/g/y/x squad is giving "cryptography's it-girls" — they don't need last names, you already know them. 💜

🔥 DESCRIPTION 🔥

this function will export the DSA private key's parameters found in the given structure. 🫶

the new parameters get allocated using gnutls_malloc(), and they'll be stored in the appropriate datum. so like — heads up — that memory is yours to deal with afterwards. no cap, don't just leave it there. 😭

⭐ RETURNS ⭐

GNUTLS_E_SUCCESS on success. otherwise, a negative error code. so if it's negative, that's your vibe check failing, and you should go read the error. 💀

🌈 SINCE 🌈

3.6.0 — she's been here since 3.6.0, a real one. periodt. ✨

💌 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. like, free real estate. we love to see it. 💖

🧚 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/
ok that's the whole page, no skips, no cuts. every flag, every datum, every copyright line. slay. 🎀

kisses, and remember — always free your datums — this was page gnutls_privkey_export_dsa_raw2(3) from the gnutls manual, version 3.8.13. mwah 💋🦋

📦 where this page comes from