GNUTLS_X509_CRQ_GET_EXTENSION_INFO(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_info(3)

okay bestie, so this one lives in the gnutls manual, section 3, and it's literally all about peeking at extensions inside a certificate request. the way this function just... reads OIDs for you. iconic behaviour, no cap. 🎀

✨ NAME ✨

gnutls_x509_crq_get_extension_info — it's an API function, and it's here to hand you the OID of an extension in a CRQ. periodt.

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crq_get_extension_info(gnutls_x509_crq_t crq, unsigned
indx, void * oid, size_t * sizeof_oid, unsigned int * critical);

🦋 ARGUMENTS 🦋

  • gnutls_x509_crq_t crq — this should contain a gnutls_x509_crq_t type. like, that's the whole vibe. 🫶
  • unsigned indx — tells us which extension number we want. use (0) to grab the very first one, bestie.
  • void * oid — a pointer, and it's where we store the OID. slay.
  • size_t * sizeof_oid — on the way in, it holds the maximum size of oid; on the way back out, it holds the actual size of oid. she's got range. 💖
  • unsigned int * critical — output variable holding the critical flag. may be NULL, no pressure.

💜 DESCRIPTION 💜

so this function returns the requested extension OID that's chillin' inside the certificate, plus the critical flag for it. the extension OID gets stored as a string in the buffer you provided. and if you wanna go get the actual data? use gnutls_x509_crq_get_extension_data() to extract it. iykyk. 🔥

and listen — if the buffer you handed over is not long enough to hold the output, then * sizeof_oid gets updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. so like, don't skimp on the buffer, okay? 😭

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error code in case of an error. and if you've reached the last extension available, GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. that's just the end of the list, babe, not a personal attack. 🙈

🌈 SINCE 🌈

2.8.0 — she's been here since 2.8.0, a true elder icon. 👑

🎀 REPORTING BUGS 🎀

found something cursed? 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, 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/

gnutls 3.8.13 — and that's the whole page, fr fr. go forth and read those extension OIDs, main character. 🦋✨💅

📦 where this page comes from