gnutls_srtp_get_mki(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_srtp_get_mki — the glow-up edition 💖

okay bestie, welcome to the gnutls manual, specifically the page for gnutls_srtp_get_mki — and yes, it's an API function, and yes, it's lowkey iconic 🎀

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int gnutls_srtp_get_mki(gnutls_session_t session, gnutls_datum_t * mki);

🌸 ARGUMENTS 🌸

  • gnutls_session_t session — bestie, this is a gnutls_session_t type. that's the whole vibe, that's what it is 💅
  • gnutls_datum_t * mki — this lil guy is gonna hold the MKI. it's the container, it's doing the carrying 🫶

🦋 DESCRIPTION 🦋

so what does this function actually do? it exports the negotiated Master Key Identifier — the one that was received by the peer, if any. like, if the peer sent one, you get it. if not... well, you know how that goes 🙈

⚠️ real talk though: the value returned in mki should be treated as constant and it's valid only during the session's lifetime. do NOT go storing that pointer somewhere cute and expecting it to still be alive later. it's giving "borrowed, not yours" energy. periodt 💀

👑 RETURNS 👑

on success? you get GNUTLS_E_SUCCESS (that's 0, the slay number ✨). otherwise you get a negative error code. no in-between, no gray area, we love a binary.

oh and fun fact: this has been around Since 3.1.4 — a true veteran, a legacy queen 👑

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, tell the devs:

they wanna hear from you fr fr 🌈

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: use it, share it, remix it, 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, go visit:

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

that's the plug, that's the link, iykyk 💜

and that's the whole page, bestie!! this one comes to you from gnutls 3.8.13, and it's filed under gnutls_srtp_get_mki(3) in the manual — mki stands for Master Key Identifier, and now you know 🎀✨ bye love u, go read your handshake state responsibly 🦋💅

📦 where this page comes from