GNUTLS_X509_EXT_IMPORT_SUBJECT_ALT_NAMES(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_ext_import_subject_alt_names(3) — the gnutls manual, but make it make sense 💖

okay bestie, sit down, grab your boba 🧋, because we're about to talk about a little function from the gnutls manual that does exactly one thing and does it iconically. it's giving "quiet luxury" of C APIs. no cap.

✨ NAME ✨

gnutls_x509_ext_import_subject_alt_names — it's an API function, bestie. that's the whole job description. 💅

🌸 SYNOPSIS 🌸

#include <gnutls/x509-ext.h>

int gnutls_x509_ext_import_subject_alt_names(const gnutls_datum_t * ext,
gnutls_subject_alt_names_t sans, unsigned int flags);

look at that signature. three args. clean. minimal. main character energy fr fr. 👑

🎀 ARGUMENTS 🎀

  • const gnutls_datum_t * ext — this is the DER-encoded extension data. the raw stuff. the lore, if you will. 🦋
  • gnutls_subject_alt_names_t sans — the alternative names. this is where the good stuff lands. 🍓
  • unsigned int flags — bestie. it should be zero. that's it. that's the flag situation. don't get cute with it. 🚫

💜 DESCRIPTION 💜

so here's the vibe: this function will export the alternative names that live inside the DER-encoded SubjectAltName PKIX extension you handed it, and it drops them into a gnutls_subject_alt_names_t type. ✨

heads up: sans must be initialized. like, actually initialized. don't come to the function with an uninitialized struct, that's not the move. 😭

and here's the sweet part — this function will succeed even if there are no subject alternative names in the structure. empty? still slays. still returns success. it's not gonna be dramatic about it. 🫶

🌈 RETURNS 🌈

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value. that's the whole story. if it's negative, something went wrong, and that's on the extension data, not on you (probably). 💀

⭐ SINCE ⭐

3.3.0 — yeah, this one's been around. vintage. iconic. a classic. 🎀

🙈 REPORTING BUGS 🙈

found a bug? spill the tea to the maintainers:

they wanna know. 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. basically: use it, share it, 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, visit:

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

iykyk. go read it. it's worth it. 🌸

and that's the whole page, bestie 🫶 this was gnutls version 3.8.13, from the gnutls manual — thanks for reading, you ate that, periodt. 💅✨

📦 where this page comes from