gnutls_x509_cr...key_purpose_oid(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_cr...key_purpose_oid(3) 💖

okay bestie, sit down, hydrate, because we're talking about gnutls_x509_crt_set_key_purpose_oid — part of the gnutls manual, and honestly? she's a baddie. this is the one that tells a certificate what it's allowed to be used for. main character energy for your X.509 certs, fr fr. 🎀

✨ NAME ✨

gnutls_x509_crt_set_key_purpose_oid — it's an API function, periodt. 💅

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crt_set_key_purpose_oid(gnutls_x509_crt_t cert, const
void * oid, unsigned int critical);

like, look at her. three args, one return, no drama. 🦋

🫶 ARGUMENTS 🫶

  • gnutls_x509_crt_t cert — bestie this is your certificate, and it's gotta be of type gnutls_x509_crt_t. no substitutions, no knockoffs, the real thing only. 👑
  • const void * oid — a pointer to a null terminated string that holds the OID. yes, null terminated, she needs her little \0 at the end or she's lost. 😭
  • unsigned int critical — this is the vibe check on your extension: are we marking it critical or not? that's literally it, that's the whole question. ⭐

🔥 DESCRIPTION 🔥

okay so here's the tea: this function sets the key purpose OIDs of the Certificate. the way that they live inside the Extended Key Usage extension (2.5.29.37) — iconic behavior, no cap. and if you want human readable names instead of raw OID strings? go look at the GNUTLS_KP_* definitions. iykyk. 💜

and listen — subsequent calls to this function will append OIDs to the OID list. so it's not a "replace everything" situation, it's a "yes and" situation. every call stacks another one on. so don't call it twice thinking you're overwriting, because you are absolutely not. 🙈

🌈 RETURNS 🌈

on success you get GNUTLS_E_SUCCESS (0) and honestly? we love a zero. otherwise you get a negative error code, which is giving "something went wrong, go read the error". 😭

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, bestie. report it to <bugs@gnutls.org> — they want to hear from you fr 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. so like, go forth and share, just 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 one's from gnutls 3.8.13 (source/version, as promised) — go set some key purpose OIDs and slay responsibly. mwah. 💋🎀

📦 where this page comes from