dane_verification_status_print(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

💅 dane_verification_status_print(3) — a gnutls moment

okay bestie, sit down, hydrate, because we're doing a gnutls man page and it's actually so cute. this one lives in the gnutls manual, section 3. yes, the same gnutls that does all your TLS stuff. let's get into it 🎀

✨ NAME ✨

dane_verification_status_print — literally an API function, that's the whole name, no notes 💖

✨ SYNOPSIS ✨

#include <gnutls/dane.h>

int dane_verification_status_print(unsigned int status, gnutls_datum_t *
out, unsigned int flags);

there she is. three arguments, one int return, no drama 🌸

✨ ARGUMENTS ✨

  • unsigned int status — the status flags you want printed. the whole point of the function, she's the main character 👑
  • gnutls_datum_t * out — a newly allocated datum holding a (0) terminated string. yes, you get a fresh datum out of this, she's brand new ✨
  • unsigned int flags — should be zero. that's it. that's the instruction. zero. no cap 💀

✨ DESCRIPTION ✨

so what does she do? this function will pretty print the status of a verification process — like, for example, the one you got from dane_verify_crt(). it's giving "make the cryptic status flags look cute and readable" 🦋

⚠️ important bestie: the output out needs to be deallocated using gnutls_free(). do NOT forget her, she will leak and that's not the vibe 😭

✨ RETURNS ✨

on success, GNUTLS_E_SUCCESS (0) is returned 🎉 otherwise you get a negative error value, which is the code equivalent of a sad face. not iconic, but honest 💜

✨ REPORTING BUGS ✨

found a bug? spill the tea to the devs, they wanna know:

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. so go forth, share her, 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/

that's the whole rabbit hole, bestie, go read the rest, iykyk 📚

k bye ily, this was gnutls 3.8.13 of the dane_verification_status_print(3) page 💖 stay verified, stay pretty, and always gnutls_free() your datum ✨🎀

📦 where this page comes from