STRUCT TOPA_PAGE(9)

💖 NAME 💖

okay so bestie, we're looking at struct topa_page(9) from the Kernel API Manual, and it's literally a page-sized ToPA table with metadata at the top. no cap, that's the whole serve. ✨

✨ SYNOPSIS ✨

struct topa_page {
           struct topa_entry       table[TENTS_PER_PAGE];
           struct topa             topa;
        };

🎀 Members 🎀

• table — the actual ToPA table entries, exactly as PT hardware understands them. she's the main character of the page 💅
• topa — the metadata. lowkey essential, highkey iconic 🎀

🌈 SEE ALSO 🌈

Kernel file: ./arch/x86/events/intel/pt.c — and the whole friend group is:

• struct topa(9)
• topa_alloc(9)
• topa_free(9)
• topa_insert_table(9)
• topa_table_full(9)
• topa_insert_pages(9)
• pt_topa_dump(9)
• pt_buffer_advance(9)
• pt_update_head(9)
• pt_buffer_region(9)
• pt_buffer_region_size(9)
• pt_handle_status(9)
• pt_read_offset(9)
• pt_buffer_reset_markers(9)
• pt_buffer_reset_offsets(9)
• pt_buffer_fini_topa(9)
• pt_buffer_init_topa(9)
• pt_buffer_setup_aux(9)
• pt_buffer_free_aux(9)
• intel_pt_interrupt(9)

that's the struct topa_page(9) tea: source/version ./arch/x86/events/intel, dated October 2026. byeee bestie, go read some ToPA tables 💖🫶