optee_fill_pages_list(9)

💅 optee_fill_pages_list(9) — Kernel API Manual ✨

okay so bestie, welcome to the glow-up of <pink>optee_fill_pages_list</pink>, a kernel API manual page from the OP-TEE corner of the tree 🧚‍♀️ — this one's all about writing a list of user pages into a shared buffer. no cap, it's a small function but it's iconic 💖

---

✨ NAME ✨

optee_fill_pages_list — write list of user pages to given shared buffer.

like, that's literally the whole job 🫶

---

🌸 SYNOPSIS 🌸

void optee_fill_pages_list (u64 *dst , struct page **pages , int
num_pages , size_t page_offset );

yep, that's the signature, copied exactly so you don't have to squint at the original 😌

---

🎀 ARGUMENTS 🎀

• dst — the page-aligned buffer where the list of pages is gonna be stored. this is the destination bestie, the place the gossip gets written down 💅
• pages — the array of pages that represents the shared buffer. it's giving "the actual content" energy
• num_pages — how many entries live in pages. count 'em, don't guess 🔢
• page_offset — the offset of the user buffer from the page start. lowkey important for lining things up right ✨

---

🦋 DESCRIPTION 🦋

so here's the vibe check: dst should be big enough to hold the list of user page addresses and the links to the next pages of the buffer. that's it, that's the requirement — if your buffer is too smol, that's on you, bestie 😭 make it big enough 📏

---

👑 SEE ALSO 👑

the whole friend group, fr fr 🫶 — all of these live in the kernel file ./drivers/tee/optee/smc_abi.c:

• optee_from_msg_param(9)
• optee_to_msg_param(9)
• optee_enable_shm_cache(9)
• __optee_disable_shm_cache(9)
• optee_disable_shm_cache(9)
• optee_disable_unmapped_shm_cache(9)
• optee_shm_pool_alloc_pages(9)
• optee_handle_rpc(9)
• optee_smc_do_call_with_arg(9)

go read them, they ate 🔥

---

and that's the page, bestie! 🎀 this little gem comes to you from ./drivers/tee/optee, dated October 2026 — mwah, stan the kernel docs, periodt 💜🌸