gnutls_fips140_pop_context(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_fips140_pop_context(3) — the gnutls manual, but make it cute

okay bestie, so you know how this whole thing lives in the gnutls manual? yeah. this page is gnutls_fips140_pop_context and she is literally an API function. no cap. 🎀

✨ NAME ✨

gnutls_fips140_pop_context — it's an API function, that's the whole vibe 🦋

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

int gnutls_fips140_pop_context( void);

🧚 ARGUMENTS 🧚

  • void — yeah bestie, she takes nothing. empty hands, full heart. 💖

👑 DESCRIPTION 👑

okay so here's the tea. This function dissociates the FIPS context that's currently active on the current thread, and reverts you back to the context that was active before. Like, popping the top of the stack, but for vibes. ✨

but WAIT. if a cryptographic operation is ongoing in the current thread — like, say, gnutls_aead_cipher_init() got called but gnutls_aead_cipher_deinit() has NOT been called yet — she will NOT let you. nope. she returns an error, GNUTLS_E_INVALID_REQUEST. it's giving "finish your plate first" energy 😭

and lowkey the biggest slay: this function is a no-op if FIPS140 is not compiled in nor enabled at run-time. so if FIPS isn't even in the building, she just shrugs and does nothing. iconic, honestly. 💅

⭐ RETURNS ⭐

  • 0 upon success — we love a clean win 🫶
  • a negative error code otherwise — sad girl hours 🙈

🌈 SINCE 🌈

3.7.3 — she's been around since 3.7.3, respect your elders bestie 💜

💀 REPORTING BUGS 💀

found a bug? spill it to bugs@gnutls.org. 📧

Home page, if you wanna lurk: 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. (fr fr, that's the whole rule. keep the receipt.) 🧾

🔥 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, go visit:

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

iykyk 👑

gnutls version 3.8.13, dated with the gnutls_fips140_pop_context(3) footer energy — that's the page, bestie. go forth and pop those contexts responsibly. mwah. 💋🦋🌸

📦 where this page comes from