gnutls_x509_pr...import_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_import_gost_raw(3) — the gnutls manual, but make it make sense 🦋

okay bestie, so this page lives in the gnutls manual, and it's all about one little function that scoops up a GOST private key and drops it into gnutls's own ✨native✨ format. let's get into it 💅

✨ NAME ✨

gnutls_x509_privkey_import_gost_raw — it's an API function, and yes it's exactly as niche as it sounds 🎀

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_privkey_import_gost_raw(gnutls_x509_privkey_t key,
gnutls_ecc_curve_t curve, gnutls_digest_algorithm_t digest,
gnutls_gost_paramset_t paramset, const gnutls_datum_t * x, const
gnutls_datum_t * y, const gnutls_datum_t * k);

she takes seven whole arguments, no cap. hydrate before reading 🫶

🎀 ARGUMENTS 🎀

  • gnutls_x509_privkey_t key — this is the data that stores the parsed key, i.e. where the good stuff ends up 💖
  • gnutls_ecc_curve_t curve — holds the curve, periodt
  • gnutls_digest_algorithm_t digest — will hold the digest
  • gnutls_gost_paramset_t paramset — will hold the GOST parameter set ID
  • const gnutls_datum_t * x — holds the x-coordinate 📍
  • const gnutls_datum_t * y — holds the y-coordinate 📍
  • const gnutls_datum_t * k — holds the k, aka the private key 🤫

💜 DESCRIPTION 💜

so this function takes the given GOST private key's parameters and converts them into the native gnutls_x509_privkey_t format. the glow-up happens in place — the output gets stored in key 💫

about digest: it should be one of GNUTLS_DIG_GOSR_94, GNUTLS_DIG_STREEBOG_256 or GNUTLS_DIG_STREEBOG_512. pick one, bestie, that's the whole menu 🍓

and if paramset is set to GNUTLS_GOST_PARAMSET_UNKNOWN, a default one gets selected depending on digest. so like, it'll figure out the vibe for you ✨

⚠️ NOTE ⚠️

parameters should be stored with least significant byte first. on version 3.6.3 big-endian format was used incorrectly. 💀

so yeah. if you're dealing with old 3.6.3 era data, that byte order is giving chaos. be careful, fr fr.

🔥 RETURNS 🔥

on success, GNUTLS_E_SUCCESS (0) is returned 🎉 otherwise you get a negative error value. sad girl hours 😭

⭐ SINCE ⭐

3.6.3 — she's been here a minute 👑

🌈 REPORTING BUGS 🌈

found a bug? don't gatekeep it, report it 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. iconic behavior 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/

and that's the whole page, bestie 💖 this was the gnutls manual, version 3.8.13 — go forth and import your GOST keys correctly, mwah 💅✨🎀

📦 where this page comes from