cpu_aggr_map__new(9)

📦 version 7.3.1, in nixpkgs unstable

💅 cpu_aggr_map__new(9) — like, the Kernel API Manual page you actually wanna read 🎀

okay so bestie, gather round, because this one is genuinely a little baddie. This is a page from the Kernel API Manual (yes, that's the manual name, we're being fancy today ✨), and it's all about building one specific cute little struct. Let's get into it 🦋

🌸 NAME 🌸

cpu_aggr_map__new — makes you a cpu_aggr_map with an aggr_cpu_id for every single cpu in cpus. no cap, every one 💖

the aggr_cpu_id gets created using 'get_id', and you can pass a data value to it if you want (or don't, live your truth). and then — this is the iconic part — the cpu_aggr_map comes out sorted, with duplicate values removed. like, it literally declutters itself. main character energy fr fr 👑

✨ SYNOPSIS ✨

struct cpu_aggr_map * cpu_aggr_map__new (const struct perf_cpu_map *cpus
, aggr_cpu_id_get_t get_id , void *data , bool needs_sort );

that's the whole signature, copy it exactly, don't freestyle it 🙈

🫶 ARGUMENTS 🫶

so about the arguments… the original page is a little shy here. every single one of them is marked -- undescribed --, and ngl i'm not gonna sit here and invent lore for you. that's not the vibe. facts only, periodt 💅

  • cpus — -- undescribed --
  • get_id — -- undescribed --
  • data — -- undescribed --
  • needs_sort — -- undescribed --
lowkey tragic that the docs ghosted us on these 😭 but hey, i'm not about to make stuff up. if the page doesn't say it, i don't say it. that's the rule, and we respect the rule 🧚

🌈 SEE ALSO 🌈

the kernel file lives at ./tools/perf/util/cpumap.h and it's giving friend group, because here's everyone else you might wanna meet:

like, the whole topo squad is here — socket, die, cluster, core, node, global — and cpu_aggr_map__empty_new(9) for when you want the map but, y'know, empty 🍓

⭐ the cute sign-off ⭐

this lil masterpiece lives in ./tools/perf/util, and the version/date stamp on it says October 2026 💜 so yeah, when you're reading this in October 2026, know that future-you is thriving and so is this manpage.

stay sorted, stay deduplicated, and go build some maps bestie 🦋💖✨

📦 where this page comes from