STRUCT THREAD_STACK(9)

💅 struct thread_stack(9) — Kernel API Manual 💅

🌸 NAME 🌸

okay so bestie, this is the Kernel API Manual page for struct thread_stack — it's literally the thread stack constructed from 'call' and 'return' branch samples. no cap, that's the whole NAME vibe. ✨

🦋 SYNOPSIS 🦋

       struct thread_stack {
           struct thread_stack_entry *stack;
           size_t cnt;
           size_t sz;
           u64 trace_nr;
           u64 branch_count;
           u64 insn_count;
           u64 cyc_count;
           u64 kernel_start;
           u64 last_time;
           struct call_return_processor *crp;
           struct comm *comm;
           unsigned int arr_sz;
           enum retpoline_state_t rstate;
           struct branch_stack *br_stack_rb;
           unsigned int br_stack_sz;
           unsigned int br_stack_pos;
           bool mispred_all;
        };

🎀 Members 🎀

bestie, here's the member-by-member tour, and every single one is staying in the group chat:

• stack — array that holds the stack. the icon. 💅
• cnt — number of entries in the stack. count 'em. 🔥
• sz — current maximum stack size. 💖
• trace_nr — current trace number. 🎀
• branch_count — running branch count. 🦋
• insn_count — running instruction count. 🌸
• cyc_count — running cycle count. ⭐
• kernel_start — kernel start address. 👑
• last_time — last timestamp. 🕰️
• crp — call/return processor. 💜
• comm — current comm. 🫶
• arr_sz — size of array if this is the first element of an array. 😭
• rstate — used to detect retpolines. 💀
• br_stack_rb — branch stack (ring buffer). 🌈
• br_stack_sz — maximum branch stack size. 🍓
• br_stack_pos — current position in br_stack_rb. 🧚
• mispred_all — mark all branches as mispredicted. yeah, all of them. 🙈

🔥 SEE ALSO 🔥

• Kernel file ./tools/perf/util/thread-stack.c and struct thread_stack_entry(9) — go peek, iykyk. 🫶

mwah 💋 source/version is ./tools/perf/util, the date is October 2026, and this whole page is struct thread_stack(9). byeee 🦋💖