retract_domain(9)

💅 retract_domain(9) — like, the kernel API manual bestie ✨

okay so real talk, this one lives in section 9 of the kernel API manual and it's called retract_domain, and it's literally about taking the control back from the MCU. main character energy fr fr 🎀

✨ NAME ✨

retract_domain — Retract control of a domain from MCU 👑

🌸 SYNOPSIS 🌸

int retract_domain (struct panthor_device *ptdev , u32 domain );

like, that's the whole signature, no notes, she ate 💅

🦋 ARGUMENTS 🦋

• ptdev — the Device. your fave struct, the whole device vibe check 🫶
• domain — the Domain to retract the control. yeah bestie, this one's coming back to us 🔥

💖 DESCRIPTION 💖

so the tea is: retracting the L2 domain is not expected, because it won't be delegated in the first place. like, you can't take back what was never handed out, yk? 🙈 so don't be surprised, that's just how it is 💀

⭐ RETURN ⭐

• 0 on success — or if it was retracted already, slay, either way we take the W ✨
• -EPERM if the domain is L2. no cap, it's a hard no 💅
• a negative error code otherwise, because sometimes life gives you lemons 🍓

🧚 SEE ALSO 🧚

• Kernel file ./drivers/gpu/drm/panthor/panthor_pwr.c
• struct panthor_pwr(9)
• delegate_domain(9)
• panthor_pwr_domain_force_off(9)

go read those too, iykyk 💜

okay that's the whole page bestie, ily, go touch some registers 🌈 and this adorable little drop shipped straight out of ./drivers/gpu/drm/panthor, dated October 2026, retract_domain(9) — periodt. 🎀💖🦋