pt_install_table(9)

💅 pt_install_table(9) — like, the kernel API manual edition, bestie 🎀

okay so real talk, we're deep in the kernel weeds today — this is pt_install_table, straight out of the Kernel API Manual, and yes it's exactly as iconic as it sounds. grab a lil snack 🍓 and let's get into it.

---

✨ NAME ✨

pt_install_table — literally just writes a table entry into the table. that's the whole vibe. 💫

---

🌸 SYNOPSIS 🌸

bool pt_install_table (struct pt_state *pts , pt_oaddr_t table_pa ,
const struct pt_write_attrs *attrs );

look at her. so clean. so composed. 🫶

---

🦋 ARGUMENTS 🦋

• pts — the table index you're changing. this is the main character right here 👑
• table_pa — the CPU physical address of the lower table's memory. it's giving "address of the downstairs neighbor" ngl
• attrs — the attributes you're using to modify that table index ✨

---

💜 DESCRIPTION 💜

so here's the tea ☕ — once you install this, a table entry will return PT_ENTRY_TABLE from pt_load_entry. no cap.

the table_pa is the table sitting at pts->level - 1. like, one level down, that's her. 📉

this whole thing gets done via cmpxchg, which means pts must have the current entry loaded first — don't skip that step bestie, it's not optional, fr fr. 🙈 and then pts gets updated with the installed entry, so she stays in sync. slay.

🚨 BIG WARNING ENERGY 🚨: you must not call this if pt_can_have_table == false. like, just don't. it's giving "read the room" energy. 💀

---

⭐ RETURN ⭐

returns true if the table was installed successfully. that's the good ending. 🌈

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/iommu/generic_pt/pt_common.h — go read her, she's iconic 📖
• pt_attr_from_entry(9)
• pt_can_have_leaf(9)
• pt_can_have_table(9)
• pt_clear_entries(9)
• pt_entry_make_write_dirty(9)
• pt_entry_make_write_clean(9)
• pt_entry_is_write_dirty(9)
• pt_dirty_supported(9)
• pt_entry_num_contig_lg2(9)
• pt_entry_oa(9)
• pt_entry_oa_lg2sz(9)
• pt_entry_oa_exact(9)
• pt_full_va_prefix(9)
• pt_has_system_page_size(9)
• pt_install_leaf_entry(9)
• pt_item_oa(9)
• pt_load_entry_raw(9)
• pt_max_oa_lg2(9)
• pt_num_items_lg2(9)
• pt_pgsz_lg2_to_level(9)
• pt_possible_sizes(9)
• pt_table_item_lg2sz(9)
• pt_table_oa_lg2sz(9)
• pt_table_pa(9)
• pt_table_ptr(9)
• pt_max_sw_bit(9)
• pt_test_sw_bit_acquire(9)
• pt_set_sw_bit_release(9)
• pt_load_entry(9)

that's the whole friend group right there, iykyk 💖

---

aaand that's the page!! this lil masterpiece lives in ./drivers/iommu/generic_pt and it's dated October 2026 — she's from the future, main character energy only 👑✨ bye bestie, go install some tables 🎀💅