gnutls_ocsp_status_request_get2(3)

πŸ’– gnutls_ocsp_status_request_get2(3) πŸ’–

okay so bestie, welcome to the gnutls manual page for gnutls_ocsp_status_request_get2 β€” yes it's a long name, yes it's an API function, and yes we're gonna get through it together 🫢


✨ NAME ✨

gnutls_ocsp_status_request_get2 β€” it's an API function, and it's here to hand you back an OCSP status response. iconic behavior tbh πŸ‘‘


🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

int gnutls_ocsp_status_request_get2(gnutls_session_t session, unsigned
idx, gnutls_datum_t * response);

like. look at that signature. she's serving C, she's serving clarity πŸ’…


πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_session_t session β€” bestie this is just a gnutls_session_t type. that's it. that's the whole vibe.
  • unsigned idx β€” the index of the peer's certificate. think of it like a little numbered seat at the table πŸͺ‘
  • gnutls_datum_t * response β€” a gnutls_datum_t holding the DER encoded OCSP response. DER encoded, no cap.

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's the tea β˜• this function returns the OCSP status response that came in from the TLS server, specifically for the certificate index you handed it.

and the index? it lines up with the certificates as returned by gnutls_certificate_get_peers. so they're matching sets, like bestie bracelets fr fr πŸ’ž

when the index is zero, this function operates identically to gnutls_ocsp_status_request_get(). same energy, no notes.

the returned response should be treated as constant. do not go messing with it, she is not yours to edit πŸ™ˆ

and if there's no OCSP response available for the given index? you get GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE back. it's giving "we looked, she's not here" 😭


⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned πŸŽ‰ otherwise a negative error code comes back. negative. like the vibes after a failed request πŸ’€


🌈 SINCE 🌈

3.6.3 β€” she's been around, she's established, she's lowkey a legend 🧚


πŸ“ REPORTING BUGS πŸ“

found a bug? do NOT suffer in silence bestie, report it to <bugs@gnutls.org>. they wanna hear it.

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. (yes, that means the whole thing β€” the notice and this notice, both preserved, 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/


and that's the whole page bestie, you ate that 🫢 this was gnutls_ocsp_status_request_get2(3) from gnutls 3.8.13 β€” go forth, call your function, treat that response as constant, mwah πŸ’‹πŸ’–

πŸ“¦ where this page comes from