gnutls_pkcs11_copy_pubkey(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_copy_pubkey(3) 💖

okay bestie, welcome to the gnutls manual, this one's gnutls_pkcs11_copy_pubkey and it's literally the "put my public key on a token" button. let's get into it 🫶

✨ NAME ✨

gnutls_pkcs11_copy_pubkey — an API function, and yes she's serving exactly what the name says 💅

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_copy_pubkey(const char * token_url, gnutls_pubkey_t
pubkey, const char * label, const gnutls_datum_t * cid, unsigned int
key_usage, unsigned int flags);

there she is. six arguments. no cap. 📝

🎀 ARGUMENTS 🎀

  • const char * token_url — a PKCS 11 URL that specifies a token. like, which token are we talking to, bestie? 🔑
  • gnutls_pubkey_t pubkey — the public key you wanna copy. the main character of this whole function tbh 👑
  • const char * label — the name that's gonna be used for the stored data. her government name ✨
  • const gnutls_datum_t * cid — the CKA_ID to set for the object -if NULL, the ID will be derived from the public key. so either you hand it over or it just figures itself out, we love an independent queen 🦋
  • unsigned int key_usage — one of GNUTLS_KEY_*. pick your usage, periodt 🌈
  • unsigned int flags — one of GNUTLS_PKCS11_OBJ_FLAG_*. flag girlies rise 😌

💜 DESCRIPTION 💜

so this function will copy a public key object into a PKCS 11 token specified by a URL. it's giving "move in, make yourself at home" 🏠

valid flags to mark the key:

  • GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED
  • GNUTLS_PKCS11_OBJ_FLAG_MARK_PRIVATE
  • GNUTLS_PKCS11_OBJ_FLAG_MARK_CA
  • GNUTLS_PKCS11_OBJ_FLAG_MARK_ALWAYS_AUTH

those are the ones allowed for marking, don't go inventing your own, bestie 🙈

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value, which is the universe's way of saying "not today" 😭

🦋 SINCE 🦋

3.4.6 — vintage but still iconic, we stan a classic 💖

💀 REPORTING BUGS 💀

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

report bugs 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/

and that's the whole vibe check bestie 🫶 this was gnutls version 3.8.13, page gnutls_pkcs11_copy_pubkey(3) — go forth and copy those public keys, you absolute legend 💅🌸💖

📦 where this page comes from