gnutls_x509_rdn_get2(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_rdn_get2 — the gnutls girlies' guide 💖

okay so bestie, we're in the gnutls manual, and today's main character is gnutls_x509_rdn_get2(3). it's giving "let me turn that raw DER into a name you can actually read" and honestly? obsessed. 🎀

✨ NAME ✨

gnutls_x509_rdn_get2 — API function 🦋

✨ SYNOPSIS ✨

#include <gnutls/x509.h>

int gnutls_x509_rdn_get2(const gnutls_datum_t * idn, gnutls_datum_t *
str, unsigned flags);

✨ ARGUMENTS ✨

  • const gnutls_datum_t * idn — this one is supposed to hold a DER encoded RDN sequence, no cap. that's the raw material, the whole vibe before the glow-up. 💅
  • gnutls_datum_t * str — a datum that's gonna hold the name. it's the little container where the pretty output lives. 🫶
  • unsigned flags — zero, or GNUTLS_X509_DN_FLAG_COMPAT. pick your fighter. ⭐

✨ DESCRIPTION ✨

so this function literally returns the name of the given RDN sequence. the name comes out looking like "C=xxxx,O=yyyy,CN=zzzz", exactly as described in RFC4514. iconic formatting, honestly. 🌸

but wait — when the flag GNUTLS_X509_DN_FLAG_COMPAT is specified, the output format will match the format output by previous to 3.5.6 versions of GnuTLS, which was not not fully RFC4514-compliant. it's the nostalgia mode, the throwback edition. 💀

✨ RETURNS ✨

on success, GNUTLS_E_SUCCESS (0) is returned. slay. 🎉

or… GNUTLS_E_SHORT_MEMORY_BUFFER gets returned and * buf_size is updated if the provided buffer is not long enough. like girl, your buffer is too small, we fixed the number for you, try again. 😭

otherwise, a negative error value. and that's the villain arc. 🚩

✨ REPORTING BUGS ✨

found a bug? spill it to <bugs@gnutls.org>. 📧

home page: https://www.gnutls.org — go say hi. 🏠

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. free as in do whatever, 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. mwah. 💜

this was gnutls version 3.8.13, manual page gnutls_x509_rdn_get2(3) — thanks for reading my little yap session, ily, go read your DER. 🎀✨

📦 where this page comes from