gnutls_handsha...e_receiving_key(3)

✨ gnutls_handshake_update_receiving_key(3) ✨

okay bestie, so this one lives in the gnutls manual section, and it's literally an API function 💅 no cap.

---

🌸 NAME 🌸

gnutls_handshake_update_receiving_key — it's an API function, periodt.

---

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

int gnutls_handshake_update_receiving_key(gnutls_session_t session);

---

🎀 ARGUMENTS 🎀

• gnutls_session_t session — bestie this is a gnutls_session_t type. that's the vibe. it's the session. it's the whole main character of this function fr fr.

---

👑 DESCRIPTION 👑

so the way that this works is: this function will update/refresh the session receiving keys when the TLS protocol is 1.3 or better. slay ✨

but listen, and this is the important part: unlike gnutls_session_key_update(), this function does NOT notify the peer. it will only update the local keys. so it's giving sneaky little private glow-up, not a whole announcement to the group chat 🙈

and if the negotiated version is not TLS 1.3 or better? this function will return GNUTLS_E_INVALID_REQUEST. like, it's not mad, it's just not doing it. no negotiation. no keys. just that error code 💀

---

⭐ RETURNS ⭐

GNUTLS_E_SUCCESS on success 🎉 otherwise a negative error code (crying, screaming, throwing up 😭).

---

🌈 SINCE 🌈

3.8.11 — she's been around since 3.8.11, iykyk 🫶

---

🐛 REPORTING BUGS 🐛

found a bug? spill it to <bugs@gnutls.org>. they wanna know fr fr.

home page: https://www.gnutls.org — iconic, go look.

---

💖 COPYRIGHT 💖

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, take it, share it, just keep the receipts bestie 🫶✨

---

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

go read it, it's giving educated queen behavior 👑

---

and that's the whole page, bestie!! this was gnutls manual, version 3.8.13, all about gnutls_handshake_update_receiving_key(3) — local keys only, no peer notification, TLS 1.3 or better, mwah 💋