GNUTLS_CERTIFICATE_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

✨ NAME ✨

gnutls_certificate_verification_status_print — bestie, it's an API function 💅

okay so real quick, this lives in the gnutls manual (section 3, the library-functions girlies), and it's the one that takes your certificate verification status and makes it pretty. periodt.

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

int gnutls_certificate_verification_status_print(unsigned int status,
       gnutls_certificate_type_t type, gnutls_datum_t * out, unsigned int
       flags);

🌸 ARGUMENTS 🌸

  • unsigned int status — the status flags that you want printed, bestie. like the actual vibe report of your verification.
  • gnutls_certificate_type_t type — the certificate type. yes ma'am, we need to know what kind.
  • gnutls_datum_t * out — a newly allocated datum holding a (0) terminated string. so like, it's fresh, it's yours, it's NUL-terminated 💖
  • unsigned int flags — should be zero. that's it. that's the whole requirement. zero. 🫶

🌈 DESCRIPTION 🌈

This function will pretty print the status of a verification process — for example the one you got from gnutls_certificate_verify_peers3(). so you do the verify, you get the status number, and then you call this to turn it into something your eyeballs can actually read instead of a cursed bitfield. iconic behaviour honestly.

⚠️ the output out needs to be deallocated using gnutls_free(). no cap. if you forget, that's a leak and the memory is gonna be sitting there like 👑 forever. free your datum, bestie.

⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned 🎉 otherwise you get a negative error value. so like, < 0 means something went sideways, 0 means slay.

🦋 SINCE 🦋

3.1.4 — she's been around a minute, a true elder of the library 💜

🍓 REPORTING BUGS 🍓

Found a bug? spill the tea:

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 yes, 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, visit

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

and that's the whole page, bestie!! 🌟 this little cutie comes to you from gnutls version 3.8.13 — go forth and pretty-print your statuses 💖✨

📦 where this page comes from