pvr_page_ta...et_or_insert(9)

📦 version 7.3.1, in nixpkgs unstable

okay so bestie, welcome to the Kernel API Manual page for pvr_page_table_l1_get_or_insert(9) 💖 — the header is out here literally saying pvr_page_ta...et_or_insert(9) (truncated icon behavior, honestly), but the actual function is the level 1 page table get-or-insert situation. it lives in the PowerVR MMU corner of the kernel and it is lowkey doing exactly what the name says 🎀

✨ NAME ✨

pvr_page_table_l1_get_or_insert — retrieves a level 1 page table from the specified level 2 page table entry, and optionally inserts one if that's necessary. that's the whole vibe 💅

🦋 SYNOPSIS 🦋

int pvr_page_table_l1_get_or_insert (struct pvr_mmu_op_context *op_ctx ,
       bool should_insert );

💅 ARGUMENTS 💅

  • op_ctx — the target MMU op context, aka the main character of this call 🫶
  • should_insert — [IN]; specifies whether new page tables should be inserted when empty page table entries are encountered during traversal. yes bestie, it's the "do we build it or not" switch ✨

🎀 RETURN 🎀

  • 0 on success, or
okay the "or" is doing a lot of heavy lifting here — the conditional return lore is right below in DESCRIPTION, bestie 😭

🌸 DESCRIPTION 🌸

If should_insert is false:

  • -ENXIO if a level 1 page table would have been inserted. so if it would have needed to insert one, you get -ENXIO instead. periodt 💀

If should_insert is true:

  • Any error encountered while inserting the level 1 page table. literally any error from that insert can come back out 🔥

🔥 SEE ALSO 🔥

Kernel file: ./drivers/gpu/drm/imagination/pvr_mmu.c

the whole extended universe of related pages, no skips, no cap:

mwah 💋 and for the cute sign-off: source/version is ./drivers/gpu/drm/imagination, the date is October 2026, and the footer also name-drops pvr_page_ta...et_or_insert(9). bye bestie, go read your page tables 🫶🌈

📦 where this page comes from