gnutls_x509_crl_set_number(3)

✨ gnutls_x509_crl_set_number ✨

okay so bestie, we're deep in the gnutls manual rn and this lil function is literally the moment you give a CRL its own special little number πŸ’… if you've ever wondered "who decides what number this revocation list is" β€” surprise, it's you. welcome to your main character era πŸ‘‘


🌸 NAME 🌸

gnutls_x509_crl_set_number β€” API function. that's it, that's the name, no notes πŸ’–


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <gnutls/x509.h>

int gnutls_x509_crl_set_number(gnutls_x509_crl_t crl, const void * nr,
size_t nr_size);

look at that signature. so clean. so iconic. ✨


πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_x509_crl_t crl β€” a CRL of type gnutls_x509_crl_t. yes, it's the thing you're editing, she's the star of the show 🫢
  • const void * nr β€” The CRL number. this is the actual number bestie, sitting there as a void * because gnutls said "we're flexible" πŸ’€
  • size_t nr_size β€” Holds the size of the nr field. like, how many bytes is your number. measure twice, cut once fr fr πŸ“

πŸ’– DESCRIPTION πŸ’–

This function will set the CRL's number extension. the way that it exists purely so the authority can slap a unique and monotonic number on each CRL 😌

so like β€” unique meaning no two CRLs get the same number, and monotonic meaning it only ever goes up. new CRL drops, number goes higher. it's giving "chronological order but make it cryptography" πŸ”₯


⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value and honestly? a negative vibe 😭 check your return codes, bestie, don't leave her on read.


🧚 SINCE 🧚

2.8.0 β€” she's been around a minute, lowkey a legend πŸ‘‘


πŸ™ˆ REPORTING BUGS πŸ™ˆ

Report bugs to <bugs@gnutls.org>.

Home page: https://www.gnutls.org

(if something's broken, tell them, don't just suffer in silence 🫢)


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.


🌈 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, no cap πŸŽ€ this was the gnutls manual, version 3.8.13, page gnutls_x509_crl_set_number(3) β€” go forth and number your CRLs responsibly, mwah πŸ’‹πŸŒΈ

πŸ“¦ where this page comes from