gnutls_pubkey_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_pubkey_import_gost_raw — the glow-up your raw GOST key deserves 💖

okay bestie, this one lives in the gnutls manual, and it's literally the moment a pile of raw GOST numbers becomes a real, whole gnutls_pubkey_t. no cap. 🦋

✨ NAME ✨

gnutls_pubkey_import_gost_raw — API function

it's giving "raw coordinates in, fancy key object out." 💅

🌸 SYNOPSIS 🌸

#include <gnutls/abstract.h>

int gnutls_pubkey_import_gost_raw(gnutls_pubkey_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);

look at her. six arguments. main character energy fr fr. 👑

🎀 ARGUMENTS 🎀

  • gnutls_pubkey_t key — the structure where the parsed key gets stored, like a little jewelry box for your public key 💎
  • gnutls_ecc_curve_t curve — holds the curve
  • gnutls_digest_algorithm_t digest — holds the digest
  • gnutls_gost_paramset_t paramset — holds the parameters id
  • const gnutls_datum_t * x — holds the x-coordinate
  • const gnutls_datum_t * y — holds the y-coordinate

six little besties walking into a function together, iconic. ✨

🦋 DESCRIPTION 🦋

so this function will convert the given GOST public key's parameters into a gnutls_pubkey_t. the output gets stored in key. 🌈

about that digest though — she has exactly three acceptable values, bestie, and you need to pick one of them:

  • GNUTLS_DIG_GOSR_94
  • GNUTLS_DIG_STREEBOG_256
  • GNUTLS_DIG_STREEBOG_512

(those are copied straight from the source, so yes, GNUTLS_DIG_GOSR_94 is spelled exactly like that — don't come for me, I'm just the messenger 😭)

and if paramset is set to GNUTLS_GOST_PARAMSET_UNKNOWN, then a default one will be selected for you, depending on digest. the function is literally doing your homework. 🫶

⚠️ NOTE ⚠️

parameters should be stored with least significant byte first. and heads up — on version 3.6.3, big-endian format was used incorrectly. so like, vintage behavior, but not the cute kind. 💀

🌟 RETURNS 🌟

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value — and we do not love that for us. 😭

⭐ SINCE ⭐

3.6.3

she's been here since 3.6.3 and she has been serving ever since. 💜

🙈 REPORTING BUGS 🙈

found a bug? don't be shy, tell the devs:

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, bestie. 🎀

🔍 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, no crumbs left. 💅 this gorgeous little number comes to you from gnutls 3.8.13 — mwah, take care of her, she's doing her best. 🧚✨💖

📦 where this page comes from