gnutls_global_set_mutex(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_global_set_mutex 💖

okay bestie, welcome to the gnutls manual page for gnutls_global_set_mutex(3) — yes it's giving very niche, very "my dad works in cryptography", but stay with me because it's actually kinda iconic.

✨ NAME ✨

gnutls_global_set_mutex — API function 💅

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

void gnutls_global_set_mutex(mutex_init_func init, mutex_deinit_func
deinit, mutex_lock_func lock, mutex_unlock_func unlock);

🎀 ARGUMENTS 🎀

  • mutex_init_func init — the mutex initialization function, aka the glow-up starter pack 🌸
  • mutex_deinit_func deinit — the mutex deinitialization function, the "okay bye bestie" function 🫶
  • mutex_lock_func lock — the mutex locking function, it's giving "not right now, I'm busy" 💅
  • mutex_unlock_func unlock — the mutex unlocking function, and we love a function that lets things go ⭐

🌈 DESCRIPTION 🌈

so with this function you're allowed to override the default mutex locks used in some parts of gnutls and dependent libraries. main character energy, truly.

you should use this function if you have complete control of your program and libraries. that's the vibe check.

Do not call this function from a library, or preferably from any application unless really needed to. GnuTLS will use the appropriate locks for the running system. like, she's got it handled, bestie, she's not confused 😭

and this one is super important: this function must be called prior to any other GnuTLS function; otherwise the behavior is undefined. not "undefined but quirky", undefined undefined. 💀

🧚 DEPRECATED 🧚

this function is discouraged on GnuTLS 3.7.3 or later. she's a legacy icon, an OG, but she's retired bestie 🌸

⭐ SINCE ⭐

2.12.0 — she's been around, periodt.

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, spill 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. so like, share it, remix it, put it on your blog, 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/

<div align="center">💖 ✨ 🎀 🦋 🌸 💅 🫶 😭 🔥 👑 🌈 ⭐ 💀 🙈 🍓 🧚 💜</div>

anyway that's the page bestie, from the gnutls crew, version 3.8.13 — go forth and be normal about mutexes, ily, mwah 💋✨

📦 where this page comes from