gnutls_x509_crt_set_key_usage(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_set_key_usage ✨

okay bestie, pull up a chair, because we're doing certificate extensions today and honestly? it's giving main character energy 💅

this one lives in the gnutls manual — yeah, that gnutls, the TLS library that's been carrying the internet on its back since forever 🫶

🌸 NAME 🌸

gnutls_x509_crt_set_key_usage — an API function, and no, it's not gonna explain itself, that's literally why we're here 💖

🎀 SYNOPSIS 🎀

#include <gnutls/x509.h>

int gnutls_x509_crt_set_key_usage(gnutls_x509_crt_t crt, unsigned int
usage);

like, that's the whole vibe. two arguments, one int coming back at you 🔥

🦋 ARGUMENTS 🦋

  • gnutls_x509_crt_t crt — a certificate of type gnutls_x509_crt_t. yes the type is literally named the same as the argument, that's just how gnutls rolls, we don't question it 🙈 this is the cert you're about to mess with.
  • unsigned int usage — an ORed sequence of the GNUTLS_KEY_* elements. so you're not passing one single thing, you're passing a lil bundle — bitwise-OR them together and hand the whole stack over. it's giving ✨combination platter✨

💖 DESCRIPTION 💖

This function will set the keyUsage certificate extension.

that's it. that's the whole job. you hand it a cert, you hand it a usage (or several ORed together), and it stamps that keyUsage extension right onto the certificate. iconic. no cap 👑

🌈 RETURNS 🌈

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.

so like — 0 means slay, anything negative means something went sideways and you should go read the error code, fr fr. don't ignore a negative return, that's the universe telling you something 😭

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence bestie, tell the people:

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.

(translation: go forth and share, just keep the receipts 🧾💜)

👀 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/

lowkey if the local docs aren't there, the website always has you. no gatekeeping in this house 🫶

and that's the page, bestie!! written by the gnutls girlies, version 3.8.13, under the gnutls manual — gnutls_x509_crt_set_key_usage(3), periodt 💅✨🌸

📦 where this page comes from