gnutls_sign_al...m_get_requested(3)

πŸ’– gnutls_sign_algorithm_get_requested πŸ’–

okay bestie, welcome to the gnutls manual, you're gonna eat this one up ✨


🌸 NAME 🌸

gnutls_sign_algorithm_get_requested β€” it's an API function, and it's lowkey iconic πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <gnutls/gnutls.h>

int gnutls_sign_algorithm_get_requested(gnutls_session_t session, size_t
indx, gnutls_sign_algorithm_t * algo);

πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_session_t session β€” bestie this is a gnutls_session_t type, that's the whole vibe of it 🫢
  • size_t indx β€” it's an index of the signature algorithm to return, like the lil number you pass to pick which one you want
  • gnutls_sign_algorithm_t * algo β€” the returned certificate type gets stored right there, she's the output girlie πŸ’–

✨ DESCRIPTION ✨

so what this does is: it returns the signature algorithm specified by index that was requested by the peer. That's it, that's the serve. πŸ‘‘

but listen β€” if the specified index has no data available, this function returns GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE. And if the negotiated TLS version doesn't even support signature algorithms, then GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned even for the first index. Yes, even index zero. Not a drill. 😭

and the first index? that's 0. Zero-based, like a real one. πŸ’…

this function is useful in the certificate callback functions to assist in selecting the correct certificate. so if you're out here picking certs, she's your girl fr fr πŸŽ€

🌈 RETURNS 🌈

On success, GNUTLS_E_SUCCESS (0) is returned β€” slay ✨ otherwise an error code is returned, and you get to deal with that πŸ’€


⭐ SINCE ⭐

2.10.0 β€” she's been around since way back, an OG πŸ‘‘


πŸ› REPORTING BUGS πŸ›

Report bugs to <bugs@gnutls.org>.

Home page: https://www.gnutls.org


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. periodt πŸ’…


πŸ”₯ 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/


okay and that's the whole page bestie!! this was gnutls version 3.8.13, and yeah the manual name is just gnutls in case you were wondering πŸ¦‹ mwah, go read some more manpages, you're doing amazing πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from