gnutls_x509_crt_set_crq(3)

πŸ’– gnutls_x509_crt_set_crq β€” the manual page, bestie edition πŸ’–

okay so this is a page from the gnutls manual, and it's all about one very specific little function called gnutls_x509_crt_set_crq. sit down, grab a boba, we're doing X.509 today 🧚✨


✨ NAME ✨

gnutls_x509_crt_set_crq β€” it's an API function, bestie. that's the whole name. she's simple, she's iconic, she does one thing. πŸ‘‘


🌸 SYNOPSIS 🌸

like, the whole vibe in one breath:

#include <gnutls/x509.h>

int gnutls_x509_crt_set_crq(gnutls_x509_crt_t crt, gnutls_x509_crq_t
crq);

yes she takes two args, yes she returns an int, no we are not okay about it πŸ’…


πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_x509_crt_t crt β€” a certificate of type gnutls_x509_crt_t. this is the glow-up target, the certificate that's about to receive some new info 🫢
  • gnutls_x509_crq_t crq β€” holds a certificate request. she's the source of the tea, the one bringing the content πŸ“¨

πŸ¦‹ DESCRIPTION πŸ¦‹

so here's what actually happens: this function will set the name and public parameters, plus all the extensions, from the given certificate request over onto the certificate. like, it's a full info-transfer moment. main character energy for real.

only RSA keys are currently supported. that's the limit, no cap. if you were hoping for something else, this is not the function, sorry babe 😭

and here's the big caveat that you do not wanna skip:

note that this function will only set the crq if it is self signed and the signature is correct. see gnutls_x509_crq_sign2(). so like, no self-sign, no signature verification, no setting. it's giving "vibe check first, then we proceed." πŸ”₯


⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned πŸŽ‰ otherwise you get a negative error value. negative. as in, bad. as in, go read the error code, bestie πŸ™ˆ


πŸ’€ REPORTING BUGS πŸ’€

found a bug? don't just scream into the group chat β€” report bugs to <bugs@gnutls.org> πŸ’Œ

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. periodt. legal but chill. ✨


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

iykyk β€” the real ones always check the manual 🫢


and that's the page!! gnutls 3.8.13, page gnutls_x509_crt_set_crq(3) β€” mwah, go forth and set those certificate requests, bestie πŸ’…πŸ’–βœ¨

πŸ“¦ where this page comes from