gnutls_certifi...ver_set_request(3)

πŸ’– gnutls_certificate_server_set_request β€” the girlies' guide ✨

okay so bestie, we're in the gnutls manual today (yes, that gnutls β€” the TLS library that's literally carrying half the internet on its back πŸ’…) and today's main character is gnutls_certificate_server_set_request. buckle up πŸŽ€


🌸 NAME 🌸

gnutls_certificate_server_set_request β€” API function πŸ‘‘


✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

void gnutls_certificate_server_set_request(gnutls_session_t session,
gnutls_certificate_request_t req);

that's it. that's the whole vibe. one include, one function, zero drama πŸ¦‹


🫢 ARGUMENTS 🫢

  • gnutls_session_t session β€” bestie this is, and I quote, "a gnutls_session_t type." iconic of it. it's your session, your girl, your whole situation πŸ’œ
  • gnutls_certificate_request_t req β€” and this one has to be one of GNUTLS_CERT_REQUEST, GNUTLS_CERT_REQUIRE, or GNUTLS_CERT_IGNORE. pick your fighter, no in-between 🌈

πŸ‘‘ DESCRIPTION πŸ‘‘

so here's the tea: this function decides whether we β€” and by "we" I mean you, if you're the server β€” are gonna send a certificate request message over to the client. πŸ“¨

if req is GNUTLS_CERT_REQUIRE, then the server will straight up return the GNUTLS_E_NO_CERTIFICATE_FOUND error if the peer doesn't hand over a certificate. no cert? no entry. periodt. 😀

and if you just... don't call this function at all? then the client won't even be asked to send a certificate. it's giving "silence is also an answer." πŸ™ˆ

and listen β€” calling the function with req set to GNUTLS_CERT_IGNORE does exactly the same thing. same effect, same energy, no notes. lowkey wild but that's the lore fr fr πŸ’€


πŸ› REPORTING BUGS πŸ›

found a bug? spill it to <bugs@gnutls.org> β€” they want to know, I promise 🫢

home page, for your scrolling pleasure: 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 yes bestie, you may in fact share it, slay, redistribute it, it's all good πŸ’–


🌈 SEE ALSO 🌈

the full documentation for gnutls lives in a Texinfo manual β€” that's the whole encyclopedia, not just this page πŸ“š

if the /usr/share/doc/gnutls/ directory does not have the HTML form in it, then head on over and visit:

https://www.gnutls.org/manual/

go forth, read, be educated, be iconic 🧚


ngl if you're still here, you're a real one. go set your certificate requests, bestie, you got this πŸ’…

and that's a wrap!! this page came to you from gnutls version 3.8.13, gnutls_certificate_server_set_request(3), and honestly? she ate. mwah πŸ˜˜πŸ’–

πŸ“¦ where this page comes from