gnutls_pkcs11_obj_export(3)

💖 gnutls_pkcs11_obj_export 💖

okay bestie, welcome to the gnutls manual page for gnutls_pkcs11_obj_export(3) — yes that's a mouthful, but she's an API function and she's here to hand you your PKCS11 object data. let's get into it 🎀

---

✨ NAME ✨

gnutls_pkcs11_obj_export — API function. literally what it says on the tin, she exports.

---

🦋 SYNOPSIS 🦋

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_obj_export(gnutls_pkcs11_obj_t obj, void *
output_data, size_t * output_data_size);

yes the signature wraps like that, don't @ me, that's just how it's printed 💅

---

🌸 ARGUMENTS 🌸

• gnutls_pkcs11_obj_t obj — holds the object. she's the one carrying the goods 🫶
• void * output_data — will contain the object data. this is where the magic lands ✨
• size_t * output_data_size — holds the size of output_data, and get this: it will be replaced by the actual size of parameters. so she's an in-and-out girlie, she does both 😭

---

💜 DESCRIPTION 💜

so this function will export the PKCS11 object data. periodt.

but ngl, it is normal for data to be inaccessible, and in that case GNUTLS_E_INVALID_REQUEST will be returned. so if you get that, it's not you, it's the object being private 🙈

and if the buffer you provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. she's basically telling you "bestie your buffer is too small, here's the size you actually need, try again" 💀

---

👑 RETURNS 👑

in case of failure a negative error code will be returned, and GNUTLS_E_SUCCESS (0) on success. simple as that, zero is the slay number ✨

---

⭐ SINCE ⭐

2.12.0 — she's been iconic since way back, a true veteran 🎀

---

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence, report it to <bugs@gnutls.org>.

home page: https://www.gnutls.org — go say hi 🫶

---

🌈 COPYRIGHT 🌈

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 you can share her, 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 page bestie, no cap, every single detail preserved 💖

gnutls version 3.8.13 · gnutls_pkcs11_obj_export(3) · mwah, go export something iconic 🦋✨🎀