gnutls_pkcs11_obj_get_flags(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_obj_get_flags — the vibe check for your PKCS#11 objects

okay so bestie, welcome to the gnutls manual (that's the manual name, slay) and today we're peeking at an icon: gnutls_pkcs11_obj_get_flags. It's an API function, it's from the gnutls family, and it does exactly one job and does it gorgeously. 🎀

✨ SYNOPSIS ✨

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_obj_get_flags(gnutls_pkcs11_obj_t obj, unsigned int *
oflags);

that's the whole thing. two args, one int coming back. no cap. 🦋

🌸 ARGUMENTS 🌸

  • gnutls_pkcs11_obj_t obj — the pkcs11 object itself, the little main character we're inspecting 💖
  • unsigned int * oflags — a pointer that will hold the output flags. she's an out-param, she gets filled in, that's her whole arc ✨

👑 DESCRIPTION 👑

so this function will return the flags of the object. and like, the oflags you passed in? it will be holding flags from gnutls_pkcs11_obj_flags. iykyk.

and specifically — not me being precise about this — that means the GNUTLS_PKCS11_OBJ_FLAG_MARK_* flags. those ones. the MARK ones. periodt. 💅

🌈 RETURNS 🌈

  • on success: GNUTLS_E_SUCCESS (0) is returned. we love a zero, zero is the dream 🫶
  • otherwise: a negative error value. so like, if you see a negative number, that's not a vibe, that's a problem, go read your errors bestie 😭

⭐ SINCE ⭐

3.3.7 — she's been around a while, an elder stateswoman, iconic behavior 👑

💀 REPORTING BUGS 💀

found a bug? don't suffer in silence, tell the people:

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.

(translation: use it, share it, remix it, just keep the receipts. legal girlies said what they said. 💜)

🧚 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/

go read it, it's giving ✨*comprehensive*✨

real talk: the oflags pointer is how you get your answer out, so make sure it's pointing somewhere real. undefined behavior is not the aesthetic. 🙈

okay that's the page!! this was gnutls version 3.8.13, gnutls_pkcs11_obj_get_flags(3), and the copyright sits at © 2001-2023 — thanks for coming to my TED talk, go forth and check your flags bestie, ily 💖🌸🦋

📦 where this page comes from