gnutls_x509_ex...rt_key_purposes(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_ext_export_key_purposes 💖

okay bestie, welcome to the gnutls manual page for gnutls_x509_ext_export_key_purposes — yes that name is a whole mouthful, and yes the title bar up top is getting cut off as gnutls_x509_ex...rt_key_purposes(3) because even the terminal can't handle the full lewk. anyway. it's a real function, it's an API function, and it's lowkey iconic. let's get into it ✨

🎀 NAME 🎀

gnutls_x509_ext_export_key_purposes — it's an API function, periodt.

🌸 SYNOPSIS 🌸

#include <gnutls/x509-ext.h>

int gnutls_x509_ext_export_key_purposes(gnutls_x509_key_purposes_t p,
                                       gnutls_datum_t * ext);

like, that's the whole vibe right there 💅

🦋 ARGUMENTS 🦋

  • gnutls_x509_key_purposes_t p — this is the key purposes. the source material, the main character, the moment. 🫶
  • gnutls_datum_t * ext — this is the DER-encoded extension data that comes out the other side. and listen, bestie, you must free it using gnutls_free(). not free, not delete, gnutls_free(). iykyk. 🚨

✨ DESCRIPTION ✨

so what does this thing actually do? it takes your key purposes type and converts it into a DER-encoded PKIX ExtKeyUsageSyntax extension — that's OID 2.5.29.37 for the girlies taking notes 📝✨.

and the output data that lands in ext? it's allocated using gnutls_malloc(). so like, it's yours now, you own it, you're responsible for it. treat it with care 💖

🍓 RETURNS 🍓

On success, you get GNUTLS_E_SUCCESS (0) back — the good ending, the slay ending 🌈.

Otherwise? a negative error value. the not-so-slaying ending 😭 but hey, at least you know.

🧚 SINCE 🧚

3.3.0 — vintage. retro. a classic. it's been serving since way back 💜

🙈 REPORTING BUGS 🙈

found a bug? don't just suffer in silence, bestie. report it to <bugs@gnutls.org> 📧

Home page, for when you need the full lore: 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. like, go off, redistribute responsibly 🎀

🔥 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/
ngl if you skipped down here you missed stuff, go back up 🔙 but also. mwah. you did great.

and that's the whole page, bestie!! this was gnutls version 3.8.13, page gnutls_x509_ex...rt_key_purposes(3), and honestly? she ate. bye bye, stay DER-encoded, stay free'd properly, and don't forget gnutls_free() 💅💖✨🦋

📦 where this page comes from