gnutls_pkcs11_copy_x509_crt2(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_x509_crt2 — NAME ✨

okay so bestie 💖 this is gnutls_pkcs11_copy_x509_crt2, an API function living in the gnutls manual (section 3, the library-functions girlies). It's the one that copies a cert into a PKCS 11 token, and yes she serves. 🎀

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_copy_x509_crt2(const char * token_url,
gnutls_x509_crt_t crt, const char * label, const gnutls_datum_t * cid,
unsigned int flags);

that signature is copy-pasted exactly, no cap, don't let anyone tell you otherwise 💅

🫶 ARGUMENTS 🫶

  • const char * token_url — a PKCS 11 URL that specifies a token. that's the where, bestie. 📍
  • gnutls_x509_crt_t crt — the certificate you're copying. the whole point of the mission. 🌟
  • const char * label — the name to be used for the stored data. this is what you're calling it. name her, she deserves it. ✨
  • 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 like, hand it an ID or hand it nothing and it'll do the math itself, main character energy fr fr 🔥
  • unsigned int flags — one of GNUTLS_PKCS11_OBJ_FLAG_*. pick your flag, girlie. 🚩

💖 DESCRIPTION 💖

This function will copy a certificate into a PKCS 11 token specified by a URL. periodt.

Valid flags to mark the certificate:

  • 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 four, no more no less, that's the vibe check and she passed. 💯

🦋 RETURNS 🦋

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.

so 0 means slay, negative means we're crying in the group chat 😭

⭐ SINCE ⭐

3.4.0 — she's been iconic since day one, lowkey a legend. 👑

🐛 REPORTING BUGS 🐛

Report bugs to <bugs@gnutls.org>.

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

if something's broken, tell the maintainers, not me, I'm just the messenger bestie 🫶

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.

like, free to share, just keep the receipts, that's the rule. 💜

🌈 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/

go read it, iykyk 📚✨

and that's the whole page bestie 💖 written for the gnutls manual, version 3.8.13, page gnutls_pkcs11_copy_x509_crt2(3) — go forth and copy those certs, you absolute icon 👑🎀🦋

📦 where this page comes from