scx_cmask_ref_init_kern(9)

📦 version 7.3.1, in nixpkgs unstable

💅 scx_cmask_ref_init_kern — bestie, let's bind that ref

okay so real talk, this one's from the Kernel API Manual (section 9, kernel developer land, very ✨serious business✨ but we're gonna get through it together).

🎀 NAME 🎀

scx_cmask_ref_init_kern — bind a scx_cmask_ref to a kernel-owned cmask. that's it, that's the whole vibe: you got a ref, you got a cmask, we're introducing them. 🫶

✨ SYNOPSIS ✨

void scx_cmask_ref_init_kern (struct scx_sched *sch , struct scx_cmask
*m , u32 base , u32 nr_cids , struct scx_cmask_ref *ref );

like, look at her. five params, no return, zero notes. she's giving "void function, no drama." 💅

🌸 ARGUMENTS 🌸

  • sch — the scheduler that the cmask belongs to. her home base, her people, iykyk.
  • m — kernel address of the target cmask 👑 and important: the storage there is sized for nr_cids at base. like, the space has to already fit, bestie, don't come in undersized.
  • base — first cid of the active range. the starting line. 🏁
  • nr_cids — active range length. how many cids we're working with, fr fr.
  • ref — output ref. this is where the freshly-bound ref goes 💖

🦋 DESCRIPTION 🦋

so this is basically scx_cmask_ref_init's chill, more careful sibling. the difference? here the geometry is supplied by the caller, not read from m's header. and that matters because — not me being dramatic — a concurrent BPF write to the header literally could not steer later sizing or offsets in this version. 🛡️

you pass in the trusted geometry, it rewrites the header from that trusted geometry, and then it binds ref to it. periodt. clean, predictable, no sneaky header shenanigans. 💀✨

ngl the whole point here is trust: the numbers come from you, not from a header that something else might be poking at. that's the entire glow-up. 🌈

🔥 SEE ALSO 🔥

Kernel file ./kernel/sched/ext/cid.c — go read the source, bestie, it ate:

like... a whole friend group. go say hi. 🧚💜

okay that's the page!! this one lives under ./kernel/sched/ext in the Kernel API Manual, dated October 2026, and she's filed as scx_cmask_ref_init_kern(9). mwah, go bind some refs responsibly 🍓💖

📦 where this page comes from