gnutls_x509_na...ts_add_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

💖 gnutls_x509_name_constraints_add_excluded — the manual page, but make it make sense 💖

okay so bestie, this is a page from the gnutls manual (section 3, the library-functions girlies 🫶). Today's main character: gnutls_x509_name_constraints_add_excluded, aka the API function that tells a cert "no babe, not these names, excluded, blocked, not invited to the party 🙅‍♀️".

✨ NAME ✨

gnutls_x509_name_constraints_add_excluded — it's an API function, that's the whole vibe 💅

🌸 SYNOPSIS 🌸

like, the shape of it, exactly as written:

#include <gnutls/x509.h>

int
gnutls_x509_name_constraints_add_excluded(gnutls_x509_name_constraints_t
nc, gnutls_x509_subject_alt_name_t type, const gnutls_datum_t * name);

🎀 ARGUMENTS 🎀

  • gnutls_x509_name_constraints_t nc — the nameconstraints themselves. the lil container we're adding to, she's the one holding the list 💜
  • gnutls_x509_subject_alt_name_t type — the type of the constraints. which flavour of name are we excluding, bestie? 🌈
  • const gnutls_datum_t * name — the data of the constraints. the actual bytes of the thing being excluded ✨

🦋 DESCRIPTION 🦋

so this function adds a name constraint to the list of excluded constraints. excluded = "nope, not you, never you" 🚫💖

the constraints type can be any of the following types, and yes, all of them, no skipping:

  • GNUTLS_SAN_DNSNAME
  • GNUTLS_SAN_RFC822NAME
  • GNUTLS_SAN_DN
  • GNUTLS_SAN_URI
  • GNUTLS_SAN_IPADDRESS

and for that last one, GNUTLS_SAN_IPADDRESS, listen closely bestie because this is the part people fumble: an IP address in network byte order is expected, followed by its network mask — which is 4 bytes in IPv4 or 16 bytes in IPv6. so it's the address and the mask, glued together, in that order. do not freestyle this. i'm begging 🙈

⭐ RETURNS ⭐

  • on success, GNUTLS_E_SUCCESS (0) is returned 🎉
  • otherwise, a negative error value. so like, if it's negative, something went wrong, periodt 💀

🌟 SINCE 🌟

3.3.0 — she's been here a minute, an icon of longevity 👑

🫶 REPORTING BUGS 🫶

found a bug? don't suffer in silence, tell the devs:

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 keep it exactly as-is, 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/
💡 friendly reminder from me to you: everything above is straight from the real page — i just gave it a glow-up, not a rewrite of the facts. go forth and exclude responsibly 🧚‍♀️

and that's a wrap, bestie 🎀 this was gnutls version 3.8.13, section 3, page gnutls_x509_na...ts_add_excluded(3) — the truncated-header girlies know the vibe, iykyk 💅✨ slay, bye 🦋

📦 where this page comes from