handshake_req_next(9)

🌸 NAME 🌸

okay bestie, welcome to the handshake_req_next(9) page from the Kernel API Manual 💖 — this one is literally about returning the next queued handshake request ✨

handshake_req_next — return the next queued handshake request 🎀

---

✨ SYNOPSIS ✨

struct handshake_req * handshake_req_next (struct handshake_net *hn ,
int class );

---

🎀 ARGUMENTS 🎀

• hn — the per-net handshake state, no cap 💅
• class — the handler class to match 🦋

---

💅 DESCRIPTION 💅

okay so here’s the part you actually need to lock in, bestie: on a non-NULL return, the caller owns an extra reference on req->hr_file 👑. FD_PREPARE consumes that reference on success ✨. but on the FD_PREPARE failure path, the caller must fput it 😭 — like, do not leave that reference hanging, fr fr.

---

🦋 RETURN 🦋

a pointer to a removed handshake_req, or NULL 🌈

---

🔥 SEE ALSO 🔥

• kernel file: ./net/handshake/request.c 🧚
• handshake_req_alloc(9) ⭐
• handshake_req_private(9) 💜
• handshake_req_submit(9) 🍓
• handshake_req_cancel(9) 💀

---

okay that’s the whole page, bestie 🫶 — source/version ./net/handshake, dated October 2026, handshake_req_next(9) signing off 💖✨