gnutls_x509_na...ts_get_excluded(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

✨ NAME ✨

okay so bestie, welcome to the gnutls manual — this page is all about gnutls_x509_name_constraints_get_excluded, which is an API function 💅 (yes we're in the big leagues now, no cap)

🎀 SYNOPSIS 🎀

#include <gnutls/x509.h>

int
gnutls_x509_name_constraints_get_excluded(gnutls_x509_name_constraints_t
nc, unsigned idx, unsigned * type, gnutls_datum_t * name);

🌸 ARGUMENTS 🌸

  • gnutls_x509_name_constraints_t nc — the extracted name constraints 🫶 like, the whole little bundle of them you already pulled out
  • unsigned idx — the index of the constraint 👑 which one you want, bestie, counting from wherever the list starts
  • unsigned * type — the type of the constraint (of type gnutls_x509_subject_alt_name_t) 🦋 so it tells you what kind of thing this constraint is about
  • gnutls_datum_t * name — the name in the constraint (of the specific type) 💖 the actual name, matching whatever type came back

💜 DESCRIPTION 💜

This function will return an intermediate type containing the name constraints of the provided CA certificate. That structure can be used in combination with gnutls_x509_name_constraints_check() to verify whether a server's name is in accordance with the constraints. ✨ like it's giving "here's the rules, now go check them against this server" energy

The name should be treated as constant and valid for the lifetime of nc . ⚠️ so do NOT go freeing it or messing with it, okay? it lives and dies with nc, periodt.

🔥 RETURNS 🔥

On success, GNUTLS_E_SUCCESS (0) is returned, GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if the extension is not present, otherwise a negative error value.

so like: 0 = slay ✅, GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE = the extension literally isn't there 🙈, and anything negative = something went wrong, read the error, bestie 😭

⭐ SINCE ⭐

3.3.0

🌈 REPORTING BUGS 🌈

Report bugs to <bugs@gnutls.org>.

Home page: https://www.gnutls.org

found a bug? don't be shy, tell the gnutls girlies directly 💌 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.

🦋 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 bestie!! 💅 this was the gnutls manual, version 3.8.13, and yeah the page title up top was lowkey gnutls_x509_na...ts_get_excluded(3) the whole time (truncated and iconic, iykyk) 🎀 go read the rest of the docs, you ate 💖

📦 where this page comes from