gnutls_x509_crt_set_proxy_dn(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

✨ gnutls_x509_crt_set_proxy_dn ✨

okay bestie, so this one lives in the gnutls manual and it's literally called gnutls_x509_crt_set_proxy_dn 💖 it's an API function, and yes it does exactly what the name says: it sets up the proxy DN for you. no cap.

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crt_set_proxy_dn(gnutls_x509_crt_t crt,
gnutls_x509_crt_t eecrt, unsigned int raw_flag, const void * name,
unsigned int sizeof_name);

🎀 ARGUMENTS 🎀

  • gnutls_x509_crt_t crt — a gnutls_x509_crt_t type, and it's holding the new proxy cert 🫶 like, this is the one getting the glow-up.
  • gnutls_x509_crt_t eecrt — the end entity certificate that will be issuing the proxy. she's the one doing the issuing, main character energy fr.
  • unsigned int raw_flag — must be 0, or 1 if the CN is DER encoded. that's it, that's the rule 💅
  • const void * name — a pointer to the CN name. it may be NULL… but then it MUST be added later, okay?? like, that's not optional, bestie 😭
  • unsigned int sizeof_name — holds the size of name. the receipts, basically.

💜 DESCRIPTION 💜

So this function will set the subject in crt to the end entity's eecrt subject name, and then add a single Common Name component name of size sizeof_name. ✨ This corresponds to the required proxy certificate naming style — like, that's just how proxy certs are supposed to be named, iykyk.

🚨 IMPORTANT SIS: if name is NULL, you MUST set it later by using gnutls_x509_crt_set_dn_by_oid() or similar. do not skip this step. do not pass go. the vibe check will fail 🙈

🌈 RETURNS 🌈

On success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value — and ngl, a negative error value is giving "we need to talk" 💀

🦋 REPORTING BUGS 🦋

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.

(so like… keep the notice, it's the least you can do 💖)

⭐ 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 was gnutls_x509_crt_set_proxy_dn(3) from gnutls version 3.8.13, and yes the manual itself is also a whole icon. slay, stay safe, and remember: raw_flag is 0, or 1 if the CN is DER encoded. periodt 💅✨🫶

📦 where this page comes from