gnutls_sign_list(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_sign_list — bestie's guide to the signature algorithm list 💖

okay so this is one of those little pages from the gnutls manual, section 3 (that's the library-functions girlies, not the commands ones), and honestly? she's short, she's sweet, she's a whole mood. let's get into it ✨

🌸 NAME 🌸

gnutls_sign_list — and yeah that's it, the original literally just says "API function", because this page is a single function and she knows her name already 💅

🦋 SYNOPSIS 🦋

first things first, you gotta pull in the header, no cap:

#include <gnutls/gnutls.h>

and here's the whole function signature, copy it exactly bestie:

const gnutls_sign_algorithm_t * gnutls_sign_list( void);

like. that's it. no args, no drama. 🎀

🌈 ARGUMENTS 🌈

  • void — literally nothing. she takes nothing. icon behaviour. she's the friend who shows up with zero baggage 🫶

✨ DESCRIPTION ✨

okay so what does she actually do? she gets you a list of supported public key signature algorithms. that's the whole thing. she hands you the list, you say thank you, everyone goes home happy 😌

⚠️ but listen — this function is not thread safe. fr fr. don't be out here calling her from five threads at once like it's a group project. the manpage says it, I'm saying it, we're all saying it together.

👑 RETURNS 👑

what you get back is a (0)-terminated list of gnutls_sign_algorithm_t integers indicating the available ciphers. yes, the original says "ciphers", I'm telling you exactly what it says, don't come for me 💀

so: walk the list until you hit that zero, and you're done. no malloc, no free, no takeout containers left in your car 🚗✨

😭 REPORTING BUGS 😭

found a bug? tell the gnutls girlies directly:

they wanna hear from you, I promise, it's giving community 💜

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

and the legal vibe is extremely generous, so here it is verbatim-ish: 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 like. free real estate, just keep the receipts 🧾💖

🔥 SEE ALSO 🔥

the full documentation for gnutls is maintained as a Texinfo manual. so if the /usr/share/doc/gnutls/ directory does not contain the HTML form, go visit:

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

that's the plug. iykyk 📚✨

and that's the whole page bestie, no notes, ate and left no crumbs 💅

signed, sealed, delivered by the gnutls manual, version 3.8.13 — this page is literally titled gnutls_sign_list(3) and it's yours now 🦋⭐

📦 where this page comes from