GNUTLS_CERTIFICATE_SET_OCSP_STATUS_REQUEST_FILE2(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

💖 NAME 💖

gnutls_certificate_set_ocsp_status_request_file2 — bestie, it's an API function and it's here to load your OCSP responses from a file, no cap 🎀

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int
gnutls_certificate_set_ocsp_status_request_file2(gnutls_certificate_credentials_t
sc, const char * response_file, unsigned idx, gnutls_x509_crt_fmt_t
fmt);

🌸 ARGUMENTS 🌸

  • gnutls_certificate_credentials_t sc — ok so this is your credentials structure. the whole vibe lives here 💅
  • const char * response_file — literally just a filename. the filename of the OCSP response. that's it 🦋
  • unsigned idx — a certificate index, and it's the same kind of index that gnutls_certificate_set_key() and friends hand back to you ✨
  • gnutls_x509_crt_fmt_t fmt — it's PEM or DER. pick one, bestie 🙈

💜 DESCRIPTION 💜

So this function loads up the OCSP responses that are gonna be sent to the peer, for the certificate chain you picked with idx. And here's the cute part: when fmt is set to PEM, you can load multiple responses at once. iconic behavior fr fr 👑

Timing matters, bestie! This function must be called after setting any certificates. And it cannot be used for certificates that are provided via a callback — that is, when gnutls_certificate_set_retrieve_function() is used. In that case, consider using gnutls_certificate_set_retrieve_function3() instead. the way that's a whole different function 😭

You can also call this function multiple times when multiple responses applicable to the certificate chain are available. stacking responses? we love to see it 🫶

Now for the ✨drama✨ — the error codes:

  • If the response you provided does not match any certificates present in the chain, you get GNUTLS_E_OCSP_MISMATCH_WITH_CERTS back. mismatch, not me 💀
  • If the response is already expired at the time of loading, you get GNUTLS_E_EXPIRED back. expired? in this economy? 😭

🎀 RETURNS 🎀

On success, you get the number of loaded responses returned to you. slay. otherwise you get a negative error code. sad girl hours 🌧️

⭐ SINCE ⭐

3.1.3 — vintage, honestly. a classic 🕰️

🌈 REPORTING BUGS 🌈

Found a bug? Don't just sit there, tell the gnutls girlies:

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. fr fr, that's the whole license and it's lowkey generous 💖

🦋 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 💅 this was the gnutls_certificate_set_ocsp_status_request_file2 page from the gnutls manual, version 3.8.13 — thanks for reading, ily, go load some OCSP responses responsibly 🎀✨

📦 where this page comes from