gnutls_pkcs11_token_get_random(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_get_random(3) 💖

okay bestie, sit down, hydrate, because we're about to talk about pulling literal randomness straight out of a PKCS 11 token ✨ this one lives in the gnutls manual (that's the 3 in the name, library-call vibes, iykyk) and it's genuinely such a neat little function.

✨ NAME ✨

gnutls_pkcs11_token_get_random — API function 🎀

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_token_get_random(const char * token_url, void *
rnddata, size_t len);

🦋 ARGUMENTS 🦋

  • const char * token_url — a PKCS 11 URL that specifies a token. like, which token are we talking to, bestie? 👑
  • void * rnddata — a pointer to the memory area that's gonna get filled with random data 💅
  • size_t len — how many bytes of randomness you're asking for. the amount. the quantity. the vibe. 🍓

💜 DESCRIPTION 💜

so this function grabs random data from the given token. no cap. it stores it in rnddata and fills the memory that rnddata points at with len random bytes straight from the token. that's the whole thing, and honestly? iconic. ✨

⭐ RETURNS ⭐

on success you get GNUTLS_E_SUCCESS (that's 0, the good number 🫶). otherwise you get a negative error value, which is the universe telling you something went sideways 😭

💀 REPORTING BUGS 💀

found a bug? tell the gnutls girlies about it at <bugs@gnutls.org>.

home page: https://www.gnutls.org

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

copying and distributing this file — with or without modification — is permitted in any medium without royalty, as long as you keep the copyright notice and this notice. so like, go off, just leave the receipts 💅

🌈 SEE ALSO 🌈

the full documentation for gnutls lives in a Texinfo manual. if the /usr/share/doc/gnutls/ directory doesn't have the HTML form, go visit

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

and that's the whole page, bestie!! 💖 mwah. this was gnutls 3.8.13 talking about gnutls_pkcs11_token_get_random(3) — thanks for reading the whole thing, you're literally the main character 🧚✨💅

📦 where this page comes from