gnutls_pkcs12_bag_set_privkey(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_set_privkey ✨

okay bestie, this one lives in the gnutls manual (section 3, the library-calls girlies 💅), and it's genuinely one of the cuter little functions. no cap.

🌸 NAME 🌸

gnutls_pkcs12_bag_set_privkey — API function 💖

🎀 SYNOPSIS 🎀

#include <gnutls/pkcs12.h>

int gnutls_pkcs12_bag_set_privkey(gnutls_pkcs12_bag_t bag,
gnutls_x509_privkey_t privkey, const char * password, unsigned flags);

like. she takes a bag, a key, a password and some flags. iconic behavior honestly 🫶

🦋 ARGUMENTS 🦋

  • gnutls_pkcs12_bag_t bag — the bag. yes literally. it's the bag. that's the whole description, she said what she said 💀
  • gnutls_x509_privkey_t privkey — the private key that's getting copied in. not moved, copied. important!! 🔥
  • const char * password — the password you're protecting the key with. and listen — it may be NULL, so don't panic if you don't have one, that's a whole valid mood ✨
  • unsigned flags — should be one of the gnutls_pkcs_encrypt_flags_t elements, bitwise or'd together. so like, you can stack them with | if you're feeling fancy 👑

💖 DESCRIPTION 💖

this function will insert the given private key into the bag. that's it, that's the job 🎀

but here's the tea — it's just a wrapper over gnutls_pkcs12_bag_set_data(). so if you already know that one, you already know her. she's not doing anything extra, she's just being convenient and cute about it 💅

🌈 RETURNS 🌈

  • on success → the index of the added bag. yay!! ⭐
  • on failure → a negative value. and no, we don't love that, but at least you'll know 😭

🙈 REPORTING BUGS 🙈

found a bug? not her fault (probably) but tell the devs anyway, they wanna know:

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 like, go off, share the love, 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/

iykyk, the Texinfo manual is lowkey the main character of documentation formats 🌸

and that's the whole page bestie!! this is from gnutls 3.8.13, the gnutls_pkcs12_bag_set_privkey(3) manual page 💖 go forth and bag those keys ✨🎀🦋

📦 where this page comes from