mm/percpu.c

File Facts

System

Linux kernel

Corpus path

mm/percpu.c

Extension

.c

Size

102885 bytes

Lines

3389

Domain

Core OS

Bucket

Memory Management

Inferred role

Core OS: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.

• Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Allocates kernel memory; connect allocation flags and lifetime to context constraints.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/bitmap.h
• linux/cpumask.h
• linux/memblock.h
• linux/err.h
• linux/list.h
• linux/log2.h
• linux/mm.h
• linux/module.h
• linux/mutex.h
• linux/percpu.h
• linux/pfn.h
• linux/slab.h
• linux/spinlock.h
• linux/vmalloc.h
• linux/workqueue.h
• linux/kmemleak.h
• linux/sched.h
• linux/sched/mm.h
• linux/memcontrol.h
• asm/cacheflush.h
• asm/sections.h
• asm/tlbflush.h
• asm/io.h
• trace/events/percpu.h
• percpu-internal.h
• percpu-km.c
• percpu-vm.c
• linux/pgalloc.h

Detected Declarations

• function pcpu_schedule_balance_work
• function pcpu_addr_in_chunk
• function __pcpu_size_to_slot
• function pcpu_size_to_slot
• function pcpu_chunk_slot
• function pcpu_set_page_chunk
• function pcpu_page_idx
• function pcpu_unit_page_offset
• function pcpu_chunk_addr
• function pcpu_off_to_block_index
• function pcpu_off_to_block_off
• function pcpu_block_off_to_off
• function pcpu_check_block_hint
• function pcpu_next_hint
• function pcpu_next_md_free_region
• function pcpu_next_fit_region
• function pcpu_mem_free
• function __pcpu_chunk_move
• function pcpu_chunk_move
• function pcpu_chunk_relocate
• function pcpu_isolate_chunk
• function pcpu_reintegrate_chunk
• function pcpu_update_empty_pages
• function pcpu_region_overlap
• function pcpu_block_update
• function pcpu_find_block_fit
• function pcpu_chunk_refresh_hint
• function pcpu_block_refresh_hint
• function pcpu_block_update_hint_alloc
• function pcpu_block_update_hint_free
• function pcpu_is_populated
• function pcpu_find_block_fit
• function bitmap_find_next_zero_area_off
• function pcpu_alloc_area
• function pcpu_free_area
• function pcpu_init_md_block
• function pcpu_init_md_blocks
• function pcpu_alloc_first_chunk
• function pcpu_free_chunk
• function pcpu_chunk_populated
• function pcpu_chunk_depopulated
• function pcpu_memcg_pre_alloc_hook
• function pcpu_memcg_post_alloc_hook
• function pcpu_memcg_free_hook
• function pcpu_memcg_pre_alloc_hook
• function pcpu_memcg_post_alloc_hook
• function pcpu_alloc_tag_free_hook
• function pcpu_alloc_tag_alloc_hook

Annotated Snippet

subsys_initcall(percpu_enable_async);

Annotation

• Immediate include surface: `linux/bitmap.h`, `linux/cpumask.h`, `linux/memblock.h`, `linux/err.h`, `linux/list.h`, `linux/log2.h`, `linux/mm.h`, `linux/module.h`.
• Detected declarations: `function pcpu_schedule_balance_work`, `function pcpu_addr_in_chunk`, `function __pcpu_size_to_slot`, `function pcpu_size_to_slot`, `function pcpu_chunk_slot`, `function pcpu_set_page_chunk`, `function pcpu_page_idx`, `function pcpu_unit_page_offset`, `function pcpu_chunk_addr`, `function pcpu_off_to_block_index`.
• Atlas domain: Core OS / Memory Management.
• Implementation status: integration implementation candidate.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.