scan_its_table(9)

✨ scan_its_table(9) ✨

okay so bestie, welcome to scan_its_table(9) from the Kernel API Manual — this is the girl who walks a contiguous table living in guest RAM and runs a function on every single entry. she's giving very much "personal assistant who goes down the list one by one" energy 💅

---

🌸 NAME 🌸

scan_its_table — scan a contiguous table in guest RAM and applies a function to each entry

---

🎀 SYNOPSIS 🎀

int scan_its_table (struct vgic_its *its , gpa_t base , int size , u32
esz , int start_id , entry_fn_t fn , void *opaque );

---

🦋 ARGUMENTS 🦋

literally every single one, no skips:

• its — the its handle, bestie. that's the whole context you're working with 🫶
• base — base gpa of the table, i.e. where it starts in guest physical address land ✨
• size — size of the table in bytes, the full vibe of how much ground we're covering
• esz — entry size in bytes — how thicc each individual entry is
• start_id — the ID of the first entry in the table (non zero for 2d level tables 👀 yes this matters)
• fn — function to apply on each entry. the main character of this whole operation tbh
• opaque — pointer to opaque data. we don't ask what's inside, we just pass it along 🙈

---

💜 RETURN 💜

here's the vibe check on what you get back:

• < 0 on error — something went wrong, sorry bestie 😭
• 0 if last element was identified — you found the end, slay 🎉
• 1 otherwise — but heads up: the last element may not be found on second level tables, so like… don't come for her if it isn't there fr fr

---

💖 SEE ALSO 💖

the whole friend group, obviously:

Kernel file ./arch/arm64/kvm/vgic/vgic-its.c, struct vgic_its_abi(9), vgic_its_invall(9), entry_fn_t(9), vgic_its_restore_ite(9), vgic_its_restore_itt(9), vgic_its_save_dte(9), vgic_its_restore_dte(9), handle_l1_dte(9)

---

ngl this one's short but she ate 💅 go read the SEE ALSO list, that's where the lore lives

okay bye ily, this page came from ./arch/arm64/kvm/vgic, October 2026 edition — iconic, no cap 🌈⭐👑