GNUTLS_X509_CRL_GET_EXTENSION_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_crl_get_extension_oid(3) 💖

okay bestie, welcome to the gnutls manual, section 3 — the one where we read extension OIDs out of a CRL. yes it's niche. yes it's iconic. let's go 🎀

✨ NAME ✨

gnutls_x509_crl_get_extension_oid — it's an API function, and it's about to be your new fave, no cap 🦋

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crl_get_extension_oid(gnutls_x509_crl_t crl, unsigned
indx, void * oid, size_t * sizeof_oid);

like, look at that signature. it's giving competence. 💅

🎀 ARGUMENTS 🎀

  • gnutls_x509_crl_t crl — this is the one that should contain a gnutls_x509_crl_t type. it's the CRL we're snooping through, periodt.
  • unsigned indx — tells the function which extension OID you want to get. use (0) to get the very first one. the way that indexing starts at zero… math ate, fr fr. 🔢
  • void * oid — a pointer where the OID gets stored. and bestie, it may be null — yes, really, that's allowed. 🙈
  • size_t * sizeof_oid — initially holds the size of oid. it's the little size-keeper of the operation. 🫶

💖 DESCRIPTION 💖

so what does this actually do? this function will return the requested extension OID in the CRL. that's it, that's the job. the extension OID gets stored as a string in the provided buffer. clean, simple, lowkey elegant. ✨

🔥 RETURNS 🔥

on success, GNUTLS_E_SUCCESS (0) is returned — slay, we love a zero. otherwise you get a negative error code in case of an error. 😭

and if you've reached the last extension available, you get GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE back. that's not a vibe failure, that's just the end of the list, bestie. 🦋

⭐ SINCE ⭐

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

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, tell the gnutls girlies:

ngl, if you found something weird, report it. the maintainers want to know. 🫶

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.

that's the legal bit and we do not touch the legal bit. copy it, distribute it, just keep the notice. periodt. 💅

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

like, if the local docs aren't serving, the website always eats. 🌸

and that's the whole page bestie 🎀 this was gnutls version 3.8.13, and yeah — it's the gnutls_x509_crl_get_extension_oid(3) manual, the one and only. go read some CRL extensions, you're doing amazing, mwah 💖🦋✨

📦 where this page comes from