GNUTLS_PKCS11_GET_RAW_ISSUER_BY_SUBJECT_KEY_ID(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

✨ NAME ✨

gnutls_pkcs11_get_raw_issuer_by_subject_key_id — bestie, it's an API function 💖

(also hi, this is a page from the gnutls manual, section 3 🎀)

🦋 SYNOPSIS 🦋

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_get_raw_issuer_by_subject_key_id(const char * url,
const gnutls_datum_t * dn, const gnutls_datum_t * spki, gnutls_datum_t *
issuer, gnutls_x509_crt_fmt_t fmt, unsigned int flags);

🌸 ARGUMENTS 🌸

  • const char * url — a PKCS 11 url that identifies a token, like it's pointing at the specific token you're vibing with 💅
  • const gnutls_datum_t * dn — the DN you're searching for. it can be NULL, no pressure, it's optional 🫶
  • const gnutls_datum_t * spki — the subject key ID you're hunting for 🔍
  • gnutls_datum_t * issuer — this one will hold the issuer, if there is one, in an allocated buffer. so like, it hands you the goods ✨
  • gnutls_x509_crt_fmt_t fmt — the format of the exported issuer 🎀
  • unsigned int flags — use zero, or flags from GNUTLS_PKCS11_OBJ_FLAG 🌈

💜 DESCRIPTION 💜

okay so here's the tea ☕ this function will return the certificate with the given DN and spki, if it's stored in the token. fr fr.

by default, only the ones marked as trusted issuers get returned. it's giving exclusive 💅 but if you want any issuer to be returned, you specify GNUTLS_PKCS11_OBJ_FLAG_RETRIEVE_ANY in flags. that's the unlock 🔑

and the reason the function's name includes "issuer"? because it can be used to discover issuers of certificates. iykyk 👑

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value 😭 (as in, a negative number. not negative vibes. well, also negative vibes.)

🎀 SINCE 🎀

3.4.2 — an icon, honestly 👑

🔥 REPORTING BUGS 🔥

found a bug? not you being the main character of QA 🫶 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. periodt ✨

🌈 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/
ngl bestie, if you read this far you're lowkey a PKCS 11 legend 🧚

and that's a wrap on this page from the gnutls manual, version 3.8.13 — slay, stay curious, and may your issuers always be discoverable 💜🌸🦋

📦 where this page comes from