GNUTLS_X509_EXT_IMPORT_TLSFEATURES(3)

πŸ’– gnutls_x509_ext_import_tlsfeatures(3) β€” the gnutls manual, but make it cute πŸŽ€

okay so bestie, we're in the gnutls manual and this page is about pulling TLS Features out of a DER-encoded extension. it's giving ✨certificate archaeology✨ and honestly? iconic. let's get into it πŸ’…


🌸 NAME 🌸

gnutls_x509_ext_import_tlsfeatures β€” literally just an API function, no cap 🫢


✨ SYNOPSIS ✨

#include <gnutls/x509-ext.h>

int gnutls_x509_ext_import_tlsfeatures(const gnutls_datum_t * ext,
gnutls_x509_tlsfeatures_t f, unsigned int flags);

πŸ¦‹ ARGUMENTS πŸ¦‹

  • const gnutls_datum_t * ext β€” the DER-encoded extension data. this is the raw material, the main character of the input πŸ’–
  • gnutls_x509_tlsfeatures_t f β€” the features structure. this is where the good stuff lands πŸŽ€
  • unsigned int flags β€” either zero, or GNUTLS_EXT_FLAG_APPEND. pick your fighter ⭐

πŸ‘‘ DESCRIPTION πŸ‘‘

so this function exports the features sitting inside the DER-encoded TLS Features PKIX extension you handed it, and drops them into a gnutls_x509_tlsfeatures_t type. easy. obsessed. πŸ”₯

⚠️ bestie, listen: f must be initialized. like, actually. do not skip this step, i'm begging πŸ™ˆ

now the tea about flags β˜• β€” when flags is set to GNUTLS_EXT_FLAG_APPEND:

  • if the features structure is empty, this function behaves identically to how it would if the flag wasn't set at all. same energy, no difference πŸ’…
  • but if there are elements in the features structure, then they get merged with the new ones. glow-up via combination ✨

🌈 RETURNS 🌈

on success? GNUTLS_E_SUCCESS (0) comes back, slay πŸ’– otherwise you get a negative error value, which is the universe telling you something went sideways 😭


🧚 SINCE 🧚

3.5.1 β€” vintage, but still serving looks πŸ‘‘


πŸ“ REPORTING BUGS πŸ“

found a bug? do NOT suffer in silence, bestie. report it:


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 off, 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/

and that's the whole page, bestie β€” every flag, every arg, every caveat, all of it. no skips, no shortcuts, periodt πŸ’…

this has been the gnutls manual, version 3.8.13, page gnutls_x509_ext_import_tlsfeatures(3) β€” thanks for reading, mwah πŸ«Άβœ¨πŸŽ€

πŸ“¦ where this page comes from