slim_ctrl_clk_pause(9)

💅 slim_ctrl_clk_pause — from the Kernel API Manual, section 9, bestie ✨

Okay so picture this: you're deep in the Kernel API Manual, section 9, and the function is literally called slim_ctrl_clk_pause. It's giving "the controller wants to take a lil nap" energy, and honestly? Same. 🎀

---

🌸 NAME 🌸

slim_ctrl_clk_pause — the function a slimbus controller calls to enter or exit 'clock pause'. No cap, that's the whole vibe. 💤

---

✨ SYNOPSIS ✨

int slim_ctrl_clk_pause (struct slim_controller *ctrl , bool wakeup , u8 restart );

---

🦋 ARGUMENTS 🦋

• ctrl — the controller that's asking the bus to be paused or woken up. Like, it's the main character making the request. 👑
• wakeup — wake this controller up from clock pause. Set it and the controller's all "rise and shine bestie". ⭐
• restart — the restart time value per spec, used for clock pause. Lowkey important: this value isn't used when the controller is being woken up. So if wakeup is true, restart is just sitting there like 🙈.

---

💖 DESCRIPTION 💖

So the Slimbus specification needs this sequence to turn off clocks for the bus — it's not optional, it's the whole assignment. The sequence involves sending 3 broadcast messages (that's the reconfiguration sequence, periodt) to inform all devices on the bus. Three. Not two, not four. Three. 💅

To exit clock-pause, the controller typically wakes up the active framer device. Iconic behavior, honestly.

Here's how the API breaks it down:

• If wakeup is false, this API executes the clock pause reconfiguration sequence. It's entering naptime mode. 😴
• If wakeup is true, the controller's wakeup is called. Rise and grind. 🔥
• For entering clock-pause, -EBUSY is returned if a message txn is pending. So like, if there's still a transaction hanging around, the function's gonna hit you with the "busy bestie, try again" and return -EBUSY. Not me getting rejected by a return code. 💀

Heads up: -EBUSY is a real one — if a message txn is pending, that's the exit status you're getting when you try to enter clock-pause. No exceptions, that's the spec.

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/slimbus/sched.c — go read it, iykyk.

---

Aaaand that's the tea! 🍓 This page is from the kernel's ./drivers/slimbus corner of the world, dated October 2026 — mark your calendars bestie, and go pause some clocks responsibly. 💜✨🫶