gnutls_pkcs7_get_crl_raw(3)

πŸ’– gnutls_pkcs7_get_crl_raw(3) πŸ’–

okay bestie, gather round, because this one is a little function from the gnutls family and she is very specific about what she does. no gatekeeping, let's get into it 🫢


✨ NAME ✨

gnutls_pkcs7_get_crl_raw β€” literally just an API function, that's the whole name, no notes πŸ’…


🌸 SYNOPSIS 🌸

#include <gnutls/pkcs7.h>

int gnutls_pkcs7_get_crl_raw(gnutls_pkcs7_t pkcs7, unsigned indx, void *
crl, size_t * crl_size);

like, copy that exactly bestie, don't be cute with it πŸ™ˆ


πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_pkcs7_t pkcs7 β€” the pkcs7 type. that's the thing you're digging through πŸ‘‘
  • unsigned indx β€” this holds the index of the crl you wanna extract. so like, which one. the indx-th one. iykyk πŸ”₯
  • void * crl β€” the contents of the crl get copied right here. and yes, it may be null, so you can absolutely pass NULL if you're just here to vibe check the size first πŸ¦‹
  • size_t * crl_size β€” this should hold the size of the crl. it's not decorative, she matters πŸ’œ

🌈 DESCRIPTION 🌈

this function will return a crl of the PKCS7 or RFC2630 crl set. that's it, that's the whole job. she goes and gets you the crl you asked for and hands it over, no drama ✨


⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value, which is the universe telling you no 😭

if the buffer you provided is not long enough, then crl_size gets updated and GNUTLS_E_SHORT_MEMORY_BUFFER is returned β€” so like, she's telling you exactly how much room she needs, iconic behaviour honestly πŸ’…

and after the last crl has been read, GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. that's your sign to stop asking, bestie, there's no more πŸ“

ngl, that short-buffer update is the main character move here β€” always check crl_size after.

πŸ› REPORTING BUGS πŸ›

found a bug? don't suffer in silence, report it to <bugs@gnutls.org> fr fr πŸ’Œ

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. so like, go off, 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_pkcs7_get_crl_raw(3) from the gnutls manual, version 3.8.13 β€” mwah, slay, periodt πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from