pskc_get_key_p...failedattempts(3)

📦
version 2.6.15 · 5 versions
, in arch rolling

💅 pskc_get_key_p...failedattempts — no cap, it's a libpskc thing

okay so bestie, real talk: this is a libpskc manpage, section 3, and the page title is literally pskc_get_key_p...failedattempts(3) — yes the truncation is part of the vibe, she's iconic like that. Buckle up, we're getting a PIN policy number out of a key package. 🎀

✨ NAME ✨

pskc_get_key_policy_pinmaxfailedattempts — an API function, and honestly? A whole main character. She reads the max-failed-attempts value off a key's PIN policy. Periodt. 💅

🌸 SYNOPSIS 🌸

#include <pskc.h>

uint32_t pskc_get_key_policy_pinmaxfailedattempts(pskc_key_t * key, int
* present);

like yes, that's the whole thing. two arguments. she's lowkey simple, highkey essential. ✨

🦋 ARGUMENTS 🦋

  • pskc_key_t * key — a pskc_key_t handle, which you get from pskc_get_keypackage(). your little key guy 🫶
  • int * present — an output variable that tells you whether the data was actually provided or not. she's the vibe check of the whole operation ngl.

💖 DESCRIPTION 💖

Get the PSKC KeyPackage Key Policy PINPolicy MaxFailedAttempts value. say that five times fast, i dare you 😭

so what does this attribute actually mean? it indicates the maximum number of times the PIN may be entered wrongly before it MUST NOT be possible to use the key anymore. like, capital-M MUST NOT — that's not a suggestion, that's the rule. 🔥

and if you're wondering what reasonable values look like: typical reasonable values are in the positive integer range of at least 2 and no more than 10. so like... not one, not a hundred. two to ten. balanced. demure. mindful. 🧚

about present — if present is non-NULL, it will be 0 if the field is not present or 1 if it was present. literally just a little yes/no bestie. 🙈

⭐ RETURNS ⭐

an integer holding the content. that's it, that's the return. clean, crisp, slay. 💀

🐛 REPORTING BUGS 🐛

found a bug? don't sit on it, tell the people! report bugs to <oath-toolkit-help@nongnu.org>.

they're literally waiting to hear from you, bestie. 🫶

Copyright © 2009-2026 Simon Josefsson.

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. iconic and generous, we love to see it. 💜

🌈 and that's the page!! this little beauty ships with libpskc version 2.6.15, so go forth, read your PIN policy max-failed-attempts, and stay safe out there. mwah 💋✨

📦 where this page comes from