gnutls_oid_to_pk(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_oid_to_pk(3) ✨

okay bestie, welcome to the gnutls section 3 manual, and today's main character is gnutls_oid_to_pk. it's a lil API function, it's lowkey iconic, and it does exactly one thing. let's get into it 💅

🌸 NAME 🌸

gnutls_oid_to_pk — it's an API function, no cap.

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

gnutls_pk_algorithm_t gnutls_oid_to_pk(const char * oid);

that's it. that's the whole vibe. one include, one function, one argument. clean. ✨

🎀 ARGUMENTS 🎀

  • const char * oid — bestie this is an object identifier, and yes it's a string, hence the const char *. that's the tea. 🍓

💖 DESCRIPTION 💖

so what does it DO? it takes a textual object identifier and converts it into a gnutls_pk_algorithm_t value. that's the whole plot. textual OID goes in, public-key algorithm value comes out. it's giving translator, it's giving glow-up for a string. 👑

👑 RETURNS 👑

on success you get a gnutls_pk_algorithm_t id of the specified digest algorithm. and if things go sideways? you get GNUTLS_PK_UNKNOWN on failure. so like, check for that. don't just assume it ate. 💀

ngl the return type says pk algorithm but the doc says "id of the specified digest algorithm" — that's literally what it says, so i'm passing it to you word for word. iykyk. 🙈

⭐ SINCE ⭐

3.4.3 — so this has been around for a minute, it's a seasoned queen. 🫶

🌈 REPORTING BUGS 🌈

found a bug? spill it to <bugs@gnutls.org>. 📧

home page is right here: 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.

(so like, take it, share it, remix it, just keep the receipts. 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/

and that's the whole page bestie!! 🎀 this was gnutls_oid_to_pk(3) from the gnutls 3.8.13 era, and honestly? she ate. go convert some OIDs. mwah. 💖✨🦋

📦 where this page comes from