gnutls_system_key_add_x509(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_system_key_add_x509 ✨

okay bestie, welcome to the gnutls manual, and today's main character is gnutls_system_key_add_x509 from the gnutls section 3 pages. it's an API function, it's giving very "let me file this for you" energy, and we're gonna get into it. 💅

🌸 NAME 🌸

gnutls_system_key_add_x509 — literally an API function, that's the whole name, no notes 🫶

🎀 SYNOPSIS 🎀

#include <gnutls/system-keys.h>

int gnutls_system_key_add_x509(gnutls_x509_crt_t crt,
gnutls_x509_privkey_t privkey, const char * label, char ** cert_url,
char ** key_url);

like. look at her. iconic signature. ✨

🦋 ARGUMENTS 🦋

  • gnutls_x509_crt_t crt — the certificate that's getting added, bestie. the actual cert. 👑
  • gnutls_x509_privkey_t privkey — and the key that's getting added. they come as a pair, they're a package deal, fr fr. 🔑
  • const char * label — the friendly name that describes the key. like a lil nickname so you know who's who. 🏷️
  • char ** cert_url — if this is non-NULL, it'll end up holding an allocated value with the certificate URL. allocated!! so that's yours to deal with. 💖
  • char ** key_url — same vibe, if it's non-NULL it'll contain an allocated value with the key URL. 🎀

💜 DESCRIPTION 💜

so what does she actually do? this function will add the given key and certificate pair to the system list. that's it. that's the whole thing. key + cert, together, into the system list. slay. ✨

⭐ RETURNS ⭐

on success you get GNUTLS_E_SUCCESS (which is 0, love that for us). otherwise you get a negative error value, and honestly? we don't love that. 😭

🌈 SINCE 🌈

3.4.0 — she's been around, she's got history, she's a legacy icon. 👑

🙈 REPORTING BUGS 🙈

found a bug? not me being the messenger but:

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, but 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!! this was gnutls_system_key_add_x509(3), brought to you by gnutls 3.8.13 — mwah, go add some key pairs, ily 🫶💖✨

📦 where this page comes from