kthread_queue_work(9)

📦 version 7.3.1, in nixpkgs unstable

💅 kthread_queue_work(9) — Kernel API Manual, but make it make sense

okay bestie, welcome to the kernel group chat. this page is literally about kthread_queue_work, and it’s giving “async execution but make it cute.” let’s get into it 💖

🌸 NAME

kthread_queue_work — queue a kthread_work

✨ SYNOPSIS

bool kthread_queue_work (struct kthread_worker *worker , struct
       kthread_work *work );

🎀 ARGUMENTS

  • worker — the target kthread_worker. this is the work processor’s main character, bestie.
  • work — the kthread_work you want to queue. yes, that one. put it in the queue, periodt.

💖 DESCRIPTION

so here’s the vibe: you’re queuing work to the work processor task for async execution. slay. but listen — that task must have been created with kthread_create_worker. no cap, that’s required.

it returns true if the work was successfully queued, and false if it was already pending. like, it’s already in the queue, bestie, we’re not doing doubles 💀

also: reinitialize the work if it needs to be used by another worker. for example, when the worker was stopped and started again. that’s the reset moment, okay? 🫶

lowkey important: false doesn’t mean “failed” in a scary way — it means it was already pending. keep that energy.

🦋 SEE ALSO

kernel file ./kernel/kthread.c, plus the whole kthread friend group:

that’s the whole page, bestie. go queue your work and hydrate 💅✨

kisses from your kernel bestie — source ./kernel, version/date October 2026 🎀🦋

📦 where this page comes from