gnutls_x509_crl_get_issuer_dn2(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_dn2(3) ✨

okay bestie, we're in the gnutls manual, section 3, and today's main character is gnutls_x509_crl_get_issuer_dn2. yes the name is a mouthful. no we are not abbreviating it. it's iconic like that 💅

🌸 NAME 🌸

gnutls_x509_crl_get_issuer_dn2 — an API function, obviously 💖

🦋 SYNOPSIS 🦋

#include <gnutls/x509.h>

int gnutls_x509_crl_get_issuer_dn2(gnutls_x509_crl_t crl, gnutls_datum_t
*dn);

look at her. gorgeous. two args. no notes. 🫶

🎀 ARGUMENTS 🎀

  • gnutls_x509_crl_t crl — bestie this is supposed to hold a gnutls_x509_crl_t type. like, that's the whole vibe of this slot. it's your CRL.
  • gnutls_datum_t * dn — a pointer to a struct that's gonna hold the name. and listen, listen: you MUST free it using gnutls_free(). not free(). not vibes. gnutls_free(). do not forget or it's giving memory leak 😭

💜 DESCRIPTION 💜

so what does she DO. she allocates a buffer and copies over the name of the CRL issuer. that's it. that's the job. slay. ✨

the name comes out looking like "C=xxxx,O=yyyy,CN=zzzz" — exactly as described in RFC4514. the output string will be ASCII or UTF-8 encoded, and which one you get depends on the certificate data. so like, don't assume, okay? 👑

heads up bestie: this function does NOT output a fully RFC4514 compliant string. if that's what you need, go see gnutls_x509_crl_get_issuer_dn3() instead. iykyk 🧚

⭐ RETURNS ⭐

on success you get GNUTLS_E_SUCCESS (which is 0), and otherwise you get a negative error value. that's the whole deal. if it's negative, something went wrong, and you should go look at it. periodt. 💀

🌈 SINCE 🌈

3.1.10 — an elder. a legend. she's been here. 👑

🙈 REPORTING BUGS 🙈

found a bug? don't be shy, 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, keep the receipts, bestie. 🫶

🦄 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, go visit:

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

okay that's the whole page, you ate it, you understood it, you're a CRL issuer-name-getting legend now 💖 this was gnutls version 3.8.13 talking, mwah, bye bestie 🎀✨

📦 where this page comes from