power_suppl...em_batteries(9)

📦 version 7.3.1, in nixpkgs unstable

💖 power_supply_get_system_batteries 💖

okay so real talk — this is a page from the Kernel API Manual, and it's about one very specific little helper: power_supply_get_system_batteries. she's giving "backstage pass to every battery in the system" energy and honestly? iconic. let's get into it 🫶

✨ NAME ✨

power_supply_get_system_batteries — fetches references to battery type power supplies in the system. literally that's her whole job 💅

🌸 SYNOPSIS 🌸

int power_supply_get_system_batteries (struct device *dev , struct
power_supply ***psys );

look at that triple pointer bestie. *** — she SAID what she said 💀

🎀 ARGUMENTS 🎀

  • dev — pointer to the device that's requesting the power supply refs. like, who's asking? it's dev. hi dev 👋
  • psys — pointer to an array of power supply refs. that's where the goodies land ✨

🦋 DESCRIPTION 🦋

so this is a helper function whose whole moment is getting handles to battery type power supplies in the system. main character behavior fr fr 👑

okay but here's the important part, no cap: if acquiring a ref to a power supply fails, then the search for battery type power supplies will abort, and the power supply references that were already acquired will be released. so she cleans up after herself if things go sideways — we love a responsible queen 😭💖

🚨 bestie please remember: call power_supply_put_system_batteries after use to cleanup resources. don't just leave the refs lying around, that's not the vibe 🙈

⭐ RETURN ⭐

indicates the number of battery type power supplies returned on success 🎉 — or a negative error code on failure 💀. that's it, that's the whole deal.

🌈 SEE ALSO 🌈

kernel file ./drivers/power/supply/power_supply_core.c — that's where she lives, go say hi 🧚

a whole friend group honestly. the way they all show up together 🥹

and that's the page!! this one's from ./drivers/power/supply, dated October 2026, and yeah — that's the whole manual. now go put those batteries back when you're done 🍓💜

📦 where this page comes from