gnutls_pkcs12_bag_get_data(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_pkcs12_bag_get_data(3) 💖

okay bestie, welcome to the gnutls manual — this one's a lil function called gnutls_pkcs12_bag_get_data, and it's literally the "hey can u hand me what's inside this bag" function. no cap. ✨

🎀 NAME 🎀

gnutls_pkcs12_bag_get_data — API function

like, that's the whole name. it does what it says. iconic behaviour honestly.

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs12.h>

int gnutls_pkcs12_bag_get_data(gnutls_pkcs12_bag_t bag, unsigned indx,
gnutls_datum_t * data);

yes she's a three-argument girlie. we love a consistent signature. 🫶

🦋 ARGUMENTS 🦋

  • gnutls_pkcs12_bag_t bag — The bag 💼 like, the actual bag object you're digging around in.
  • unsigned indx — The element of the bag to get the data from. which slot, bestie, which slot.
  • gnutls_datum_t * data — where the bag's data will be. Should be treated as constant. 🚨 constant, okay? don't go messing with it.

✨ DESCRIPTION ✨

So this function will return the bag's data. that's it. that's the job. 💅

The data is a constant that is stored into the bag — meaning it's not a lil copy just for you, it's the thing, living inside the bag.

🚨 important bestie alert: Should not be accessed after the bag is deleted. the bag dies, the data dies with it. do not be out here using a pointer to a deleted bag's guts, that's giving undefined behaviour and we do NOT want that energy. 😭

👑 RETURNS 👑

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

so like — zero is the slay. anything negative is the "something went wrong, check it" vibe. ⭐

🌈 REPORTING BUGS 🌈

found a bug? not the vibe, but okay, tell the people:

they wanna know fr fr. 🐛

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.

(translation: take it, share 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/

go read the whole thing, i promise it's worth it. 📚

and that's the page, bestie!! 💅 this was gnutls_pkcs12_bag_get_data(3) from the gnutls manual, version 3.8.13 — mwah, love that for us. go forth and get your bag's data (but like, not after you delete the bag, ok?). periodt. 🎀💖✨

📦 where this page comes from