vb2_create_framevec(9)

💅 vb2_create_framevec(9)

okay bestie, welcome to the Kernel API Manual page for vb2_create_framevec(9) — the function whose whole job is to map virtual addresses to pfns. we love a memory-mapping moment. ✨

🎀 NAME 🎀

vb2_create_framevec — map virtual addresses to pfns. periodt.

✨ SYNOPSIS ✨

struct frame_vector * vb2_create_framevec (unsigned long start ,
       unsigned long length , bool write );

🌸 ARGUMENTS 🌸

• start — the virtual user address where we start mapping. that's our starting point, bestie.
• length — the length of a range to map. how big the range is, basically.
• write — should we map for writing into the area? yes, this is the write-vibe bool.

🦋 DESCRIPTION 🦋

okay so the tea ☕: this function allocates and fills in a vector with pfns corresponding to the virtual address range passed in arguments. no cap.

if those pfns have corresponding pages, page references are also grabbed to pin pages in memory. that's the whole pinning situation, and it's lowkey important. 📌

the function returns a pointer to the vector on success and an error pointer in case of failure. so: success = pointer, failure = error pointer. got it? 🫶

bestie moment: the returned vector needs to be freed via vb2_destroy_pfnvec. like, don't leave it sitting there, that's not the vibe. 💅

💜 SEE ALSO 💜

• Kernel file ./drivers/media/common/videobuf2/videobuf2-memops.c
• vb2_destroy_framevec(9), vb2_common_vm_open(9), vb2_common_vm_close(9)

xoxo, your kernel bestie 💖 — this page is from source/version ./drivers/media/common/videobuf2, dated October 2026, title vb2_create_framevec(9). bye bestie! 👑