gnutls_x509_crq_get_dn2(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_get_dn2 — the manual page, but make it cute

okay bestie, sit down, hydrate, and let's talk about gnutls_x509_crq_get_dn2(3) from the gnutls manual. it's an API function, it's lowkey iconic, and it's about to hand you a certificate request's name on a little silver platter. 🎀

✨ NAME ✨

gnutls_x509_crq_get_dn2 — API function. that's it, that's the name, no notes. 💖

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crq_get_dn2(gnutls_x509_crq_t crq, gnutls_datum_t * dn);

look at her. two params, one int return, zero drama. slay. ✨

🦋 ARGUMENTS 🦋

  • gnutls_x509_crq_t crq — should contain a gnutls_x509_crq_t type. so like, an actual certificate request handle, bestie, not vibes. 👑
  • gnutls_datum_t * dn — a pointer to a structure to hold the name. important: it must be freed using gnutls_free(). do NOT forget this. memory leaks are not the vibe. 🙈

💜 DESCRIPTION 💜

so what does this function actually do? it will allocate a buffer and copy the name of the Certificate request into it. yes, allocate — meaning it's doing the memory management homework for you (which is exactly why you owe it a gnutls_free() later, iykyk 🫶).

the name comes out looking like this:

C=xxxx,O=yyyy,CN=zzzz

as described in RFC4514. cute, right? and the output string will be ASCII or UTF-8 encoded, depending on the certificate data. so it's giving whatever energy the cert brought with it. 🌈

⚠️ okay real talk, this function does not output a fully RFC4514 compliant string. if that's what you need, go see gnutls_x509_crq_get_dn3() instead. no hard feelings, she's just built different. 💀

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise a negative error value. and a negative error code on error. so basically: zero = we ate 🍓, negative = we did not eat 😭.

🧚 SINCE 🧚

3.1.10 — a classic, been here since forever, main character energy from day one. 👑

🎀 REPORTING BUGS 🎀

found a bug? don't suffer in silence, tell the girlies:

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. (translation: share it, remix it, 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, go visit:

https://www.gnutls.org/manual/

that's the whole treasure map, bestie. 🗺️✨

and that's a wrap on the gnutls_x509_crq_get_dn2(3) page, brought to you by gnutls 3.8.13 — the gnutls manual, page gnutls_x509_crq_get_dn2(3). go free your gnutls_datum_t, drink some water, and remember: you are the main character of your own memory management. periodt. 💖🦋🎀

📦 where this page comes from