gnutls_certificate_free_ca_names(3)

πŸ’– gnutls_certificate_free_ca_names(3) πŸ’–

okay bestie so this one lives in the gnutls manual, and it's literally called gnutls_certificate_free_ca_names β€” an API function, no cap. sit down, hydrate, let's get into it 🫢


✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

void gnutls_certificate_free_ca_names(gnutls_certificate_credentials_t
sc);

that's it. that's the whole vibe. returns nothing (void), takes one thing, deletes stuff. main character energy tbh πŸ’…


πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_certificate_credentials_t sc β€” bestie this is a gnutls_certificate_credentials_t type. that's the whole description. it's a credentials object and you're about to strip the CA names out of it ✨

πŸ¦‹ DESCRIPTION πŸ¦‹

so. this function will delete all the CA name in the given credentials. all of them. gone. poof. πŸ’€

who should be calling this tho? listen:

  • Clients may call this to save some memory β€” because on the client side, the CA names are not used. like, not even a little bit. so why keep them around eating your RAM fr fr πŸ™ˆ
  • Servers might want to use this function if a large list of trusted CAs is present and sending the names of it would just consume bandwidth without providing information to client. like why are you yapping when nobody's listening 😭

and for context, iykyk: CA names are used by servers to advertise the CAs they support to clients. that's the whole point of them existing β€” servers being like "hey here's who i trust" to the clients. iconic behaviour, but only when it's actually useful πŸ‘‘


πŸ’œ REPORTING BUGS πŸ’œ

found a bug? not on my watch. go tell the gnutls girlies:


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. (yes queen, free as in freedom, we love to see it πŸ’–)


⭐ SEE ALSO ⭐

the full documentation for gnutls is maintained as a Texinfo manual. so if the /usr/share/doc/gnutls/ directory does not contain the HTML form, visit:

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

like, just click the link bestie, the info is right there ✨


and that's the whole page babes!! this one came from gnutls 3.8.13 β€” the gnutls_certificate_free_ca_names(3) page, version 3.8.13 era, bringing you all this free-software goodness from the Free Software Foundation. stay slaying, stay freeing your CA names, mwah πŸ«ΆπŸ’…πŸŽ€

πŸ“¦ where this page comes from