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

okay bestie, welcome to the gnutls manual, section 3, and today's main character is gnutls_x509_crl_get_authority_key_id. she's a little function with a big name and one very specific job. let's get into it 💅

✨ NAME ✨

gnutls_x509_crl_get_authority_key_id — an API function, fr fr. that's it, that's the name, it does exactly what it says on the tin 🎀

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crl_get_authority_key_id(gnutls_x509_crl_t crl, void *
id, size_t * id_size, unsigned int * critical);

like yes, it's a whole mouthful of a signature, but she's worth it 🦋

🎀 ARGUMENTS 🎀

  • gnutls_x509_crl_t crl — should contain a gnutls_x509_crl_t type. that's the CRL you're poking at, bestie 💜
  • void * id — the place where the identifier will be copied. this is where the good stuff lands ✨
  • size_t * id_size — holds the size of the result field. so she knows how much room she's got to work with 🫶
  • unsigned int * critical — will be non-zero if the extension is marked as critical. and ngl? she may be null 🙈 (yes, nullable, you're welcome)

💀 DESCRIPTION 💀

so, what does she actually do. this function will return the CRL authority's key identifier 🔑

and where does that come from? the X.509 Authority Key identifier extension field, aka 2.5.29.35 — write that number down, it's giving very specific 🌈

⚠️ okay important caveat time, no cap: this function only returns the keyIdentifier field of the extension, and it'll hand you GNUTLS_E_X509_UNSUPPORTED_EXTENSION if the extension contains the name and serial number of the certificate instead. in that case, gnutls_x509_crl_get_authority_key_gn_serial() may be used. so if you hit that error, don't panic — just switch functions, she's got a sister for that 😭💖

👑 RETURNS 👑

on success, GNUTLS_E_SUCCESS (0) is returned 🎉 otherwise a negative error code in case of an error. so basically: zero = slay, negative = not slay 💅

⭐ SINCE ⭐

2.8.0 — she's been around, an icon, a veteran, a legend 🫶

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, tell the gnutls girlies:

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 license, and it's honestly so generous of them, we love to see it 💚

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

okay that's the whole page, you ate that, go forth and read your CRL authority key ids responsibly 🦋✨

this has been the gnutls manual, section 3, version 3.8.13, brought to you with love, glitter, and zero skipped details 💖 stay iconic, bestie 🎀

📦 where this page comes from