acpi_pptt_g...om_container(9)

💖 acpi_pptt_get_cpus_from_container — Kernel API Manual ✨

okay so bestie, we're in the <pink>Kernel API Manual</pink> today and the star of the show is literally acpi_pptt_get_cpus_from_container(9). yes that's the whole name, no we're not shortening it, it's iconic and it knows it 💅

---

🌸 NAME 🌸

acpi_pptt_get_cpus_from_container — populates a cpumask with, like, every single CPU inside a processor container. the whole squad. no one gets left behind 🫶

---

✨ SYNOPSIS ✨

void acpi_pptt_get_cpus_from_container (u32 acpi_cpu_id , cpumask_t
*cpus );

it returns void, so don't go looking for a return value, she gives nothing back and that's her main character energy 👑

---

🎀 ARGUMENTS 🎀

• acpi_cpu_id — the UID of the processor container. it's a u32 btw. this is the container we're hunting for 🔍
• cpus — the resulting CPU mask. it's a cpumask_t *, a pointer, so yeah we're writing into it. this is where the CPUs land 💫

---

🦋 DESCRIPTION 🦋

so what does she actually do? she finds the specified Processor Container, and then fills cpus with all the cpus below it. every last one. periodt.

now here's the lore, because this part matters, ngl:

not all 'Processor Hierarchy' entries in the PPTT are either a CPU or a Processor Container — some of them exist purely to describe a Private resource. like, they're just vibing there for a different reason entirely 🙈

and CPUs? CPUs have to be leaves. leaves as in the tree structure, bestie, not the salad. so a Processor Container is a non-leaf that has the 'ACPI Processor ID valid' flag set. that's the vibe check that tells you what you're looking at 🌿

---

🔥 SEE ALSO 🔥

okay this list is long but every single one of them ate, so let's give them their moment:

• kernel file ./drivers/acpi/pptt.c
• acpi_pptt_walk_cache(9)
• acpi_count_levels(9)
• acpi_pptt_leaf_node(9)
• acpi_find_processor_node(9)
• update_cache_properties(9)
• topology_get_acpi_cpu_tag(9)
• check_acpi_cpu_flag(9)
• acpi_get_cache_info(9)
• cache_setup_acpi(9)
• acpi_pptt_cpu_is_thread(9)
• find_acpi_cpu_topology(9)
• find_acpi_cpu_topology_package(9)
• find_acpi_cpu_topology_cluster(9)
• find_acpi_cpu_topology_hetero_id(9)
• acpi_pptt_get_child_cpus(9)
• find_acpi_cache_level_from_id(9)
• acpi_pptt_get_cpumask_from_cache_id(9)

---

lowkey a whole friend group of functions fr fr. go read them, they're all in ./drivers/acpi and they're all slaying in their own way 💜

---

and that's the page!! brought to you by ./drivers/acpi, dated <cyan>October 2026</cyan>, in the <rainbow>Kernel API Manual</rainbow>. mwah, go populate some cpumasks responsibly 🍓🧚💖