gnutls_pkcs11_token_set_pin(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_set_pin(3) ✨

okay bestie, welcome to the gnutls manual, section 3 — yes, that's the section for library calls, and yes, this whole page is about changing a PIN on a PKCS #11 token. it's giving security girlie. let's go 💅

🎀 NAME 🎀

gnutls_pkcs11_token_set_pin — literally just an API function, that's it, that's the whole name 💖

🦋 SYNOPSIS 🦋

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_token_set_pin(const char * token_url, const char *
oldpin, const char * newpin, unsigned int flags);

look at her. four args. very demure, very mindful ✨

🌸 ARGUMENTS 🌸

  • const char * token_url — a PKCS 11 URL that specifies a token. this is you pointing at which token you mean, bestie, so don't be vague 🔍
  • const char * oldpin — the old user's PIN. the current one. the one you're replacing 👋
  • const char * newpin — the new user's PIN. the glow-up version 💅
  • unsigned int flags — one of gnutls_pin_flag_t. pick your fighter 🎀

💜 DESCRIPTION 💜

so here's the tea: this function will modify or set a user's or an administrator's PIN for the given token. iconique.

if you're calling it to set a PIN for the first time, then oldpin must be NULL. no old PIN exists, so don't make one up, she'll know 🙈

and when you're setting the admin's PIN with the GNUTLS_PIN_SO flag, the oldpin value must be provided. > heads up though: that requirement got relaxed after GnuTLS 3.6.5, and since then the PIN will be requested if it's missing. so like, lowkey flexible now 🫶

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. anything else? that's a negative error value, and you should go read it. no skipping 😭

💀 REPORTING BUGS 💀

found a bug? report it to <bugs@gnutls.org>. they're waiting, fr fr.

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, take it, 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, go visit:

<https://www.gnutls.org/manual/>

iykyk 📚

and that's the whole page, bestie!! this was gnutls manual page gnutls_pkcs11_token_set_pin(3), straight out of GnuTLS 3.8.13 — go forth and rotate those PINs responsibly 💖🔐✨

📦 where this page comes from