gnutls_x509_dn_set_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_set_str — the manual page, but make it cute 💖

okay bestie, welcome to the gnutls_x509_dn_set_str(3) page from the gnutls manual 🎀 this is the one that lets you yeet a whole DN string into a DN structure, and honestly? she's lowkey iconic for it. let's get into it 🦋

✨ NAME ✨

gnutls_x509_dn_set_str — API function 💅

no cap, that's the whole name. it's an API function. it does API function things. moving on 🫶

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_dn_set_str(gnutls_x509_dn_t dn, const char * str, const
char ** err);

yes bestie, that's the exact signature, don't come for me 💀 copy it character for character or the compiler WILL humble you.

🧚 ARGUMENTS 🧚

  • gnutls_x509_dn_t dn — a pointer to DN. this is the lil guy you're setting stuff on, the main character of this whole operation 👑
  • const char * str — a comma separated DN string (RFC4514). comma separated!! not semicolon, not vibes, commas 📝 and it's RFC4514 specifically, so iykyk.
  • const char ** err — indicates the error position (if any). so if the parsing goes sideways, this is where it tells you where it went sideways. very "here's exactly which part of your string ate it" energy 🔍

💜 DESCRIPTION 💜

This function will set the DN on the provided DN structure. periodt ✨

The input string should be plain ASCII or UTF-8 encoded — so keep your encoding clean, no random cursed bytes, okay? 😭

On DN parsing error GNUTLS_E_PARSING_ERROR is returned. so if you see that one, it's not a you problem... well. it might be a you problem. but at least it's a labelled you problem 💀

⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned — slay, that's the good zero 🎉

otherwise a negative error value. negative = not slay, go read err and figure out what happened bestie 🙈

🎀 SINCE 🎀

3.5.3 — she's been around since 3.5.3, an absolute veteran, respect her 🌈

🦋 REPORTING BUGS 🦋

Report bugs to <bugs@gnutls.org>. — yes, actual email, actual humans, they want to hear it 🫶

Home page: https://www.gnutls.org — go look, it's giving official 💅

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 to share, just keep the receipts, that's the rule 📜💖

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

like, go read the whole thing, it's a whole universe of gnutls lore 📚✨

and that's the page bestie!! no notes, no skips, every flag and fact intact 🧚💜

signing off with love: this was page gnutls_x509_dn_set_str(3) from gnutls version 3.8.13 — mwah, stay parsed 💋🌸

📦 where this page comes from