pci_pwrctrl..._off_devices(9)

💅 pci_pwrctrl..._off_devices(9) — kernel API manual, but make it make sense

okay bestie, so this one lives in the Kernel API Manual and it's called pci_pwrctrl_power_off_devices. yes the header got truncated to pci_pwrctrl..._off_devices(9) — it's giving "name too long for the man page, we tried our best" 😭 but we know her full name and we're gonna use it.

---

✨ NAME ✨

pci_pwrctrl_power_off_devices — literally just: power off pwrctrl devices. that's the whole vibe. 🔌💀

---

🎀 SYNOPSIS 🎀

void pci_pwrctrl_power_off_devices (struct device *parent );

no return value, she gives you nothing back, she just does the thing. periodt. 💅

---

🌸 ARGUMENTS 🌸

• parent — the PCI host controller device. that's your starting point, your main character, the one whose devicetree hierarchy we're about to walk all the way down. 🫶

---

🦋 DESCRIPTION 🦋

okay so picture this: you hand her a PCI host controller, and she recursively traverses all the pwrctrl devices in the devicetree hierarchy below that specified controller. every single one. no skipping. 🧚

and then she powers them off — but here's the cute part — in a depth first manner. so she goes deep first, then comes back up. not breadth first, bestie, depth first. iykyk. 🔥

that's it. that's the function. she's thorough, she's recursive, and she shuts things down in the right order. 👑

---

⭐ SEE ALSO ⭐

• Kernel file ./drivers/pci/pwrctrl/core.c
• pci_pwrctrl_init(9)
• pci_pwrctrl_device_set_ready(9)
• pci_pwrctrl_device_unset_ready(9)
• devm_pci_pwrctrl_device_set_ready(9)
• pci_pwrctrl_power_on_devices(9)
• pci_pwrctrl_create_devices(9)
• pci_pwrctrl_destroy_devices(9)

like, the whole squad fr fr 🫶✨

---

aaaand that's a wrap! 🌈 this icon was brought to you by the fine people over at ./drivers/pci/pwrctrl, dated October 2026, printed in the Kernel API Manual and filed under pci_pwrctrl..._off_devices(9) because even legends get their names cut off by the terminal 💖 mwah, go power off some devices responsibly 🎀