gnutls_pkcs11_obj_export2(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_obj_export2(3) 💖

okay bestie, so this one lives in the gnutls manual (that's the manual name, cute right) and it's literally the "gimme the actual bytes out of my PKCS#11 object" function. let's get into it ✨

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_obj_export2(gnutls_pkcs11_obj_t obj, gnutls_datum_t * out);

🎀 ARGUMENTS 🎀

  • gnutls_pkcs11_obj_t obj — the object you're holding, bestie. this is the one you're trying to export from 🫶
  • gnutls_datum_t * out — this pointer is where the object data ends up. it will contain the object data, no cap.

✨ DESCRIPTION ✨

so this function will export the PKCS11 object data. that's the whole vibe. 💅

ngl though, it is normal for data to be inaccessible — some objects just don't wanna be read like that 🙈 — and in that case GNUTLS_E_INVALID_REQUEST will be returned. not a bug, just how it is.

the output buffer is allocated using gnutls_malloc(), so that's the allocator you're dealing with. remember it. your future self will thank you.

🔥 RETURNS 🔥

in case of failure a negative error code will be returned, and GNUTLS_E_SUCCESS (0) on success. so like, check for that zero, bestie. 0 = slay. anything negative = 😭.

⭐ SINCE ⭐

3.1.3 — she's been around a minute, a true icon 👑

💜 REPORTING BUGS 💜

found something cursed? 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 yes, go off, distribute 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, visit:

https://www.gnutls.org/manual/
okay that's the whole page, you ate that 💖 go export some objects and be the main character of your own PKCS#11 adventure 🦋

gnutls version 3.8.13, page gnutls_pkcs11_obj_export2(3) — mwah, that's a wrap 🎀✨

📦 where this page comes from