gnutls_x509_privkey_verify_seed(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_verify_seed — the manual page, but make it make sense

okay bestie, so this is a page from the gnutls manual, and it's all about one lil API function called gnutls_x509_privkey_verify_seed. yes the name is a mouthful, we're gonna get through it together 🫶

✨ NAME ✨

gnutls_x509_privkey_verify_seed — it's an API function, bestie, that's literally the whole job description 💅

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_privkey_verify_seed(gnutls_x509_privkey_t key,
gnutls_digest_algorithm_t digest, const void * seed, size_t seed_size);

look at her, she's giving very "I take four arguments and I know exactly what I'm doing" 💖

🎀 ARGUMENTS 🎀

  • gnutls_x509_privkey_t key — this should contain a gnutls_x509_privkey_t type. that's it, that's the requirement, she's not asking for much ✨
  • gnutls_digest_algorithm_t digest — it contains the digest algorithm used for key generation (if applicable). note the "if applicable", she's keeping it flexible 👑
  • const void * seed — the seed of the key to be checked with. yes, seed. we're checking seeds. this is a seed-verification function, the name wasn't lying 🌱
  • size_t seed_size — holds the size of seed. she needs to know how big the thing is, obviously 💅

💖 DESCRIPTION 💖

so what does she actually do?? this function will verify that the given private key was generated from the provided seed. that's the whole vibe check 🔥

and here's the cute part: if seed is NULL, then the seed stored in the key's structure will be used for verification instead. so you can either hand her a seed, or just let her use the one she already has. lowkey convenient 🦋

🌈 RETURNS 🌈

if the verification fails, you get GNUTLS_E_PRIVKEY_VERIFICATION_ERROR back. not great, not terrible, it's just telling you the truth 😭

and on success? you get zero or a positive code. slay, we love a success state 💚

⭐ SINCE ⭐

3.5.0 — she's been around, she's not new here 👑

🐛 REPORTING BUGS 🐛

found a bug?? do NOT suffer in silence bestie, report it:

they want to hear from you fr fr 📬

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. that's the deal, and it's a good deal 🫶

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

go read the full thing, she's thorough and she deserves your attention 💜

and that's the whole page, bestie!! every flag, every argument, every error code, preserved and cherished 💖

this was page from gnutls version 3.8.13 — go off, stay secure, and always verify your seeds ✨🎀💅

📦 where this page comes from