gnutls_ocsp_req_get_extension(3)

💖 gnutls_ocsp_req_get_extension(3) 💖

okay bestie, welcome to the gnutls manual page for gnutls_ocsp_req_get_extension — yes that's a whole mouthful, we're getting through it together 🫶

---

✨ NAME ✨

gnutls_ocsp_req_get_extension — it's an API function, bestie. that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

#include <gnutls/ocsp.h>

int gnutls_ocsp_req_get_extension(gnutls_ocsp_req_const_t req, unsigned
indx, gnutls_datum_t * oid, unsigned int * critical, gnutls_datum_t *
data);

---

🎀 ARGUMENTS 🎀

• gnutls_ocsp_req_const_t req — this one should contain a gnutls_ocsp_req_t type, like that's its whole job.
• unsigned indx — specifies which extension OID to get. use (0) to get the first one, periodt.
• gnutls_datum_t * oid — will hold a newly allocated buffer with the OID of the extension. may be NULL, no pressure.
• unsigned int * critical — output variable with the critical flag, may be NULL.
• gnutls_datum_t * data — will hold a newly allocated buffer with the extension data, may be NULL.

---

🦋 DESCRIPTION 🦋

so the way that this function works is: it will return all the information about the requested extension in the OCSP request. the info you get back is the OID, the critical flag, and the data itself. the extension OID will be stored as a string, iconic behavior honestly. any of oid, critical, and data may be NULL, which means the caller is simply not interested in getting that information back — and that's valid, we respect it. 💜

⚠️ the caller needs to deallocate memory by calling gnutls_free() on oid->data and data->data. do not skip this. the memory is not gonna free itself, bestie 😭

also since 3.7.0, oid->size does not account for the terminating null byte. noted. no cap.

---

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned — slay. otherwise a negative error code is returned. and if you have reached the last extension available, GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned, which is basically the function telling you "that's all of them, girl, there's no more 🥲".

---

🙈 REPORTING BUGS 🙈

found a bug? report it to <bugs@gnutls.org>. they wanna know, fr fr.

home page: https://www.gnutls.org — go look, it's giving official.

---

👑 COPYRIGHT 👑

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, royalty-free, we love a generous licensing moment ✨

---

🌈 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, you ate that 💅✨ this was gnutls version 3.8.13, page gnutls_ocsp_req_get_extension(3) — go forth and get those extensions, you main character 🦋💖