gnutls_pkcs11_...check_mechanism(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_pkcs11_token_check_mechanism — bestie's guide to the PKCS 11 vibe check 💖

okay so real talk, this one lives in the gnutls manual, and it's the API function that goes gnutls_pkcs11_token_check_mechanism. Yes the name is a whole mouthful, we love her anyway. 🫶

✨ SYNOPSIS ✨

#include <gnutls/pkcs11.h>

unsigned gnutls_pkcs11_token_check_mechanism(const char * url, unsigned
long mechanism, void * ptr, unsigned psize, unsigned flags);

🎀 ARGUMENTS 🎀

  • const char * url — bestie this is where your PKCS 11 URL goes. just the URL, that's her whole job. 💅
  • unsigned long mechanism — the PKCS 11 mechanism ID. like, which mechanism are we checking on. the ID number, not the name, no cap.
  • void * ptr — if you actually set this, it should point at a CK_MECHANISM_INFO struct. leave it be if you don't want the tea. 🍓
  • unsigned psize — the size of that CK_MECHANISM_INFO struct. it's there for safety, which honestly? iconic of it. 🛡️
  • unsigned flags — must be zero. that's it. that's the rule. zero. ⭐

🌸 DESCRIPTION 🌸

So what does she do. This function will return whether a mechanism is supported by the given token. that's the whole plot. 🦋

and here's the cute part: if the mechanism is supported and ptr is set, then ptr will be updated with the token information. like a lil glow-up for your struct. ✨

🔥 RETURNS 🔥

Non-zero if the mechanism is supported, or zero otherwise.

translation: truthy = slay, zero = not today. 💀

👑 SINCE 👑

3.6.0 — she's been around, she's got history, she's a main character. 🌈

😭 REPORTING BUGS 😭

Found a bug?? not the vibe. report it, bestie:

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. (yes you can share 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/
lowkey the most important thing: every flag, every struct, every number up there is exact. copy-paste energy only, no improvising. iykyk. 💅

and that's the page!! from the gnutls crew, version 3.8.13, page gnutls_pkcs11_...check_mechanism(3). mwah, go check some mechanisms bestie 🎀✨🫶

📦 where this page comes from