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) — bestie edition 💖

okay so this is a page from the gnutls manual, and it's all about gnutls_x509_crq_set_key_purpose_oid. yes the filename is truncated with ... like that, that's not me being dramatic, that's just how the man page is named. iykyk. 🎀

✨ NAME ✨

gnutls_x509_crq_set_key_purpose_oid — the API function that tells your certificate request what it's actually for. main character energy for your EKU, fr fr.

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crq_set_key_purpose_oid(gnutls_x509_crq_t crq, const
void * oid, unsigned int critical);

like… it's giving "three arguments, one job, no cap." 💅

🦋 ARGUMENTS 🦋

  • gnutls_x509_crq_t crq — a certificate of type gnutls_x509_crq_t. this is your crq, your little guy, the thing you're editing. 🫶
  • const void * oid — a pointer to a null-terminated string that holds the OID. note: a string, not a struct, not a vibe, a string. ✨
  • unsigned int critical — whether this extension will be critical or not. yes/no energy. you decide how loud it gets. 🔥

💜 DESCRIPTION 💜

so this function sets the key purpose OIDs of the Certificate. lowkey important, highkey iconic.

these are stored in the Extended Key Usage extension (2.5.29.37) — that's the magic number right there, remember it, it's on the quiz. 📝

and hey, if you don't wanna memorize raw OID dot-numbers like some kind of gremlin, check the GNUTLS_KP_* definitions for human readable names. they're literally right there for you. 💖

Subsequent calls to this function will append OIDs to the OID list. so it's not overwrite, it's add. it just keeps stacking them. obsessed. ✨

👑 RETURNS 👑

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. so like, zero means slay, anything negative means we're not slaying. 😭

⭐ SINCE ⭐

2.8.0 — she's been around since 2.8.0, a real veteran, a legend tbh. 🌈

🎀 REPORTING BUGS 🎀

found a bug? don't just sit there, bestie. Report bugs to <bugs@gnutls.org>.

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, take it, share it, just keep the receipts. respect the notice. 🫶)

🌸 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/
fr fr that's the whole page, nothing skipped, every flag and number accounted for. no cap. 💀

this whole thing is from gnutls version 3.8.13, page gnutls_x509_cr...key_purpose_oid(3) — and yeah the ... is still there, it's part of the name, we don't question it. bye bestie, go set some key purpose OIDs responsibly 🧚💜

📦 where this page comes from