gnutls_x509_crt_get_policy(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_crt_get_policy(3) ✨

okay bestie, so this is a page from the gnutls manual — like, the official docs for the gnutls library — and it's all about pulling a certificate policy out of an X.509 cert. it's giving very "let me peek inside this certificate real quick" energy 💅

🌸 NAME 🌸

gnutls_x509_crt_get_policy — API function

🎀 SYNOPSIS 🎀

#include <gnutls/x509.h>

int gnutls_x509_crt_get_policy(gnutls_x509_crt_t crt, unsigned indx,
struct gnutls_x509_policy_st * policy, unsigned int * critical);

💖 ARGUMENTS 💖

  • gnutls_x509_crt_t crt — should contain a gnutls_x509_crt_t type. yes literally, that's the vibe, it's the certificate you're interrogating 🕵️♀️
  • unsigned indx — this specifies which policy to return. use (0) to get the first one. so like, index 0 is your main character, and everything after is the supporting cast ✨
  • struct gnutls_x509_policy_st * policy — a pointer to a policy structure. this is where the tea gets poured ☕
  • unsigned int * critical — will be non-zero if the extension is marked as critical. so if this comes back non-zero, bestie, the cert is being serious about it 🚨

🦋 DESCRIPTION 🦋

this function will extract the certificate policy (extension 2.5.29.32) specified by the given index. slay, we love a targeted extraction 💖

the policy returned by this function must be deinitialized by using gnutls_x509_policy_release(). not me stressing this — it's literally in the docs. clean up after yourself, periodt 🧹

🌈 RETURNS 🌈

  • on success, GNUTLS_E_SUCCESS (0) is returned 👑
  • GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if the extension is not present (so like, the policy said "i'm not coming to the function today" 😭)
  • otherwise a negative error value 💀

⭐ SINCE ⭐

3.1.5 — old money, iconic, been here since forever 🎀

🫶 REPORTING BUGS 🫶

found a bug? 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. no cap, you can share this fr fr 💅

🧚 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 came straight out of the gnutls manual, version 3.8.13, for gnutls_x509_crt_get_policy(3) — go forth and extract those policies, you've got this 🦋✨💖

📦 where this page comes from