die_find_variable_by_reg(9)

okay bestie, welcome to die_find_variable_by_reg(9) from the Kernel API Manual 💅✨ — this is the dwarf-aux read for finding a variable saved in a register, and we’re gonna read it together.

🌸 NAME 🌸

die_find_variable_by_reg — find a variable saved in a register 🎀

✨ SYNOPSIS ✨

here’s the whole signature, copied with love and zero typos:

Dwarf_Die * die_find_variable_by_reg (Dwarf_Die *sc_die , Dwarf_Addr pc
       , int reg , Dwarf_Die *type_die , int *poffset , bool is_fbreg ,
       Dwarf_Die *die_mem );

💖 ARGUMENTS 💖

okay, argument roll call 📋:

• sc_die — a scope DIE 🫶
• pc — the program address to find 🔍
• reg — the register number to find 🎯
• type_die — -- undescribed -- (that’s literally what the page says, so no invented lore here 🙈)
• poffset — pointer to offset; it will be updated for the fbreg case ✨
• is_fbreg — boolean value if the current register is the frame base 🦋
• die_mem — a buffer to save the resulting DIE 🎀

🦋 DESCRIPTION 🦋

Find the variable DIE accessed by the given register 🔎. It’ll update the offset when the variable is in the stack 💅. that’s the whole vibe.

🔥 SEE ALSO 🔥

Kernel file: ./tools/perf/util/dwarf-aux.c 🧚

and here’s the full SEE ALSO squad, no skipped names, periodt 👑:

• cu_find_realpath(9), cu_get_comp_dir(9), cu_find_lineinfo(9), cu_walk_functions_at(9), die_get_linkage_name(9), die_compare_name(9), die_match_name(9), die_get_call_lineno(9)
• die_get_type(9), die_get_real_type(9), die_get_pointer_type(9), die_is_signed_type(9), die_is_func_def(9), die_entrypc(9), die_is_func_instance(9), die_get_data_member_location(9)
• die_get_call_file(9), die_get_decl_file(9), die_find_child(9), die_find_tailfunc(9), die_find_realfunc(9), die_find_top_inlinefunc(9), die_find_inlinefunc(9), die_find_func_rettype(9)
• die_walk_instances(9), die_walk_lines(9), die_find_variable_at(9), die_find_member(9), die_get_typename_from_type(9), die_get_typename(9), die_get_varname(9), die_get_var_innermost_scope(9)
• die_get_var_range(9), is_breg_access_indirect(9), die_find_variable_by_addr(9), die_collect_vars(9), die_collect_global_vars(9), die_get_cfa(9), die_get_scopes(9), die_get_member_type(9)
• die_deref_ptr_type(9)

source/version ./tools/perf/util • date October 2026 — mwah, go read some DWARF bestie 🫶💜