gnutls_x509_crt_sign(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_x509_crt_sign(3) — the "please sign this cert bestie" function 💖

okay so this is a page from the gnutls manual, section 3 (library calls, iykyk), and it's all about gnutls_x509_crt_sign. it's giving "cryptographic notary" energy and honestly? iconic. 🎀

✨ NAME ✨

gnutls_x509_crt_sign — it's an API function, periodt. no cap.

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crt_sign(gnutls_x509_crt_t crt, gnutls_x509_crt_t
issuer, gnutls_x509_privkey_t issuer_key);

look at her. three little params. so tidy. 💅

🦋 ARGUMENTS 🦋

  • gnutls_x509_crt_t crt — bestie, this is a certificate, and its type is literally gnutls_x509_crt_t. it's the one getting signed. main character of the operation honestly 👑
  • gnutls_x509_crt_t issuer — this is the certificate of the certificate issuer. yeah. the issuer's cert. we love a self-explanatory name fr fr 🌈
  • gnutls_x509_privkey_t issuer_key — and this bad boy holds the issuer's private key. guard it with your life, bestie, it's a private key for a reason 🙈

💜 DESCRIPTION 💜

okay so here's the tea: this function is the same as gnutls_x509_crt_sign2() — but with no flags, and with an appropriate hash algorithm chosen for you. it's the low-effort, high-reward version. slay. ✨

and about that hash algorithm — lowkey important — the hash algorithm used may vary between versions of GnuTLS, and it's tied to the security level of the issuer's public key. so don't go assuming it's always gonna be the same one, bestie. it vibes with your key's security level. 🔥

⭐ RETURNS ⭐

  • on success? GNUTLS_E_SUCCESS — that's a 0, and it's giving "we ate" 🍓
  • otherwise you get a negative error value. which is giving "not me getting a negative number 😭"

🎀 REPORTING BUGS 🎀

found a bug? spill it to <bugs@gnutls.org>. they wanna hear about it fr.

Home page: https://www.gnutls.org

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. (basically: keep the receipts, and you're good 🫶)

🌈 SEE ALSO 🌈

the full documentation for gnutls is maintained as a Texinfo manual. so if the /usr/share/doc/gnutls/ directory does not contain the HTML form, then go visit:

https://www.gnutls.org/manual/

that's the link. go. click. you're welcome. 💅

no cap, this is the whole page. every option, every argument, every word — all still here. the vibe just got a glow-up. 💖

and that's a wrap, bestie 🧚 — this page came to you from the gnutls manual, version 3.8.13, and its lil footer signature reads gnutls_x509_crt_sign(3). go forth and sign those certs responsibly 💜🌸

📦 where this page comes from