unplug_oldest_pwq(9)

📦 version 7.3.1, in nixpkgs unstable

💖 NAME 💖

okay bestie, welcome to unplug_oldest_pwq(9) from the Kernel API Manual — and yes, it's giving exactly one job: unplug the oldest pool_workqueue. That's the whole main-character moment ✨

✨ SYNOPSIS ✨

Here's the signature, bestie — keep the spacing exactly as it is:

void unplug_oldest_pwq (struct workqueue_struct *wq );

🎀 ARGUMENTS 🎀

  • wq — the workqueue_struct where its oldest pwq is to be unplugged 💅

🦋 DESCRIPTION 🦋

okay so real talk: this function should only be called for ordered workqueues where only the oldest pwq is unplugged. The others are plugged to suspend execution and keep proper work item ordering. It's giving very "wait your turn" energy:

          dfl_pwq --------------+     [P] - plugged
                                |
                                v
          pwqs -> A -> B [P] -> C [P] (newest)
                  |    |        |
                  1    3        5
                  |    |        |
                  2    4        6

When the oldest pwq is drained and removed, this function should be called to unplug the next oldest one to start its work item execution.

Note that pwq's are linked into wq->pwqs with the oldest first, so the first one in the list is the oldest. iykyk 👑

🌈 SEE ALSO 🌈

Kernel file ./kernel/workqueue.c is where the lore lives, and the whole SEE ALSO squad is:

k bye bestie — footer tea time: source/version is ./kernel, the date is October 2026, and the page is unplug_oldest_pwq(9). mwah 💋✨

📦 where this page comes from