PROBE::SOCKET.READ(3stap)

💖 probe::socket.read_iter.return — Socket Tapset, bestie edition 💖

okay so. hi. you're in the Socket Tapset section of the SystemTap manual (3stap), and this page is literally all about one lil probe: probe::socket.read_iter.return. it's giving "the moment the message lands." let's go 🫶

---

✨ NAME ✨

probe::socket.read_iter.return — the conclusion of a message received via sock_read_iter. that's the whole vibe. no cap.

---

🌸 SYNOPSIS 🌸

probe socket.read_iter.return {}

that's it. that's the probe. she's simple, she's iconic 💅

---

🎀 VALUES 🎀

these are all the lil variables you get to peek at inside the probe. read them like a group chat:

• success — was the receive actually successful? 1 = yes bestie, 0 = no 😭
• family — the protocol family value
• flags — the socket flags value
• size — size of the message received, in bytes — OR the error code if success = 0 (yeah, she's doing double duty, she contains multitudes)
• state — the socket state value
• protocol — the protocol value
• name — the name of this probe
• type — the socket type value

---

🦋 CONTEXT 🦋

the message receiver. that's who's on stage. main character energy only 🌟

---

⭐ DESCRIPTION ⭐

this probe fires at the conclusion of receiving a message on a socket, via the sock_read_iter function. like, the message has arrived, the read is done, and this probe is there to catch the aftermath. obsessed 🧚

---

💜 SEE ALSO 💜

• tapset::socket(3stap)

---

and that's the page!! 💖 written up in the SystemTap Tapset Reference, Ver, September 2026 — mwah, go forth and trace some sockets, bestie 🎀✨🦋