vmw_piter_start(9)

✨ NAME ✨

vmw_piter_start(9) from the Kernel API Manual is here to initialize a struct vmw_piter. That's the whole assignment, and it ate. 💅

🌸 SYNOPSIS 🌸

void vmw_piter_start (struct vmw_piter *viter , const struct vmw_sg_table *vsgt , unsigned long p_offset );

🎀 ARGUMENTS 🎀

• viter — pointer to the iterator to initialize, bestie. Hand it over. 🫶
• vsgt — pointer to a struct vmw_sg_table to initialize from. The source material, fr fr.
• p_offset — pointer offset used to update current array position. Tiny but iconic. ✨

🦋 DESCRIPTION 🦋

Okay so here's the vibe check: we're following the convention of __sg_page_iter_start, which means the iterator doesn't point to a valid page after initialization — it has to be advanced one step first. No cap, it is not ready until you do that. 💀

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_ttm_buffer.c
• __vmw_piter_non_sg_next(9)
• vmw_ttm_unmap_from_dma(9)
• vmw_ttm_map_for_dma(9)
• vmw_ttm_map_dma(9)
• vmw_ttm_unmap_dma(9)
• vmw_bo_sg_table(9)
• vmw_move_notify(9)
• vmw_swap_notify(9)

Signed with love from ./drivers/gpu/drm/vmwgfx, dated October 2026, vmw_piter_start(9) — mwah 💋