gnutls_x509_crt_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_crt_get_issuer_dn2(3) 💖

okay bestie, welcome to the gnutls manual, section 3 ✨ this one's all about pulling the issuer name off a certificate, and it's honestly kind of a glow-up function 🫶

🌸 NAME 🌸

gnutls_x509_crt_get_issuer_dn2 — API function 👑

✨ SYNOPSIS ✨

#include <gnutls/x509.h>

int gnutls_x509_crt_get_issuer_dn2(gnutls_x509_crt_t cert,
gnutls_datum_t * dn);

🎀 ARGUMENTS 🎀

  • gnutls_x509_crt_t cert — this one should contain a gnutls_x509_crt_t type, like, that's its whole job 💅
  • gnutls_datum_t * dn — a pointer to a structure that's gonna hold the name. heads up bestie, you must free it using gnutls_free() — no leaving it hanging, that's not the vibe 🙈

🦋 DESCRIPTION 🦋

So this function will allocate a buffer and copy the name of the issuer of the Certificate. slay. 🌈

The name comes out in the form "C=xxxx,O=yyyy,CN=zzzz", exactly as described in RFC4514. The output string is ASCII or UTF-8 encoded, depending on what the certificate data is giving 🍓

⚠️ but real talk — this function does not output a fully RFC4514 compliant string. if that's what you need, go see gnutls_x509_crt_get_issuer_dn3() instead. iykyk 😭

💜 RETURNS 💜

On success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value, and that's your sign something went sideways 💀

⭐ SINCE ⭐

3.1.10 — she's been iconic since way back, no cap 👑

🎀 REPORTING BUGS 🎀

Report bugs 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. 🫶

💖 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 ✨ this was gnutls_x509_crt_get_issuer_dn2(3) from the gnutls manual, version 3.8.13 — go read your certs' issuer names responsibly, mwah 💅🎀💖

📦 where this page comes from