gnutls_pkcs7_verify(3)

💖 gnutls_pkcs7_verify(3) 💖

okay bestie, welcome to the gnutls manual, page gnutls_pkcs7_verify(3). this one is lowkey a whole vibe — it's the API function that checks whether some data actually matches a signature sitting inside a PKCS 7 structure. let's get into it 🎀

---

✨ NAME ✨

gnutls_pkcs7_verify — API function 🫶

---

✨ SYNOPSIS ✨

#include <gnutls/pkcs7.h>

int gnutls_pkcs7_verify(gnutls_pkcs7_t pkcs7, gnutls_x509_trust_list_t
tl, gnutls_typed_vdata_st * vdata, unsigned int vdata_size, unsigned
idx, const gnutls_datum_t * data, unsigned flags);

like yes, that's a lot of arguments. we'll go through every single one, no skipping, periodt 💅

---

✨ ARGUMENTS ✨

• gnutls_pkcs7_t pkcs7 — this should contain a gnutls_pkcs7_t type. it's the PKCS 7 structure we're vibing with 💜
• gnutls_x509_trust_list_t tl — a list of trusted certificates. the guest list for this party, fr fr 🔥
• gnutls_typed_vdata_st * vdata — an array of typed data ✨
• unsigned int vdata_size — the number of data elements. how many are in that array 👑
• unsigned idx — the index of the signature info to check. which one are we looking at 👀
• const gnutls_datum_t * data — the data to be verified, or NULL 🦋
• unsigned flags — zero, or an OR list of gnutls_certificate_verify_flags 🌸

---

✨ DESCRIPTION ✨

so the way this works is: this function verifies the provided data against the signature that's present in the SignedData of the PKCS 7 structure. that's the whole main character moment 💅

and if the data you passed in is NULL? not a problem bestie — then the data in the encapsulatedContent field gets used instead. iconic behaviour honestly 🎀

---

✨ RETURNS ✨

on success, GNUTLS_E_SUCCESS (0) is returned 🎉 otherwise you get a negative error value, and we do NOT love that for us 😭

specifically:

• a verification error results in a GNUTLS_E_PK_SIG_VERIFY_FAILED
• the lack of encapsulated data to verify results in a GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE

ngl if you see one of those negative values, something did not slay. read it, don't ignore it 🙈

---

✨ SINCE ✨

3.4.2 — she's been around a minute, a true veteran 💖

---

✨ REPORTING BUGS ✨

found a bug? don't gatekeep it, report it 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. so like, go off, but keep the receipts bestie 🫶

---

✨ 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, no cap 💅 this was gnutls, version 3.8.13, on the gnutls_pkcs7_verify(3) page — go verify something and slay ✨🎀💖