gnutls_certificate_get_crt_raw(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_certificate_get_crt_raw(3) 💖

okay bestie, so this one lives in the gnutls manual and it's genuinely such a handy lil function. it's an API function, and it's about pulling raw certs out of your credentials object. let's get into it 🎀

✨ NAME ✨

gnutls_certificate_get_crt_raw — API function

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

int gnutls_certificate_get_crt_raw(gnutls_certificate_credentials_t sc,
unsigned idx1, unsigned idx2, gnutls_datum_t * cert);

🦋 ARGUMENTS 🦋

  • gnutls_certificate_credentials_t sc — bestie this is a gnutls_certificate_credentials_t type, that's the whole vibe.
  • unsigned idx1 — the index of the certificate chain, like, if multiple chains are present. multiple? yes queen, pick one.
  • unsigned idx2 — the index of the certificate in the chain. and listen: zero gives you the server's certificate. 0 = main character energy 👑
  • gnutls_datum_t * cert — this is gonna hold the DER encoded certificate. it's the output, it's the moment ✨

💅 DESCRIPTION 💅

so what does it actually do? it returns the DER encoded certificate of the server, or literally any other certificate on its certificate chain — which one you get depends on idx2. slay.

⚠️ okay important, no cap: the returned data should be treated as constant and is only accessible during the lifetime of sc. do not go freeing it, do not go outliving your credentials object, that's not the move. 🙈

and idx1 matches the value from gnutls_certificate_set_x509_key() and friends. the functions. the little squad. iykyk 💜

⭐ RETURNS ⭐

  • on success, you get GNUTLS_E_SUCCESS (0) back. we love a zero. 🎉
  • otherwise it's a negative error value, as per usual.
  • and if the indexes are out of bounds? you get GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE returned. so if you're out here asking for a cert that doesn't exist... that's the answer bestie 💀

🌈 SINCE 🌈

3.2.5 — an elder, honestly. been here since 3.2.5 and still serving. periodt.

🫶 REPORTING BUGS 🫶

found a bug? don't suffer in silence, 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.

🧚 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 babes 💖 this was gnutls 3.8.13 hitting you with gnutls_certificate_get_crt_raw(3), straight from the gnutls manual. go forth and grab those raw certs responsibly, ily, bye 🦋🌸✨

📦 where this page comes from