finish_wait(9)

✨ finish_wait(9) ✨

okay so this is a page from the Kernel API Manual, and bestie, it's a short one but it's lowkey important — it's the "okay we're done here, pack it up" function for waitqueues 💅

---

🌸 NAME 🌸

finish_wait — clean up after waiting in a queue

like, you waited, you got woken up, now tidy your mess 🧹✨

---

🎀 SYNOPSIS 🎀

void finish_wait (struct wait_queue_head *wq_head , struct
       wait_queue_entry *wq_entry );

it returns void, so no surprises, no return value to check, she just does her thing and leaves 🫶

---

🦋 ARGUMENTS 🦋

• wq_head — the waitqueue you were waited on. the queue itself, the main character 👑
• wq_entry — your wait descriptor, aka your little ticket that says "hi yes I was in this queue" 🎟️

---

💖 DESCRIPTION 💖

so here's the tea ☕: finish_wait does two things and it does them with zero drama.

1. It sets the current thread back to running state — you're up, you're awake, you're that girl now ⭐
2. It removes the wait descriptor from the given waitqueue if it's still queued — like, if you're still sitting in the queue, it takes you out. if you already got pulled out, no biggie, it handles that too 🙈

that's literally it. no cap. it's the cleanup crew for wait_event-style waiting, and it's not here to be flashy, it's here to make sure nothing's left hanging 🔥

---

🌈 SEE ALSO 🌈

• Kernel file ./kernel/sched/wait.c
• __wake_up(9)
• __wake_up_sync_key(9)
• __wake_up_locked_sync_key(9)

go read those if you wanna see who does the waking while finish_wait does the cleaning 💜

---

fr fr bestie: this pairs with the wakeup functions up there. you queue up, someone wakes you, and then finish_wait is your graceful exit. iconic behaviour, no notes 🧚

---

and that's the whole page!! source lives over in ./kernel/sched, dated October 2026 — mwah, go write some kernel code, you're gonna slay 💅🎀💖