gnutls_x509_dn_oid_name(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_dn_oid_name ✨

okay bestie, welcome to the gnutls manual page for gnutls_x509_dn_oid_name(3) 💖 this is the one where you feed it an OID and it tells you what that OID is actually called. it's giving "name tag for your certificate fields", and honestly? obsessed. 🌸

🌈 NAME 🌈

gnutls_x509_dn_oid_name — the API function that turns a mystery DN OID into an actual human name, no cap 🎀

🦋 SYNOPSIS 🦋

#include <gnutls/x509.h>

const char * gnutls_x509_dn_oid_name(const char * oid, unsigned int
flags);

like yes, that's the whole thing. two args, one vibe check, and a return value that's either a string or literally NULL. periodt. 💅

🍓 ARGUMENTS 🍓

  • const char * oid — this is your Object Identifier, bestie, and it has to be sitting in a null terminated string. so like, it ends when the \0 says it ends. no exceptions. 🙈
  • unsigned int flags — either 0, or one of the GNUTLS_X509_DN_OID_* crew. that's it, that's the whole menu. ✨

👑 DESCRIPTION 👑

so here's the tea: this function will return the name of a known DN OID. 🫶

and if you slide GNUTLS_X509_DN_OID_RETURN_OID into flags, then — when no descriptive name has been found — this function will just hand you back the given OID instead. it's the "if you can't find a cute nickname, we'll just call them by their government name" energy. 😭 iconic behaviour honestly.

⭐ RETURNS ⭐

a null terminated string 💖 … or NULL otherwise. yes, NULL is a real possibility, so maybe check that before you start printing things, bestie. 💀

🎀 SINCE 🎀

3.0 — she's been here since the beginning of the 3.x era, a true main character. 👑

💜 REPORTING BUGS 💜

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

they literally want to hear from you. 🐛✨

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. 💖 (yes that's a real license line, it's very generous of them, we love that for us.)

🧚 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 gnutls version 3.8.13 bringing you gnutls_x509_dn_oid_name(3) — go name some OIDs, slay, and remember: it's either a string or NULL, so act accordingly. bye pookie 🫶💅🌈

📦 where this page comes from