coresight_find_sink(9)

📦 version 7.3.1, in nixpkgs unstable

💅 coresight_find_sink 💅

okay so real talk — this is a page from the Kernel API Manual, and it's about coresight_find_sink, bestie. it's literally a recursive lil function that walks the trace connections starting from a source until it finds a suitable default sink. it's giving "follow the breadcrumbs" energy and honestly? iconic. 🎀

✨ NAME ✨

coresight_find_sink — a recursive function that walks trace connections from a source to find a suitable default sink. no cap, that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

struct coresight_device * coresight_find_sink (struct coresight_device
*csdev , int *depth );

like, yes, it returns a struct coresight_device * pointer. she's a pointer-returning girlie. 💅

🫶 ARGUMENTS 🫶

  • csdev — the source / current device to check. this is who we're looking at right now, bestie. 👀
  • depth — bestie this one's doing double duty fr fr: it's [in] the search depth of the calling dev, and [out] the depth of the found sink. in-and-out, main character energy. ✨

🔥 DESCRIPTION 🔥

so what does she actually do? she walks the connection path from a source (an ETM, iykyk) until a suitable sink is encountered, and then returns that sink to the original caller. slay. 🌈

if the current device is a plain sink, she just returns that sink & its depth — no drama, no recursion, we love a simple queen. 🎀 otherwise she recursively calls the child connections looking for a sink. and to pick the bestest one possible, she uses coresight_select_best_sink. 👑

she returns the best sink found — or NULL if nothing was found at this node or any of the child nodes. 😭 (that's the sad ending, hope u never see it.)

👑 SEE ALSO 👑

the kernel file lives at ./drivers/hwtracing/coresight/coresight-core.c, and here's the whole squad — go read these too, bestie, they're all part of the lore:

fr fr, that's the whole page. go build that path, queen. 💖

okay and before u go — this one's served fresh out of ./drivers/hwtracing/coresight, dated October 2026, and it's coresight_find_sink(9) in the Kernel API Manual. ty for coming to my ted talk, mwah 💋🧚‍♀️🍓

📦 where this page comes from