gnutls_x509_crl_get_issuer_dn3(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_crl_get_issuer_dn3 💖

okay bestie, so this is a page from the gnutls manual, and it's all about gnutls_x509_crl_get_issuer_dn3 — yes that's a whole mouthful, but it's literally just "hey, tell me who issued this CRL" 🎀

✨ NAME ✨

gnutls_x509_crl_get_issuer_dn3 — API function

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crl_get_issuer_dn3(gnutls_x509_crl_t crl, gnutls_datum_t
*dn, unsigned flags);

🦋 ARGUMENTS 🦋

  • gnutls_x509_crl_t crl — should contain a gnutls_x509_crl_t type. yeah, it's a CRL, that's the whole point 💅
  • gnutls_datum_t * dn — a pointer to a structure to hold the name; must be freed using gnutls_free() — not me stressing about leaks, but fr fr, free it 🫶
  • unsigned flags — zero or GNUTLS_X509_DN_FLAG_COMPAT. that's the vibe check, pick one 🧚

💜 DESCRIPTION 💜

so this function will allocate a buffer and copy the name of the CRL issuer into it. the name comes out looking like "C=xxxx,O=yyyy,CN=zzzz", exactly as described in RFC4514. and the output string will be ASCII or UTF-8 encoded, depending on the certificate data. so it's giving ✨flexible✨ but you don't get to choose, the cert data chooses for you 😭

when the flag GNUTLS_X509_DN_FLAG_COMPAT is specified, the output format will match the format output by previous to 3.5.6 versions of GnuTLS — which was not not fully RFC4514-compliant. (yes the original says "not not", iconic, we keep it 👑) so basically it's the old-school throwback format for the OGs who need backwards vibes.

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise, a negative error value. so like, zero = slay, negative = 💀

🎀 SINCE 🎀

3.5.7 — yeah she's been around a minute, a real main character ✨

🐛 REPORTING BUGS 🐛

found a bug? don't gatekeep, report it to <bugs@gnutls.org>.

home page: 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. so like, go off, 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/

and that's the whole page bestie, no cap. this lil' baddie shipped with gnutls 3.8.13 — thanks for reading, ily, now go free that gnutls_datum_t 🫶✨💅

📦 where this page comes from