gnutls_privkey_export_gost_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_gost_raw2 ✨

okay so bestie, we're in the gnutls manual, and this lil page is about gnutls_privkey_export_gost_raw2 — yes it's a whole API function, and yes it's giving very specific crypto girl energy 💅

🌸 NAME 🌸

gnutls_privkey_export_gost_raw2 — it's an API function, bestie. that's the whole vibe.

🦋 SYNOPSIS 🦋

#include <gnutls/abstract.h>

int gnutls_privkey_export_gost_raw2(gnutls_privkey_t key,
gnutls_ecc_curve_t * curve, gnutls_digest_algorithm_t * digest,
gnutls_gost_paramset_t * paramset, gnutls_datum_t * x, gnutls_datum_t *
y, gnutls_datum_t * k, unsigned int flags);

like, look at that signature. it's long. it's iconic. it ate. 🎀

💖 ARGUMENTS 💖

  • gnutls_privkey_t key — this one holds the public key. yes bestie, the public key, that's what it says, we don't question it, we just pass it. 🫶
  • gnutls_ecc_curve_t * curve — this pointer is gonna hold the curve. it's an out-param, so it's catching, not throwing. caught it. ✨
  • gnutls_digest_algorithm_t * digest — will hold the digest. the algorithm one. the hash vibe. 🔥
  • gnutls_gost_paramset_t * paramset — will hold the GOST parameter set ID. very niche, very specific, very her. 👑
  • gnutls_datum_t * x — will hold the x-coordinate. xoxo, x. 💜
  • gnutls_datum_t * y — will hold the y-coordinate. and y is for "y are you asking me to remember all these args" 😭
  • gnutls_datum_t * k — will hold the private key. the actual secret. guard it with your life fr fr 🔐
  • unsigned int flags — flags, and they come from gnutls_abstract_export_flags_t. check the enum, bestie, don't guess. 🌈

🌟 DESCRIPTION 🌟

so what does this function do? it will export the GOST private key's parameters found in the given structure. all of them. the curve, the digest, the paramset, x, y, and k — it's getting all of them out of there and handing them to you.

the new parameters will be allocated using gnutls_malloc(), and they'll be stored in the appropriate datum. so like, heads up: you own that memory now, bestie, gnutls_malloc() means you're responsible for the cleanup later. no cap. 🧚

⚠️ NOTE ⚠️

the parameters will be stored with least significant byte first.

and listen — on version 3.6.3 this was incorrectly returned in big-endian format. so if you're on that version, that's the bug, that's not you, it was never you. 💀

⭐ RETURNS ⭐

GNUTLS_E_SUCCESS on success — slay 🎉

otherwise, a negative error code. so like, vibe check your return value, always. 🙈

🎀 SINCE 🎀

3.6.3 — she's been here a minute. periodt.

📣 REPORTING BUGS 📣

found a bug? don't suffer in silence, bestie:

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. (free to share, 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!! this was gnutls 3.8.13, from the gnutls crew, and gnutls_privkey_export_gost_raw2(3) said everything she needed to say. go forth and export responsibly 💅✨🦋

📦 where this page comes from