die_walk_instances(9)

📦 version 7.3.1, in nixpkgs unstable

💅 die_walk_instances(9) — the Kernel API Manual, bestie edition

okay so this is die_walk_instances from the kernel API manual (section 9, the kernel-functions one) — and yes it's a whole vibe, let's get into it ✨

🌸 NAME 🌸

die_walk_instances — walk the instances of a given DIE, literally that's the whole job 🫶

✨ SYNOPSIS ✨

int die_walk_instances (Dwarf_Die *or_die , int (*callback)(Dwarf_Die *,
void *) , void *data );

no cap, that's the whole signature 💖

🎀 ARGUMENTS 🎀

  • or_die — an abstract original DIE. that's the starting point, the main character of this whole operation 👑
  • callback — the callback function, and it gets called with each instance DIE. like it gets handed the instance, fr fr 🦋
  • data — user data. your stuff, your business, passed straight through 💜

🔥 DESCRIPTION 🔥

so you're walking on the instances of the given in_die (yes, the description calls it in_die while the signature says or_die — that's just how it is, we don't question the lore 🙈).

in_die must be an inlined function declaration. like, that's not a suggestion, that's the requirement 💀

what it returns:

  • the return value of callback, if the callback returns a non-zero value — it bails out right there and hands you back whatever your callback said 🏃‍♀️💨
  • -ENOENT if there is no instance. no instance, no problem, just a negative errno in your lap 😭

🌈 SEE ALSO 🌈

bestie the whole friend group is here, and they're all icons — also peep the kernel file ./tools/perf/util/dwarf-aux.c:

and that's the page, periodt 💅 this one lives under ./tools/perf/util and the version stamp says October 2026 — so yeah, it's giving very much current, very much slay, go off kernel docs 🎀✨

📦 where this page comes from