gnutls_x509_crq_set_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_crq_set_dn — the glow-up your cert request's DN deserves 💖

okay bestie, so this one lives in the gnutls manual (section 3, the library-call girlies), and it's literally about setting the Distinguished Name on a certificate request. let's go 🦋

✨ NAME ✨

gnutls_x509_crq_set_dn — API function. yes that's it. that's the whole name section. short and iconic 💅

✨ SYNOPSIS ✨

#include <gnutls/x509.h>

int gnutls_x509_crq_set_dn(gnutls_x509_crq_t crq, const char * dn, const
char ** err);

no cap, that's the whole signature. copy it exactly or the compiler will simply not hear you out 😭

✨ ARGUMENTS ✨

  • gnutls_x509_crq_t crq — a certificate of type gnutls_x509_crq_t. this is your main character, the cert request you're about to give a whole new identity 🌸
  • const char * dn — a comma separated DN string (RFC4514). yes, RFC4514, the DN string format one, not the other ones. keep it comma-separated or it's giving chaos 🎀
  • const char ** err — indicates the error position (if any). so if your DN string is cursed, this lil out-param tells you where it went wrong. extremely helpful, honestly 🫶

✨ DESCRIPTION ✨

so this function will set the DN on the provided certificate. 🎉

The input string should be plain ASCII or UTF-8 encoded. like, keep it texty, keep it valid, we love an encoding that behaves.

On DN parsing error GNUTLS_E_PARSING_ERROR is returned. so if you hand it something it can't parse, that's the exact error you're getting back, no mystery, no drama 💀

✨ RETURNS ✨

On success, GNUTLS_E_SUCCESS (0) is returned. otherwise a negative error value. and bestie, negative = not it. check your return values, periodt 👑

fr fr, always check the return value. the function is not gonna text you back about what went wrong. it just returns a negative number and moves on 🙈

✨ 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. slay, public domain-adjacent energy, we love to see it ⭐

✨ 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 version 3.8.13, manpage source gnutls_x509_crq_set_dn(3) — go set some DNs and stay parsed correctly ✨🌈🎀

📦 where this page comes from