GNUTLS_X509_CRT_SET_CRL_DIST_POINTS2(3)

πŸ’– gnutls_x509_crt_set_crl_dist_points2 β€” the manual page, but make it make sense ✨

okay bestie, gather round, because we're diving into the gnutls manual (you know, the TLS library that's lowkey carrying half the internet) and today's main character is gnutls_x509_crt_set_crl_dist_points2. yes it's a long name. no we're not shortening it. it's giving "I have a very specific job and I do it flawlessly" πŸ’…


🌸 NAME 🌸

gnutls_x509_crt_set_crl_dist_points2 β€” an API function, periodt. that's it, that's the name, she's long and she's iconic πŸ‘‘


πŸ¦‹ SYNOPSIS πŸ¦‹

first things first, you gotta pull in the header or nothing works, no cap:

#include <gnutls/x509.h>

int gnutls_x509_crt_set_crl_dist_points2(gnutls_x509_crt_t crt,
gnutls_x509_subject_alt_name_t type, const void * data, unsigned int
data_size, unsigned int reason_flags);

look at those five little parameters holding hands 🫢 adorable. now let's meet them one by one.


✨ ARGUMENTS ✨

  • gnutls_x509_crt_t crt β€” the certificate you're working with, of type gnutls_x509_crt_t. she's the star of the show, the one getting a brand new extension. main character energy fr πŸ’–
  • gnutls_x509_subject_alt_name_t type β€” this one's one of the gnutls_x509_subject_alt_name_t enumerations. pick your fighter, bestie, it's a whole enum out here 🌈
  • const void * data β€” the actual data you wanna set. the payload. the moment. the vibe πŸŽ€
  • unsigned int data_size β€” the size of that data, because we're not out here guessing how many bytes we brought to the party πŸ“
  • unsigned int reason_flags β€” the revocation reasons. yes, reasons, plural, it's giving very "we have receipts" πŸ’€

🌺 DESCRIPTION 🌺

so what does she actually do?? she sets the CRL distribution points certificate extension on your certificate. that's the whole thing. one function, one extension, zero drama. literally doing exactly what the name says (a rarity, honestly, we love a self-aware API) βœ¨πŸ¦‹

if you don't know what a CRL distribution point is, don't worry, this page isn't gonna gatekeep an explanation that isn't here either. it sets the extension. that's the tea β˜•

πŸ’œ RETURNS πŸ’œ

  • if everything goes gorgeously: GNUTLS_E_SUCCESS (which is 0, bestie, zero, the good number) πŸŽ‰
  • if not: a negative error value. and you will know, because negative is never subtle 😭

⭐ SINCE ⭐

2.6.0 β€” she's been here since 2.6.0, so she's an elder, a veteran, a legend who's been slaying since before some of y'all were even compiling πŸ‘‘


πŸ™ˆ REPORTING BUGS πŸ™ˆ

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


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 forth and share, just keep the receipts attached, iykyk 🫢)


🌈 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/

like, actually visit it. the docs are right there. go get your knowledge, queen 🧚


and that's the page, bestie!! stay safe out there setting those CRL distribution points, and remember: negative return values are not a personality trait, they're a to-do list πŸ’€βœ¨

β€” signed off with love from the gnutls manual, version 3.8.13 πŸŽ€πŸ’–

πŸ“¦ where this page comes from