gnutls_pkcs7_sign(3)

💖 gnutls_pkcs7_sign — like, the PKCS#7 signing era 💖

okay bestie, this one lives in the gnutls manual (section 3, the library functions girlies), and it's literally the "put a signature on a PKCS 7 structure" function. no cap. let's get into it 🎀

---

✨ NAME ✨

gnutls_pkcs7_sign — API function 🦋

---

✨ SYNOPSIS ✨

#include <gnutls/pkcs7.h>

int gnutls_pkcs7_sign(gnutls_pkcs7_t pkcs7, gnutls_x509_crt_t signer,
gnutls_privkey_t signer_key, const gnutls_datum_t * data,
gnutls_pkcs7_attrs_t signed_attrs, gnutls_pkcs7_attrs_t unsigned_attrs,
gnutls_digest_algorithm_t dig, unsigned flags);

---

✨ ARGUMENTS ✨

• gnutls_pkcs7_t pkcs7 — should contain a gnutls_pkcs7_t type 💅
• gnutls_x509_crt_t signer — the certificate that's doing the signing of the structure 👑
• gnutls_privkey_t signer_key — the key that's doing the signing of the structure 🔑
• const gnutls_datum_t * data — the data to be signed, or NULL if the data are already embedded 🫣
• gnutls_pkcs7_attrs_t signed_attrs — any additional attributes to be included in the signed ones (or NULL) ✍️
• gnutls_pkcs7_attrs_t unsigned_attrs — any additional attributes to be included in the unsigned ones (or NULL) 🙈
• gnutls_digest_algorithm_t dig — the digest algorithm to use for signing 🌈
• unsigned flags — should be zero or one of the GNUTLS_PKCS7 flags ⭐

---

✨ DESCRIPTION ✨

so this function will add a signature into the PKCS 7 structure you handed it, for the data you handed it. that's the whole assignment bestie, and it ate 💅

and the iconic part? you can make multiple signatures with different signers. not me being a polyamorous-signature icon 🔥

the available flags are: GNUTLS_PKCS7_EMBED_DATA, GNUTLS_PKCS7_INCLUDE_TIME, GNUTLS_PKCS7_INCLUDE_CERT, and GNUTLS_PKCS7_WRITE_SPKI. they are explained in the gnutls_pkcs7_sign_flags definition — go read that one, iykyk 📖

---

✨ RETURNS ✨

on success, GNUTLS_E_SUCCESS (0) is returned 🎉 otherwise you get a negative error value 😭 (it's giving "the vibe check failed", fr fr)

---

✨ SINCE ✨

3.4.2 — a classic, been serving since way back 🧚

---

✨ REPORTING BUGS ✨

report bugs to <bugs@gnutls.org>. 📬

home page: https://www.gnutls.org 🌐

---

✨ COPYRIGHT ✨

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. slay, that's the license, no gatekeeping here 💖

---

✨ 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 3.8.13, dated with the gnutls_pkcs7_sign(3) footer energy — mwah, go sign something, periodt 💅✨