gnutls_session_etm_status(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_session_etm_status ✨

okay bestie, welcome to the gnutls manual, section 3 💅 this one's short and sweet and honestly kinda iconic — it's the lil function that tells you whether your session managed to negotiate encrypt-then-mac. let's get into it 🫶

🌸 NAME 🌸

gnutls_session_etm_status — API function 💖

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

unsigned gnutls_session_etm_status(gnutls_session_t session);

like, that's the whole vibe. one include, one call, no drama ✨

🦋 ARGUMENTS 🦋

  • gnutls_session_t session — bestie this is literally just a gnutls_session_t type. that's it. that's the argument. hand it your session and let it cook 🔥

💜 DESCRIPTION 💜

so what does it actually do? it gets you the status of the encrypt-then-mac extension negotiation 👑

and no, we're not making this up — this is all in accordance to rfc7366 ⭐ like, the real spec, the receipts are there, no cap.

🌈 RETURNS 🌈

  • Non-zero if the negotiation was successful ✅
  • zero otherwise 💀

that's the whole test, bestie. truthy = we ate. falsy = we did not eat. periodt.

🚨 reminder: it's non-zero for success, not specifically 1. don't go comparing it to 1 like a rookie, okay? just check truthy/falsy and you're golden 💅

🙈 REPORTING BUGS 🙈

found something cursed? don't suffer in silence, tell the devs 🫶

Copyright © 2001-2023 Free Software Foundation, Inc., and others. 💖

and the legal tea: 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. so like, go off, just keep the receipts 🧾✨

🍓 SEE ALSO 🍓

the full documentation for gnutls is maintained as a Texinfo manual 📚 and if the /usr/share/doc/gnutls/ directory does not contain the HTML form, bestie, just visit:

https://www.gnutls.org/manual/

iykyk 💅

and that's a wrap on this lil page, mwah 😘 it's from gnutls version 3.8.13, and yes, that footer name up there is the same gnutls_session_etm_status you just read about — full circle, main character energy, no notes 🌸💖✨🫶

📦 where this page comes from