gnutls_audit_push_context(3)

📦
version 3.8.13 · 2 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

💖 gnutls_audit_push_context(3) 💖

okay bestie so you found your way into the gnutls manual, and honestly? iconic. this one's a little function called gnutls_audit_push_context — a whole API function, no cap — and she's here to help you keep your audit context stack in order. let's get into it 🎀

✨ NAME ✨

gnutls_audit_push_context — it's an API function, that's literally her whole job title 💅

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

void gnutls_audit_push_context(long context);

like, that's the whole vibe. one include, one call, void return, we love a low-maintenance queen 👑

🦋 ARGUMENTS 🦋

  • long context — an opaque context. that's it, that's the tea. it's opaque, so don't go poking at its insides, bestie, just pass it along 🙈

💜 DESCRIPTION 💜

so what she actually does: she pushes a brand-new crypto-auditing context onto the thread-local context stack. think of it like putting a new little sticky note on top of a stack of sticky notes, except the stack is per-thread and the notes are audit contexts 🗒️✨

and here's the thing you CANNOT forget: this call must match up with the following gnutls_audit_pop_context() call. push, then pop. like a matching set. if you push and never pop you're gonna have a bad time, fr fr 😭

who is this for? it's useful for applications that define their own probe points for application level protocols 🌈 so if you're out here building your own protocol on top and you wanna hook it into the auditing situation, this is your girl 🫶

⭐ SINCE ⭐

3.8.11 — she's been around since 3.8.11, so she's not new-new but she's not ancient either. a solid era 💖

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, 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.

yep, that's the legal bit, verbatim, no edits, we respect the paperwork 💅

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

that's your homework, bestie, go read it 📚✨

and that's the whole page, mwah 💋 this lil slice of the docs is from gnutls 3.8.13 — shoutout to the gnutls crew, thanks for the manpage, you ate 🍓🧚💜

📦 where this page comes from