gnutls_x509_aki_get_cert_issuer(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_aki_get_cert_issuer — the manual page, but make it make sense 💅

okay bestie, so this whole thing lives in the gnutls manual, and today we're pulling apart gnutls_x509_aki_get_cert_issuer(3). yes it's a mouthful. yes it's worth it. let's go 🦋

🌸 NAME 🌸

gnutls_x509_aki_get_cert_issuer — lowkey just an API function, but like, a useful one ✨

🎀 SYNOPSIS 🎀

#include <gnutls/x509-ext.h>

int gnutls_x509_aki_get_cert_issuer(gnutls_x509_aki_t aki, unsigned int
seq, unsigned int * san_type, gnutls_datum_t * san, gnutls_datum_t *
othername_oid, gnutls_datum_t * serial);

not me dropping the exact signature so you can copy-paste it fr fr 🙈

💖 ARGUMENTS 💖

  • gnutls_x509_aki_t aki — the authority key ID. that's the thing we're digging through 🕵️‍♀️
  • unsigned int seq — the index of the name you wanna grab. like, which one in the list, bestie
  • unsigned int * san_type — this is where the type of the name gets written (it's one of the gnutls_subject_alt_names_t types) 👑
  • gnutls_datum_t * san — the alternative name data itself
  • gnutls_datum_t * othername_oid — the object identifier, but only if san_type is GNUTLS_SAN_OTHERNAME. otherwise it's giving nothing 💀
  • gnutls_datum_t * serial — the authorityCertSerialNumber number. iconic, we love a serial 🍓

🌈 DESCRIPTION 🌈

so what this function does is: it hands you back one specific authorityCertIssuer name exactly as it's stored in the aki type, plus the authorityCertSerialNumber. two for one, we ate 🔥

important though — all the returned values should be treated as constant. do not go messing with them, they are not yours to edit, periodt. and if you don't need some of them? you can just set those pointers to NULL and they'll be skipped, no drama 💅

⭐ RETURNS ⭐

  • on success you get GNUTLS_E_SUCCESS (which is literally 0) 🫶
  • if your index is out of bounds you get GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE — like, bestie, that name doesn't exist
  • anything else? a negative error value. and negative means bad vibes, obviously 😭

🧚 SINCE 🧚

3.3.0 — she's been around a minute, a true veteran 💜

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, 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. so like, go off, just keep the receipts 🧾✨

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

that's the whole assignment, iykyk 🌈

ok that's the whole page bestie, every flag, every argument, every error code, all of it, no cap 💖

and a lil sign-off for you: this was gnutls 3.8.13, and she said what she said 🎀 stay curious, read your man pages, and slay 💅👑

📦 where this page comes from