v4l2_pipeline_pm_get(9)

💅 v4l2_pipeline_pm_get(9) — a Kernel API Manual moment 🎀

okay so bestie, welcome to the Kernel API Manual entry for v4l2_pipeline_pm_get, and listen… this one comes with a whole vibe warning label attached, so buckle up and let's get into it 💖

---

✨ NAME ✨

v4l2_pipeline_pm_get — literally just bumps up the use count of a pipeline, that's the whole personality 🫶

---

🌸 SYNOPSIS 🌸

int v4l2_pipeline_pm_get (struct media_entity *entity );

that's it. that's the signature. slay ✨

---

🦋 ARGUMENTS 🦋

• entity — the root entity of a pipeline 🎀 (yes, the root one, not just any random entity in the pile, iykyk)

---

🔥 DESCRIPTION 🔥

THIS FUNCTION IS DEPRECATED. DO NOT USE IN NEW DRIVERS. USE RUNTIME PM ON SUB-DEVICE DRIVERS INSTEAD. 🚨

like… no cap, this is a do not touch this in new code situation. the manpage is yelling in all caps for a reason bestie. if you're writing a new driver, you use runtime PM on sub-device drivers instead. periodt. 💀

so what does it even do? it updates the use count of all the entities in the pipeline and powers the entities on ⚡. one call, whole pipeline gets the glow-up.

this function is intended to be called in video node open 👀. it uses struct media_entity.use_count to track the power status — that struct member is the little bookkeeper keeping track of who's on and who's off 📓✨

and here's the pairing rule: the use of this function should be paired with v4l2_pipeline_link_notify 💫. they're a matched set, don't split them up, that would be giving messy.

it returns 0 on success or a negative error code on failure 🌈 (so like, check your return value, bestie, please 🙏)

---

👑 SEE ALSO 👑

• the Kernel file ./include/media/v4l2-mc.h 📁
• v4l2_mc_create_media_graph(9)
• v4l_enable_media_source(9)
• v4l_disable_media_source(9)
• v4l2_create_fwnode_links_to_pad(9)
• v4l2_create_fwnode_links(9)
• v4l2_pipeline_pm_put(9) 💜 (the other half of the get/put duo, obviously)
• v4l2_pipeline_link_notify(9)

---

aaaaand that's the whole page, bestie 🧚✨ this little gem lives in ./include/media, dated October 2026, and it's filed under v4l2_pipeline_pm_get(9) — go forth and please use runtime PM on sub-device drivers instead, ily, bye 💅💖