]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
sched_ext: Document task ownership state machine
authorAndrea Righi <arighi@nvidia.com>
Thu, 5 Mar 2026 06:29:00 +0000 (07:29 +0100)
committerTejun Heo <tj@kernel.org>
Thu, 5 Mar 2026 16:21:06 +0000 (06:21 -1000)
commit70f54f61a3d52af13b72248a63e98eddf4c990ac
treec12029d7afc8d64c7b164c69daef707cf94079d2
parent0927780c90ce551869fb692279d66387a4b66af5
sched_ext: Document task ownership state machine

The task ownership state machine in sched_ext is quite hard to follow
from the code alone. The interaction of ownership states, memory
ordering rules and cross-CPU "lock dancing" makes the overall model
subtle.

Extend the documentation next to scx_ops_state to provide a more
structured and self-contained description of the state transitions and
their synchronization rules.

The new reference should make the code easier to reason about and
maintain and can help future contributors understand the overall
task-ownership workflow.

Signed-off-by: Andrea Righi <arighi@nvidia.com>
Signed-off-by: Tejun Heo <tj@kernel.org>
kernel/sched/ext_internal.h