pvr_hwrt_dataset_lookup(9)

💅 pvr_hwrt_dataset_lookup(9) — like, the whole page, but make it make sense

okay so this is from the Kernel API Manual, and the star of the show is pvr_hwrt_dataset_lookup ✨ — yes that's a mouthful, we're gonna get through it together, bestie 🫶

---

🎀 NAME 🎀

pvr_hwrt_dataset_lookup — bestie, this literally just looks up an HWRT dataset pointer from a handle. that's the whole vibe check 👑

---

🌸 SYNOPSIS 🌸

struct pvr_hwrt_dataset * pvr_hwrt_dataset_lookup (struct pvr_file
*pvr_file , u32 handle );

like, you hand it a pvr_file and a handle, and it gives you back a struct pvr_hwrt_dataset *. iconic signature, no notes 💅

---

🦋 ARGUMENTS 🦋

• pvr_file — pointer to the pvr_file structure. yes. it's a pointer to the thing. we love her 💖
• handle — the object handle. it's a u32, it's the key you're looking up, periodt.

---

✨ DESCRIPTION ✨

so what actually happens? it takes a reference on the dataset object 🔥 — like it's holding onto it for you so it doesn't ghost you mid-use.

⚠️ important bestie: you gotta call pvr_hwrt_dataset_put to release that reference. don't just walk away with it, that's not the move 😭

---

💜 RETURN 💜

• The requested object on success 🌈 — slay, you got it
• NULL on failure 😭 — and why would it fail? (object does not exist in list, or is not a HWRT dataset). so if it's not in the list, or it's just not the right kind of dataset, you get the big NULL. ngl, rude, but fair 💀

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/gpu/drm/imagination/pvr_hwrt.h
• struct pvr_hwrt_data(9)
• struct pvr_hwrt_dataset(9)
• pvr_hwrt_data_lookup(9)
• pvr_hwrt_data_put(9)

iykyk, go read those too, they're all in the same little friend group 🍓

---

okay that's the page!! 🎀 this all lives over in ./drivers/gpu/drm/imagination, dated October 2026, and the whole thing is filed under pvr_hwrt_dataset_lookup(9) — mwah, go forth and reference-count responsibly 💖✨