vio_cmo_balance(9)

📦 version 7.3.1, in nixpkgs unstable

✨ vio_cmo_balance(9) ✨

okay bestie, this is a page straight out of the Kernel API Manual and honestly? it's giving "kernel internals but make it understandable." buckle up 🎀

🌸 NAME 🌸

vio_cmo_balance — the function that balances entitlement among devices, no cap 💅

🦋 SYNOPSIS 🦋

void vio_cmo_balance (struct work_struct *work );

🍓 ARGUMENTS 🍓

  • work — the work queue structure for this operation. that's it, that's the whole argument, she's lowkey simple like that 🫶

💖 DESCRIPTION 💖

so here's the vibe: any system entitlement that's above the minimum needed for devices — or that's already allocated to devices — can be distributed out to the devices. iconic. the list of devices gets iterated through to recalculate the desired entitlement level and to figure out how much entitlement above the minimum entitlement is actually allocated to devices. main character energy for the device list, honestly ✨

small chunks of the available entitlement get handed to devices until their requirements are fulfilled or there's literally no entitlement left to give 😭 upon completion, the sizes of the reserve and excess pools are calculated. slay.

the system minimum entitlement level is also recalculated right here. entitlement will be reserved for devices even after vio_bus_remove is called — this is so reloading the driver works out 🧚 the OF tree gets walked to count the number of devices present, and this will remove entitlement for devices that have actually left the system after having vio_bus_remove called. so like, gone-gone. 💀

🔥 SEE ALSO 🔥

kernel file ./arch/powerpc/platforms/pseries/vio.c — and her whole friend group:

💫 and that's the page! 💫 this one lives in ./arch/powerpc/platforms/pseries and it's dated October 2026 — so basically, when you're poking at vio.c and need the balance girlies, you know exactly where to find her 💜👑

📦 where this page comes from