pvr_context_lookup_id(9)

💅 pvr_context_lookup_id(9) — from the Kernel API Manual, bestie

okay so real talk, this is one of those tiny kernel helpers that's literally the glue holding your reference counting together, and the doc is like four lines long, so we're gonna make it iconic. ✨ it lives under pvr_context_lookup_id in section 9 of the kernel API manual, iykyk.

🌸 NAME 🌸

pvr_context_lookup_id — lookup context pointer from ID. that's it. that's the whole job. she finds the pointer, she takes a reference, she slays. 💅

🦋 SYNOPSIS 🦋

struct pvr_context * pvr_context_lookup_id (struct pvr_device *pvr_dev ,
u32 id );

🎀 ARGUMENTS 🎀

• pvr_dev — device pointer. the whole device. your main character struct. 👑
• id — FW context ID. that's the firmware context ID you're hunting for, bestie.

💖 DESCRIPTION 💖

so what she does is: takes a reference on the context. that's the whole vibe. 🔥

⚠️ heads up though — because she grabs a reference, you have to call pvr_context_put to release it. no ghosting your references, fr fr. if you forget, that's a leak and we do NOT stan leaks. 😭

⭐ RETURN ⭐

• the requested context on success, or 🫶
• NULL on failure (means the context does not exist — she looked, it wasn't there, don't take it personally) 💀

🌈 SEE ALSO 🌈

• kernel file ./drivers/gpu/drm/imagination/pvr_context.h
• struct pvr_context(9)
• pvr_context_get(9)
• pvr_context_get_if_referenced(9)
• pvr_context_lookup(9)

okay that's the whole page, you ate that. 💜 this one's straight from ./drivers/gpu/drm/imagination, dated October 2026, and honestly? she's small but she's doing the most for the reference counting. periodt. 🧚‍♀️🌸