gnutls_x509_ex..._subject_key_id(3)

✨ gnutls_x509_ext_import_subject_key_id ✨

okay bestie, so this one lives in the gnutls manual, section 3, under the very cute abbreviated name gnutls_x509_ex..._subject_key_id(3) (yes the middle got eaten, it's giving βœ‚οΈ, we move on). It's an API function, and it's about pulling a subject key ID out of a DER extension. Let's go πŸ’…


πŸ¦‹ NAME πŸ¦‹

gnutls_x509_ext_import_subject_key_id β€” it's an API function, periodt.


🌸 SYNOPSIS 🌸

#include <gnutls/x509-ext.h>

int gnutls_x509_ext_import_subject_key_id(const gnutls_datum_t * ext,
gnutls_datum_t * id);

like. it's so simple. look at her. iconic πŸŽ€


πŸ’– ARGUMENTS πŸ’–

  • const gnutls_datum_t * ext β€” this is a DER encoded extension. that's the vibe. that's all it is. DER. encoded. extension. no cap.
  • gnutls_datum_t * id β€” she's the output, bestie 🫢 this is where the subject key ID ends up living. will contain the subject key ID.

✨ DESCRIPTION ✨

so what does she actually DO. she will return the subject key ID stored in the provided SubjectKeyIdentifier extension. that's the whole job. the way she just... does it 😭

and listen β€” the ID gets allocated using gnutls_malloc(). so it's yours, okay? you own that memory. it's your child now. take care of it 🧚


⭐ RETURNS ⭐

  • on success, GNUTLS_E_SUCCESS (0) is returned πŸŽ‰ slay
  • GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if the extension is not present β€” like, she looked, bestie, and it's just not there πŸ’€
  • otherwise, a negative error value. yeah. that one's on you, fr fr.

🌈 SINCE 🌈

3.3.0 β€” she's been around a minute, an elder icon πŸ‘‘


πŸ™ˆ REPORTING BUGS πŸ™ˆ

found a bug? not the vibe. report 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. (translation: go off, just keep the receipt 🧾✨)


πŸ“ SEE ALSO πŸ“

the full documentation for gnutls is maintained as a Texinfo manual, iykyk πŸ“š if the /usr/share/doc/gnutls/ directory does not contain the HTML form, then visit:

https://www.gnutls.org/manual/

and that's the whole page, bestie πŸ’œ no gatekeeping, no skipped options, we ate and left no crumbs 🍽️✨

this was gnutls 3.8.13, so if you're out here reading this in the future, just know she said what she said πŸ’… bye!! πŸ¦‹πŸŒˆπŸŽ€

πŸ“¦ where this page comes from