gnutls_pkcs12_get_bag(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_get_bag(3) — the gnutls manual, bestie edition 💖

okay so. this is a page from the gnutls manual, and today's main character is gnutls_pkcs12_get_bag. it's an API function, it lives in the gnutls library, and honestly? it's giving "grab one bag out of the whole PKCS12 pile" energy. 🎀

✨ NAME ✨

gnutls_pkcs12_get_bag — API function 🫶

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs12.h>

int gnutls_pkcs12_get_bag(gnutls_pkcs12_t pkcs12, int indx,
gnutls_pkcs12_bag_t bag);

🦋 ARGUMENTS 🦋

  • gnutls_pkcs12_t pkcs12 — a pkcs12 type. yes bestie, that's the whole description, we love a low-effort icon. 💅
  • int indx — holds the index of the bag you wanna extract. it's your little number, your pick-a-bag ticket. 🔢
  • gnutls_pkcs12_bag_t bag — an initialized bag, and this is where the contents of the bag get copied into. so you're not making a bag, you're bringing an empty one and letting it get filled. 👜✨

💜 DESCRIPTION 💜

so this function will return a Bag from the PKCS12 structure. that's it. that's the vibe. it reaches into your pkcs12 and pulls out a bag. 🧚

and listen — after the last Bag has been read, GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE gets returned. so when you hit that, it's not a glitch, it's the end. no more bags, the party's over, go home. 😭

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. slay. otherwise you get a negative error value, which is the universe telling you something went sideways. 💀

🌈 REPORTING BUGS 🌈

found a bug? don't be shy, tell the girlies:

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. iconic, fr fr. 💖

🍓 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. this was gnutls version 3.8.13, and we ate. 🎀✨💅

📦 where this page comes from