gnutls_privkey_status(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_privkey_status — the manual page bestie

okay so real quick, this is a page from the gnutls manual (yes, that gnutls, the TLS library of legend) and it's all about one lil function that answers the question every girl asks: is the key actually there tho? 🦋

✨ NAME ✨

gnutls_privkey_status — an API function, and honestly? an icon 👑

✨ SYNOPSIS ✨

#include <gnutls/abstract.h>

int gnutls_privkey_status(gnutls_privkey_t key);

✨ ARGUMENTS ✨

  • gnutls_privkey_t key — holds the key. that's it, that's the whole vibe. it's the key you're asking about 🎀

✨ DESCRIPTION ✨

okay so what does it DO. it checks the status of the private key token. yes bestie, it's a vibe check for your key 💖

and here's the tea: this function is literally just a wrapper over gnutls_pkcs11_privkey_status(). so if the private key is a PKCS 11 token, it's gonna check whether that token is inserted or not. like, is it plugged in, is it present, is it showing up — that kind of energy ✨

✨ RETURNS ✨

so this function returns non-zero if the token holding the private key is still available (inserted), and zero otherwise. no cap, that's the whole return contract 🙈

✨ SINCE ✨

3.1.10 — vintage. been serving looks since way back 🫶

✨ REPORTING BUGS ✨

found a bug? don't gatekeep, report it 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. so like, go off, 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 important: gnutls_privkey_status and gnutls_pkcs11_privkey_status are besties fr fr. know one, know the other 💅

and that's the page!! this was gnutls 3.8.13 (the source, the moment, the whole era), serving up gnutls_privkey_status(3) — stay inserted, bestie, and slay 💖✨🌸

📦 where this page comes from