gnutls_x509_crl_list_import(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_list_import(3) 💖

okay bestie, welcome to the gnutls manual, section 3. today's main character is gnutls_x509_crl_list_import — an API function, and she is serving.

✨ NAME ✨

gnutls_x509_crl_list_import — API function. that's it, that's the name, she's iconic and she knows it 💅

🦋 SYNOPSIS 🦋

#include <gnutls/x509.h>

int gnutls_x509_crl_list_import(gnutls_x509_crl_t * crls, unsigned int *
crl_max, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format,
unsigned int flags);

like, copy that exactly, don't freestyle it 🙈

🌸 ARGUMENTS 🌸

  • gnutls_x509_crl_t * crls — this is where the parsed CRLs get copied to. and listen, she has rules: this must not be initialized. don't touch it first, don't pre-init it, just hand it over raw. periodt.
  • unsigned int * crl_max — okay so going in, this has to already hold the maximum number of crls. and then? the function updates it with the number of crls actually available. it's giving glow-up, it's giving before and after ✨
  • const gnutls_datum_t * data — the CRL data. the goods. the material 💜
  • gnutls_x509_crt_fmt_t format — literally just pick one: DER or PEM. that's the whole vibe check.
  • unsigned int flags — must be (0) or an OR'd sequence of gnutls_certificate_import_flags. no random flags bestie, we don't do that here 🫶

💀 DESCRIPTION 💀

so what does she actually do? this function converts the given CRL list into the native gnutls_x509_crl_t format. the output gets stored in crls, and — plot twist — they will be automatically initialized. no manual setup needed, she handles it, main character energy fr fr 👑

lowkey important: if the Certificate is PEM encoded, it should have a header of "X509 CRL". don't skip the header, bestie, she will not recognize it otherwise 😭

⭐ RETURNS ⭐

she returns the number of certificates read — or a negative error value if things went sideways 💔

🎀 SINCE 🎀

3.0 — she's been here since 3.0, a true veteran of the game 🌈

🔥 REPORTING BUGS 🔥

found a bug? not me being the messenger but—

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, you ate that 💅✨

this was the gnutls manual, section 3, page for gnutls_x509_crl_list_import, brought to you by gnutls version 3.8.13 — mwah, take care of her, she's fragile but powerful 🦋🌸

📦 where this page comes from