gnutls_pkcs11_...ached_extension(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_attached_extension ✨

okay bestie, so this one lives in the gnutls manual, section 3, and it's literally called gnutls_pkcs11_copy_attached_extension — yes the whole vibe is "copy an attached extension into a PKCS 11 token" and honestly? iconic. 🎀

🌸 NAME 🌸

gnutls_pkcs11_copy_attached_extension — it's an API function, no cap 💅

🦋 SYNOPSIS 🦋

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_copy_attached_extension(const char * token_url,
gnutls_x509_crt_t crt, gnutls_datum_t * data, const char * label,
unsigned int flags);

💖 ARGUMENTS 💖

  • const char * token_url — a PKCS 11 URL that specifies a token. it's giving "where are we putting this" energy ✨
  • gnutls_x509_crt_t crt — an X.509 certificate object 🎀
  • gnutls_datum_t * data — the attached extension, right there in your hands
  • const char * label — a name to be used for the attached extension, and lowkey it may be NULL 🫶
  • unsigned int flags — one of GNUTLS_PKCS11_OBJ_FLAG_* (pick from that family, bestie)

🌈 DESCRIPTION 🌈

so this function will copy the attached extension sitting in data for the certificate you passed in crt, and it drops it into the PKCS 11 token specified by the URL — and yes, typically a trust module 👑

the extension has to be in RFC5280 Extension format, periodt. no other format, no exceptions. 📜

⭐ RETURNS ⭐

on success you get GNUTLS_E_SUCCESS (0) back 🥳 — otherwise it returns a negative error value, which is the universe saying "not today" 😭

🧚 SINCE 🧚

3.3.8 — a whole era 💜

🙈 REPORTING BUGS 🙈

spotted a bug? don't be shy, tell the devs:

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. (basically: be nice, 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/
ok bestie that's the whole thing, every flag, every argument, every caveat — nothing skipped, nothing invented, just vibes and accuracy 💅

gnutls version 3.8.13, and this page is dated with the same release — mwah, love that for us 🎀✨🦋

📦 where this page comes from