scx_bpf_sub_dispatch(9)

💅 scx_bpf_sub_dispatch(9) — from the Kernel API Manual, bestie ✨

okay so picture this: you're a parent scheduler and your kid scheduler needs to actually do something. that's this kfunc. welcome to the group chat 🫶

---

✨ NAME ✨

scx_bpf_sub_dispatch — ngl it's literally the thing that triggers dispatching on a child scheduler 💖

---

🎀 SYNOPSIS 🎀

__bpf_kfunc bool scx_bpf_sub_dispatch (u64 cgroup_id , const struct
bpf_prog_aux *aux );

that's it. that's the whole vibe check. 👑

---

🌸 ARGUMENTS 🌸

• cgroup_id — the cgroup ID of the child scheduler you want to dispatch. yes, that cgroup ID. 🎯
• aux — the implicit BPF argument used to access bpf_prog_aux, and it's hidden from BPF progs. so like… it's there, but you don't get to see it. main character energy that stays backstage 🙈

---

🦋 DESCRIPTION 🦋

so here's the lore: this lets a parent scheduler trigger dispatching on one of its direct child schedulers. the child then runs its own dispatch operation, which moves tasks from dispatch queues over to the local runqueue. that's the whole plot, no cap. ✨

---

⭐ RETURN ⭐

it returns true on success 💖

and it returns false if:

• cgroup_id is invalid 😭
• it's not a direct child 😭
• the caller lacks dispatch permission 😭

fr fr, watch out for all three of those — you'll just get a false and no dispatch 😔

---

🌈 SEE ALSO 🌈

the whole friend group 👯‍♀️ — kernel file ./kernel/sched/ext/sub.c plus:

• scx_skip_subtree_pre(9)
• scx_next_descendant_pre(9)
• scx_rescue_charge(9)
• scx_rescue_end(9)
• scx_rescue_keep(9)
• scx_rescue_accrue(9)
• scx_rescue_admit(9)
• scx_rescue_try_admit(9)
• scx_rescue_check_overload(9)
• scx_rescue_timerfn(9)
• scx_resolve_local_dsq(9)
• queue_sync_ecaps(9)
• scx_process_sync_ecaps(9)
• scx_unbypass_replay_ecaps(9)
• scx_discard_stale_ecaps_syncs(9)
• scx_rehome_task(9)
• scx_punt_task(9)
• scx_cgroup_claim_subtree(9)
• scx_cgroup_return_subtree(9)
• scx_cgroup_task_migrating(9)
• scx_cgroup_task_migrated(9)
• scx_cgroup_task_migrate_canceled(9)
• scx_bpf_sub_grant(9)
• scx_bpf_sub_revoke(9)
• scx_bpf_sub_caps(9)
• scx_bpf_sub_kill_bstr(9)

---

and that's the page!! 🧚 source path is ./kernel/sched/ext, dated October 2026, and it's scx_bpf_sub_dispatch(9) all the way down. mwah 💋 slay, go dispatch something 🔥