PROBE::SOCKET.READ(3stap)

💌 PROBE::SOCKET.READ 💌

okay bestie, welcome to the Socket Tapset section of the SystemTap manual — yes this is a 3stap page, and yes it's lowkey iconic. this one's about catching a socket right when it's receiving a message. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

probe::socket.read_iter — Receiving message via sock_read_iter

---

🌸 SYNOPSIS 🌸

probe socket.read_iter {}

that's it. that's the whole probe. no args, no drama, just vibes. 💅

---

🎀 VALUES 🎀

these are the local variables you get handed when the probe fires — the little gift bag of socket deets:

• type — the Socket type value 🦋
• name — Name of this probe (so like, its name name, the probe's own label)
• protocol — Protocol value 📡
• state — Socket state value (what's the socket's current mood, essentially)
• flags — Socket flags value 🚩
• size — Message size in bytes, fr fr
• family — Protocol family value 👑

---

👑 CONTEXT 👑

The message sender.

like… that's who's in the room when this fires. the sender. that's the context. 🫡

---

💖 DESCRIPTION 💖

Fires at the beginning of receiving a message on a socket via the sock_read_iter function.

so it's the very start of the receive, before anything's even really happened yet — you're catching it at the top of the sock_read_iter moment. main character entrance energy. ✨

---

🔥 SEE ALSO 🔥

• tapset::socket(3stap) — go read that one too, iykyk 💜

---

okay that's the whole page! mwah, slay, you now understand socket.read_iter. periodt. 💅🌸

this was brought to you by the SystemTap Tapset Reference, September 2026 (the footer just says "Ver" and nothing else bestie, i'm not gonna lie to you 😭), and it's page PROBE::SOCKET.READ(3stap) of the Socket Tapset. bye bestie, go probe responsibly 🎀🦋