gnutls_x509_pr...export_gost_raw(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_x509_privkey_export_gost_raw 💖

okay bestie, sit down, we're doing a gnutls moment 🎀 this one lives in the gnutls manual (section 3, the library-call girlies) and it's an API function that gets your GOST private key params out of a key struct. no cap. let's go ✨

✨ NAME ✨

gnutls_x509_privkey_export_gost_raw — API function 💅

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_privkey_export_gost_raw(gnutls_x509_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);

like, seven arguments, she's high maintenance and that's iconic 💅

🦋 ARGUMENTS 🦋

  • gnutls_x509_privkey_t key — a key 🔑 yes literally just a key, that's the whole vibe
  • gnutls_ecc_curve_t * curve — will hold the curve 🌈
  • gnutls_digest_algorithm_t * digest — will hold the digest 🍓
  • gnutls_gost_paramset_t * paramset — will hold the GOST parameter set ID 👑
  • gnutls_datum_t * x — will hold the x-coordinate ✨
  • gnutls_datum_t * y — will hold the y-coordinate ✨
  • gnutls_datum_t * k — will hold the private key 🙈 (yes, the secret one, keep it safe bestie)

💜 DESCRIPTION 💜

so this function will export the GOST private key's parameters found in the given structure. the way it just… pulls them out and hands them to you 🫶

the new parameters will be allocated using gnutls_malloc() and will be stored in the appropriate datum. so like, the memory is yours now, act accordingly 💅

⚠️ NOTE ⚠️

parameters will be stored with least significant byte first. on version 3.6.3 this was incorrectly returned in big-endian format. not me calling out a 3.6.3 bug 😭 they fixed it, we move on, periodt.

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. so like, zero = slay, negative = something went wrong 💀

🎀 SINCE 🎀

3.6.3 — she's been here a minute, respect the elder 💖

🐛 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. (basically: go off, just keep the receipt 🧾✨)

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

iykyk 📚

and that's the whole page bestie, no crumbs left 🍓 this was gnutls 3.8.13, dated right there in the footer with gnutls_x509_pr...export_gost_raw(3) — mwah, go export some GOST params, you've got this 💅✨🦋

📦 where this page comes from