gnutls_pk_to_sign(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_pk_to_sign — the manual page, but make it make sense 💖

okay bestie, so this is gnutls_pk_to_sign(3), and it lives in the gnutls manual section 3 (that's the library-functions girlies, iykyk). it's literally one of the shortest little functions in the whole gnutls family and honestly? she's an icon for that. tiny, does one job, serves. let's get into it 🌸

✨ NAME ✨

gnutls_pk_to_sign — API function 🫶

✨ SYNOPSIS ✨

the way you just include the header and call her:

#include <gnutls/gnutls.h>

gnutls_sign_algorithm_t gnutls_pk_to_sign(gnutls_pk_algorithm_t pk,
gnutls_digest_algorithm_t hash);

like. look at those types. gnutls_pk_algorithm_t in, gnutls_digest_algorithm_t in, gnutls_sign_algorithm_t out. a whole glow-up pipeline 💅

✨ ARGUMENTS ✨

  • gnutls_pk_algorithm_t pk — is a public key algorithm. yes girl, the key kind. the "how do we do the crypto" kind 🔑
  • gnutls_digest_algorithm_t hash — a hash algorithm. the little blender that smushes your data into a fixed-size thingy 🍓

✨ DESCRIPTION ✨

so what does she actually do? this function maps public key and hash algorithms combinations to signature algorithms. that's it. that's the whole vibe. you hand her a key algo + a hash algo, she hands you back the signature algo that combo corresponds to. matchmaker energy fr fr 💖

✨ RETURNS ✨

she returns a gnutls_sign_algorithm_t value, or GNUTLS_SIGN_UNKNOWN on error. so if you get GNUTLS_SIGN_UNKNOWN back, that's not a vibe — that combo just doesn't map to anything, bestie 😭

not me getting GNUTLS_SIGN_UNKNOWN and pretending everything's fine 💀 always check your return value, okay? okay.

✨ REPORTING BUGS ✨

found something cursed? tell the gnutls girlies directly:

they wanna hear it, no cap 🙈

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 legal fairy dust ✨ keep the notice, keep the notice, periodt.)

✨ 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, go visit:

https://www.gnutls.org/manual/

like, actually go read it, she's thorough 👑

and that's the whole page, bestie!! short king of a manpage, we love her. this one's from gnutls 3.8.13, sitting in the gnutls manual, and it was hand-delivered to your terminal with love 💜 stay hydrated, read your return values, and go map some algorithms 🦋

📦 where this page comes from