die_get_decl_file(9)

💖 die_get_decl_file (9) — a Kernel API Manual moment 💖

okay so bestie, welcome to the die_get_decl_file page, straight out of the Kernel API Manual ✨ this one's short and sweet and honestly kind of iconic for how much drama it packs into four lines. let's get into it 🎀

---

🌸 NAME 🌸

die_get_decl_file — find the declared file name of this DIE 💅

like, the declared file name. of a DIE. we're doing DWARF archaeology today bestie, no cap.

---

✨ SYNOPSIS ✨

const char * die_get_decl_file (Dwarf_Die *dw_die );

that's the whole vibe: takes a Dwarf_Die * and hands you back a const char *. simple. elegant. ate. 🔥

---

🦋 ARGUMENTS 🦋

• dw_die — a DIE for something declared. that's it, that's the argument, she's not complicated 🫶

---

💜 DESCRIPTION 💜

so what does she do? she gets the declared file name of dw_die. literally that's the whole thing 😭 get declared file name → return it. main character energy, zero filler, we love a function that knows exactly what it is ⭐

---

⚠️ NOTE ⚠️

okay this is the important part so listen up bestie 📢 since some version of clang's DWARF5 implementation incorrectly uses file index 0 for DW_AT_decl_file (yes, a bug, in the wild, bestie 😭💀), die_get_decl_file will return NULL for such cases.

and the takeaway? use this function instead. she handles the messy clang situation for you so you don't have to 🙈💅

ngl this is exactly the kind of caveat you screenshot and send to the group chat. clang said "file index 0, sounds fine" and everyone else had to cope 🍓

---

🧚 SEE ALSO 🧚

she does NOT walk alone, okay, she has a whole friend group. all of these live in the kernel file ./tools/perf/util/dwarf-aux.c and honestly? the roster is giving extended universe 🌈

• 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_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_reg(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)

iykyk 👑

---

and that's the page!! 💖 shipped to you from ./tools/perf/util, dated October 2026 — go forth and get those declared file names, bestie, and remember: NULL is a valid answer sometimes and that's clang's fault, not yours 🎀✨🫶