gnutls_x509_aia_get(3)

💖 gnutls_x509_aia_get — the glow-up guide 💖

okay bestie, so this is a page from the gnutls manual, and it's all about one little function that lives in gnutls/x509-ext.h. it's called gnutls_x509_aia_get, and no cap, it's the vibe check you run on the Authority Information Access thing. let's get into it 🫶

---

✨ NAME ✨

gnutls_x509_aia_get — API function. that's it, that's the name, she's simple and she knows it 💅

---

🌸 SYNOPSIS 🌸

#include <gnutls/x509-ext.h>

int gnutls_x509_aia_get(gnutls_x509_aia_t aia, unsigned int seq,
       gnutls_datum_t * oid, unsigned * san_type, gnutls_datum_t * san);

look at her. five whole parameters. iconic behavior honestly ✨

---

🎀 ARGUMENTS 🎀

• gnutls_x509_aia_t aia — the authority info access. yes that's the whole description, she's the main character and needs no introduction 💅
• unsigned int seq — this one tells us which access descriptor in the sequence we're curious about. 0 = the first one, 1 = the second one, etc. like scrolling through your fyp, one at a time 🦋
• gnutls_datum_t * oid — the type of available data. treat it as constant, do NOT go messing with it, she's not yours 🙈
• unsigned * san_type — will hold the type of the name of gnutls_subject_alt_names_t. heads up: this one may be null (that's allowed, she's flexible) ✨
• gnutls_datum_t * san — the access location name. also to be treated as constant, and also may be null. lowkey generous of her to be optional 💖

---

🌈 DESCRIPTION 🌈

so this function reads from the Authority Information Access type. that's the whole job, bestie, she reads. 📖

the seq input parameter is the way you tell her which member of the sequence you're interested in. the first member is 0, the second member 1, and so on forever and ever. it's giving index energy. and when your seq value goes out of bounds? you get GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE back. not an error error, just her politely saying "girl, there's nothing there" 😭

typically, the oid you're dealing with is either GNUTLS_OID_AD_CAISSUERS or GNUTLS_OID_AD_OCSP. those are the two usual suspects, iykyk 👑

---

⭐ RETURNS ⭐

on success? you get GNUTLS_E_SUCCESS (0) and everything is slay. otherwise you get a negative error value, which is the universe telling you to maybe check your inputs 🙈

---

💜 SINCE 💜

3.3.0 — she's been here since 3.3.0, a true veteran of the game 👑

---

🦋 REPORTING BUGS 🦋

found a bug? do NOT suffer in silence, bestie. report it to <bugs@gnutls.org>. 📧

home page: https://www.gnutls.org — that's the link, go check her out 🌐

---

💖 COPYRIGHT 💖

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 yes you can share her around, 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/

go read the full manual, she's got range, no cap 💅

---

and that's the whole page, bestie!! this came from the gnutls manual, version 3.8.13, and it's the gnutls_x509_aia_get(3) page — she ate, left no crumbs, and honestly? we're obsessed 🫶💖✨