gnutls_x509_crt_set_proxy(3)

✨ gnutls_x509_crt_set_proxy(3) ✨

okay bestie so this is a page from the gnutls manual (section 3, the library-functions section, iykyk) and it's literally all about setting a proxyCertInfo extension on a certificate. it's giving "niche but iconic" πŸ’… let's go.


🌸 NAME 🌸

gnutls_x509_crt_set_proxy β€” an API function 🫢


✨ SYNOPSIS ✨

#include <gnutls/x509.h>

int gnutls_x509_crt_set_proxy(gnutls_x509_crt_t crt, int
pathLenConstraint, const char * policyLanguage, const char * policy,
size_t sizeof_policy);

πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_x509_crt_t crt β€” a certificate, of the gnutls_x509_crt_t type. that's the one we're decorating ✨
  • int pathLenConstraint β€” okay so listen: if this is a non-negative value, it means the maximum length of path. if it's a negative value, it means the pathLenConstraints field should not be present at all. so like, negative = we're not even doing that field, periodt πŸ’€
  • const char * policyLanguage β€” the OID that describes the language of policy.
  • const char * policy β€” a uint8_t byte array with the policy language. and yes, it can be NULL πŸ™ˆ
  • size_t sizeof_policy β€” the size of policy.

πŸ’– DESCRIPTION πŸ’–

this function will set the proxyCertInfo extension. that's it, that's the whole vibe. it does the one thing and it does it slayfully πŸ‘‘


🌈 RETURNS 🌈

on success, GNUTLS_E_SUCCESS (0) is returned πŸŽ‰ otherwise you get a negative error value, which is the code's way of saying "not me failing the vibe check" 😭


πŸ› REPORTING BUGS πŸ›

found a bug? report it to <bugs@gnutls.org> β€” they wanna know, fr fr.

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. so like, go off, just keep the receipts πŸ§ΎπŸ’–


πŸ¦‹ 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 bestie!! 🌟 this one's from gnutls 3.8.13, so if you're out here setting proxyCertInfo extensions, now you know exactly what's up. stay iconic, read your manpages, and remember: negative pathLenConstraint means the field is NOT invited to the party πŸŽ€πŸ’œβœ¨

πŸ“¦ where this page comes from