gnutls_pkcs11_token_get_flags(3)

✨ gnutls_pkcs11_token_get_flags ✨

okay bestie, listen up πŸ’– this one lives in the gnutls manual (yes, the whole big library, this is just one lil page of it) and it's literally just called gnutls_pkcs11_token_get_flags β€” an API function, no cap. it's giving "small but mighty" energy πŸŽ€


🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_token_get_flags(const char * url, unsigned int *
flags);

like, that's the whole vibe. two args, one int coming back at you 🫢


πŸ¦‹ ARGUMENTS πŸ¦‹

  • const char * url β€” bestie this should contain a PKCS 11 URL. that's the whole job. drop the URL in here πŸ‘‘
  • unsigned int * flags β€” this is where the output flags go, and they're all the GNUTLS_PKCS11_TOKEN_* girlies. she writes into this pointer, so have somewhere for her to write 😌

πŸ’… DESCRIPTION πŸ’…

so what does she actually do? this function returns information about the PKCS 11 token flags. that's it. that's the tea β˜•

the supported flags are:

  • GNUTLS_PKCS11_TOKEN_HW
  • GNUTLS_PKCS11_TOKEN_TRUSTED

those are the only two that show up here, periodt. no extra secret flags hiding in the back, i checked πŸ’€


⭐ RETURNS ⭐

GNUTLS_E_SUCCESS (which is 0, iconic) on success πŸŽ‰ or a negative error code if something went wrong 😭 so like, always check the sign, babe.


🌈 SINCE 🌈

2.12.0 β€” she's been around since 2.12.0, an elder statesman but still slaying πŸ’œ


πŸ› REPORTING BUGS πŸ›

found a bug? don't be shy, report it to <bugs@gnutls.org>. πŸ“¬

home page is right here: https://www.gnutls.org β€” go say hi 🏠


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 like, go forth and share, just keep the receipts bestie ✨


🧚 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 your main character documentation destination, iykyk πŸ’–


and that's the page!! mwah πŸ’‹ this was gnutls version 3.8.13, the gnutls_pkcs11_token_get_flags(3) page β€” go read your tokens' flags, you absolute legend πŸŽ€βœ¨

πŸ“¦ where this page comes from