gnutls_x509_ex...uthority_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_ex...uthority_key_id ✨

okay bestie, welcome to the gnutls manual, section 3, and today we're decoding an Authority Key Identifier extension like the absolute main character you are 💅 this page lives in the gnutls manual and it's short, sweet, and lowkey iconic.

🌸 NAME 🌸

gnutls_x509_ext_import_authority_key_id — it's an API function, bestie. that's the whole name. that's the job. 🎀

🦋 SYNOPSIS 🦋

#include <gnutls/x509-ext.h>

int gnutls_x509_ext_import_authority_key_id(const gnutls_datum_t * ext,
gnutls_x509_aki_t aki, unsigned int flags);

like look at that signature. it's giving three arguments and a dream ✨

💖 ARGUMENTS 💖

  • const gnutls_datum_t * ext — a DER encoded extension. yes, DER. raw bytes energy. keep it exactly as-is, no vibes-based editing 🙈
  • gnutls_x509_aki_t aki — an initialized authority key identifier type. key word: initialized. do not come to this function with an uninitialized aki, that's not the move bestie 😭
  • unsigned int flags — should be zero. that's it. zero. nothing else. don't be quirky with it 💀

🎀 DESCRIPTION 🎀

so what does this actually do? this function will return the subject key ID stored in the provided AuthorityKeyIdentifier extension. that's literally the whole thing. the way that it just... hands you the subject key ID out of the extension you passed in 🫶

⭐ RETURNS ⭐

  • on success, GNUTLS_E_SUCCESS (0) is returned — slay, zero, we love a zero 💚
  • GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if the extension is not present — like, not there, not happening, go home 🚫
  • otherwise, a negative error value — and ngl you should actually check for that one, bestie

🌈 SINCE 🌈

3.3.0 — so this has been around for a minute. certified classic. periodt 💅

💜 REPORTING BUGS 💜

found a bug? not to be dramatic but report it, fr fr:

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 tea and we're keeping it exactly as written, no cap 🧚)

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

ok that's the whole page, bestie. no options were skipped, no return values got left on read, no details ghosted. every single one made it through the vibe check 💖

later babes ✌️ this was gnutls manual, version 3.8.13, page gnutls_x509_ex...uthority_key_id(3) — go read the rest of the manual, it's highkey worth it 🌸✨

📦 where this page comes from