gnutls_certifi...et_x509_crl_mem(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_certifi...et_x509_crl_mem — bestie's guide to loading CRLs from memory ✨

okay so this is a page from the gnutls manual, section 3 — yes the name is literally abbreviated with ... in the middle, that's just how these pages roll, don't @ me 💅

🌸 NAME 🌸

gnutls_certificate_set_x509_crl_mem — it's an API function, and it's the one that hands gnutls your trusted CRLs straight from memory. no filesystem drama, no cap. 🎀

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int gnutls_certificate_set_x509_crl_mem(gnutls_certificate_credentials_t
res, const gnutls_datum_t * CRL, gnutls_x509_crt_fmt_t type);

like, that's the whole vibe right there. you pull in the header, you call the thing, it returns an int. slay. 🦋

🫶 ARGUMENTS 🫶

  • gnutls_certificate_credentials_t res — bestie this is a gnutls_certificate_credentials_t type. it's the credentials object you're loading the CRLs into. main character energy, honestly. 👑
  • const gnutls_datum_t * CRL — this is a list of trusted CRLs. and listen, listen: they should have been verified before. like, gnutls is trusting you on this one, so please don't hand it random unverified bytes. 🙈
  • gnutls_x509_crt_fmt_t type — it's either DER or PEM. pick one. that's the whole menu. ⭐

💜 DESCRIPTION 💜

so what does this actually do? it adds the trusted CRLs so gnutls can verify client or server certificates. that's the job. that's the assignment. 🎯

and here's a lil nuance for you, iykyk: if you're on the client side, you lowkey don't have to call this at all if the certificates aren't being verified with gnutls_certificate_verify_peers2(). no verification happening, no CRLs needed. makes sense, right? 😌

also — and this is the good part — you can call this function multiple times. it just keeps adding. stack 'em up, bestie. 🔥

🌈 RETURNS 🌈

it gives you back the number of CRLs processed — or, if things went sideways, a negative error code. so like, negative number = not the vibe, check your error handling. 💀

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence, tell the gnutls people:

they want to hear from you fr fr. 🐛

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

and the legal tea: copying and distribution of this file, with or without modification, are permitted in any medium without royalty — as long as you keep the copyright notice and this notice intact. so share it, remix it, just keep the receipts. 🧾✨

🎀 SEE ALSO 🎀

the full documentation for gnutls lives as a Texinfo manual. so if /usr/share/doc/gnutls/ does not have the HTML version sitting in it, go here instead:

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

and that's the page, bestie!! every flag, every type, every warning — nothing skipped, nothing invented. you're officially fluent in CRL memory loading. periodt. 💅

signing off from the gnutls manual, version 3.8.13 — mwah, go verify some certificates responsibly 🫶🌸

📦 where this page comes from