gnutls_x509_crt_check_email(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_check_email ✨

okay bestie, so this one lives in the gnutls manual, section 3, and it's literally called gnutls_x509_crt_check_email(3). it's an API function, it's giving "does this cert actually belong to this email or is it lying to us" energy, and we're gonna go through it together 🎀

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

unsigned gnutls_x509_crt_check_email(gnutls_x509_crt_t cert, const char
* email, unsigned int flags);

like yes, that's the whole thing, she's short and she knows exactly what she wants 💅

🦋 ARGUMENTS 🦋

  • gnutls_x509_crt_t cert — bestie this one should contain an gnutls_x509_crt_t type. that's the assignment. that's the whole job description.
  • const char * email — a null terminated string that contains an email address (RFC822). yes, actual RFC822, not vibes-based email. so bring the real thing ✨
  • unsigned int flags — should be zero. that's it. that's the whole rule. zero, queen, nothing else 👑

💖 DESCRIPTION 💖

so what does she do? this function will check if the given certificate's subject matches the given email address.

that's it. that's the function. no cap. it looks at the subject of your cert, looks at your email string, and goes "hmm… do these two know each other?" 🔍💌

⭐ RETURNS ⭐

  • non-zero → successful match, slay, they match, we love to see it 🫶
  • zero → failure, no match, tragic, we move on 😭

🙈 REPORTING BUGS 🙈

found a bug? not me finding a bug 🙈 please report bugs to <bugs@gnutls.org>.

Home page: https://www.gnutls.org — go say hi, she's iconic.

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 basically: keep the notice, keep the notice, and you're golden 💛

🌈 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/

okay and that's the page fr fr 💜 this was gnutls 3.8.13 — the footer energy, the version, all of it — go check the cert, check the email, and stay hydrated bestie 🍓🧚✨

📦 where this page comes from