gnutls_x509_dn_get_str(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_dn_get_str(3) — the gnutls manual, bestie edition 💖

okay so. you're deep in the gnutls manual, section 3, and you found the page for gnutls_x509_dn_get_str. this is the "turn my fancy DN struct into an actual readable string" function and honestly? it's giving lowkey iconic. let's go 🫶

✨ NAME ✨

gnutls_x509_dn_get_str — API function. that's it, that's the name, periodt.

✨ SYNOPSIS ✨

#include <gnutls/x509.h>

int gnutls_x509_dn_get_str(gnutls_x509_dn_t dn, gnutls_datum_t * str);

like. there it is. two args, one int coming back at you. no cap. 🌸

✨ ARGUMENTS ✨

  • gnutls_x509_dn_t dn — a pointer to DN. yeah girl, the whole distinguished name, the entire main character of this operation 💅
  • gnutls_datum_t * str — a datum that will hold the name. it's the little container that catches the output, so make sure it's actually there, bestie 🎀

✨ DESCRIPTION ✨

so here's the tea ☕ — this function will allocate buffer and copy the name in the provided DN. it does the memory work for you, which is honestly so generous of it.

the name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC4514. that's the format, that's the vibe, that's the whole shape of the thing.

and here's the detail you cannot skip: the output string will be ASCII or UTF-8 encoded, depending on the certificate data. so like, don't assume, okay? the cert decides. iykyk 🦋

✨ RETURNS ✨

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise a negative error value. so if you get something less than zero, that's not a vibe check you passed, that's a vibe check you failed 😭

✨ SINCE ✨

3.4.2 — old enough to be a classic, young enough to still slay 👑

✨ REPORTING BUGS ✨

found a bug? don't gatekeep it, report bugs to <bugs@gnutls.org>. 🐛

home page: https://www.gnutls.org — go say hi, the whole thing lives there 🌈

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. fr fr, keep the receipts and you're good 🫶

✨ 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/

go forth and read, bestie, the lore is deep 📚✨

and that's the page!! this came to you from the gnutls manual, version 3.8.13, page gnutls_x509_dn_get_str(3) — mwah, take care of your DNs, ily 💜🧚

📦 where this page comes from