gnutls_x509_tr...et_issuer_by_dn(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_trust_list_get_issuer_by_dn — the API function that finds ur cert's issuer 💖

okay so bestie, welcome to the gnutls manual, and specifically to gnutls_x509_trust_list_get_issuer_by_dn(3). this one is a whole API function and it's lowkey doing the most important job ever: finding who signed ur cert. let's get into it 🦋

✨ SYNOPSIS ✨

#include <gnutls/x509.h>

int gnutls_x509_trust_list_get_issuer_by_dn(gnutls_x509_trust_list_t
list, const gnutls_datum_t * dn, gnutls_x509_crt_t * issuer, unsigned
int flags);

like yes, it's giving long signature, but it's fine, we'll walk through every single piece 💅

🎀 ARGUMENTS 🎀

  • gnutls_x509_trust_list_t list — bestie this is the list. the trust list u wanna go digging in.
  • const gnutls_datum_t * dn — this is the issuer's DN. the distinguished name we're hunting for 🔍
  • gnutls_x509_crt_t * issuer — this lil guy will hold the issuer if there is any. > heads up: it should be deallocated after use, no cap, don't leave it hanging 😭
  • unsigned int flags — just use zero. that's it. zero. that's the vibe 🫶

🌸 DESCRIPTION 🌸

so what does this function actually do?? it will find the issuer with the given name, and return a copy of the issuer — and that copy must be freed using gnutls_x509_crt_deinit(). yes bestie, it's a copy, so u own it, so u clean it up. main character responsibility ✨

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise u get a negative error value. that's the whole story. zero = slay, negative = not slay 🙈

🌈 SINCE 🌈

3.4.0 — an icon, a legend, been here since 3.4.0 periodt 👑

💜 REPORTING BUGS 💜

found a bug? don't suffer in silence bestie, report it:

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. (translation: go off, share it, 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!! 🎀 this was gnutls 3.8.13, the gnutls_x509_tr...et_issuer_by_dn(3) manual page, and honestly? iconic. go find those issuers. ily, bye 🦋💅✨

📦 where this page comes from