gnutls_x509_cr...tension_by_oid2(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_crq_get_extension_by_oid2 ✨

okay bestie, welcome to the gnutls manual, and specifically to this lil corner of it. this page is literally about one function and it's a whole vibe 💖

🌸 NAME 🌸

gnutls_x509_crq_get_extension_by_oid2 — it's an API function, no cap 🫶

🎀 SYNOPSIS 🎀

#include <gnutls/x509.h>

int gnutls_x509_crq_get_extension_by_oid2(gnutls_x509_crq_t crq, const
char * oid, unsigned indx, gnutls_datum_t * output, unsigned int *
critical);

💅 ARGUMENTS 💅

  • gnutls_x509_crq_t crq — bestie, this is supposed to hold a gnutls_x509_crq_t type. that's the whole assignment. 👑
  • const char * oid — holds an Object Identifier as a null terminated string. yes, a string. yes, terminated with a null. iconic behavior fr.
  • unsigned indx — so when multiple extensions with the same OID are hanging out in there, this tells the function which one you want. use (0) to grab the first one. zero-indexed, we love to see it ✨
  • gnutls_datum_t * output — this bad boy will hold the allocated extension data. allocated!! so like, it's yours now, handle it. 💀
  • unsigned int * critical — will be non-zero if the extension is marked as critical. that's it, that's the whole job. 🦋

🌈 DESCRIPTION 🌈

so the way that this works: this function will return the extension specified by the OID in the certificate. 🎯

and the extensions get returned as binary data, DER encoded, in the buffer you provided. DER encoded!! like, raw bytes, not a cute lil string. don't @ me about it, that's just the deal. 🍓

⭐ RETURNS ⭐

  • on success, GNUTLS_E_SUCCESS (0) is returned. slay. 💖
  • otherwise you get a negative error code, because something went wrong. 😭
  • and if the certificate does not contain the extension you asked for? you get GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE. it's giving "not found bestie, sorry". 🙈

🧚 SINCE 🧚

3.3.8 — been here since 3.3.8, an OG fr fr. 💜

🔥 REPORTING BUGS 🔥

found a bug? don't suffer in silence, tell the people:

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. (yes that's the exact deal, it's very generous of them, we stan 🫶)

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

ngl bestie, that's the whole page. go forth and read your extensions. 💅✨

and that's a wrap!! this was gnutls 3.8.13, the gnutls_x509_cr...tension_by_oid2(3) page, brought to you with love from the gnutls manual. mwah 💖 🎀

📦 where this page comes from