gnutls_record_recv_early_data(3)

✨ gnutls_record_recv_early_data ✨

okay bestie, welcome to the gnutls manual, page gnutls_record_recv_early_data(3) 💖 this one is lowkey iconic — it's literally the API function that lets a server grab data that showed up early, before the handshake even finished. main character energy fr fr 🌸

---

🌈 NAME 🌈

gnutls_record_recv_early_data — it's an API function, no cap 🫶

---

💅 SYNOPSIS 💅

#include <gnutls/gnutls.h>

ssize_t gnutls_record_recv_early_data(gnutls_session_t session, void *
data, size_t data_size);

that's the whole vibe right there ✨

---

🎀 ARGUMENTS 🎀

• gnutls_session_t session — bestie this is literally a gnutls_session_t type. that's the tea ☕
• void * data — the buffer that the data is gonna get read into 🧺
• size_t data_size — the number of requested bytes, aka how much room you're giving it 💜

---

🦋 DESCRIPTION 🦋

so the way that this works: this function can be used by a server to retrieve data sent early in the handshake process when resuming a session 👑 it's the whole point of implementing a zero-roundtrip (0-RTT) mode. it has the same semantics as gnutls_record_recv(), periodt 💅

and the flex? you can call this function either in a handshake hook, or after the handshake is complete. either one. we love options 🍓

---

⭐ RETURNS ⭐

here's what you get back:

• the number of bytes received, and zero when early data reading is complete ✅
• a negative error code if something went wrong 😭
• if no early data is received during the handshake, this function returns GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE 🙈

heads up bestie: the number of bytes received might be less than the requested data_size. don't come for me, that's just how it is 💀

---

🌸 SINCE 🌸

3.6.5 — she's been around a minute, an OG 🎀

---

💀 REPORTING BUGS 💀

found a bug? not the vibe, but okay, report it to <bugs@gnutls.org> 📧

home page: https://www.gnutls.org 🏠

---

👑 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, go off, 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/

---

and that's the whole page bestie, you ate that 💅✨ this was the gnutls manual, page gnutls_record_recv_early_data(3), and the footer tells us it's gnutls version 3.8.13 🫶 go forth and 0-RTT responsibly 🌈