mm/sparse-vmemmap.c
Source file repositories/reference/linux-study-clean/mm/sparse-vmemmap.c
File Facts
- System
- Linux kernel
- Corpus path
mm/sparse-vmemmap.c- Extension
.c- Size
- 25522 bytes
- Lines
- 928
- Domain
- Core OS
- Bucket
- Memory Management
- Inferred role
- Core OS: implementation source
- Status
- source 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.
- 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/mm.hlinux/mmzone.hlinux/memblock.hlinux/memremap.hlinux/highmem.hlinux/slab.hlinux/spinlock.hlinux/vmalloc.hlinux/sched.hlinux/pgalloc.hasm/dma.hasm/tlbflush.hhugetlb_vmemmap.hinternal.h
Detected Declarations
function vmemmap_populatefunction vmemmap_alloc_blockfunction vmemmap_alloc_block_buffunction vmem_altmap_next_pfnfunction vmem_altmap_nr_freefunction altmap_alloc_block_buffunction vmemmap_verifyfunction vmemmap_pte_populatefunction vmemmap_alloc_block_zerofunction vmemmap_pmd_populatefunction vmemmap_pud_populatefunction vmemmap_p4d_populatefunction vmemmap_pgd_populatefunction vmemmap_populate_addressfunction vmemmap_populate_rangefunction vmemmap_populate_basepagesfunction vmemmap_wrprotect_hvofunction vmemmap_populate_hvofunction vmemmap_set_pmdfunction vmemmap_check_pmdfunction vmemmap_populate_hugepagesfunction sizefunction compound_section_tail_pagefunction vmemmap_populate_compound_pagesfunction __populate_section_memmapfunction sparse_vmemmap_init_nid_earlyfunction sparse_vmemmap_init_nid_latefunction subsection_mask_setfunction sparse_init_subsection_mapfunction online_mem_sectionsfunction offline_mem_sectionsfunction section_nr_vmemmap_pagesfunction populate_section_memmapfunction depopulate_section_memmapfunction free_map_bootmemfunction clear_subsection_mapfunction is_subsection_map_emptyfunction fill_subsection_mapfunction section_deactivatefunction section_activatefunction check_pfn_spanfunction sparse_remove_section
Annotated Snippet
if (!warned) {
warn_alloc(gfp_mask & ~__GFP_NOWARN, NULL,
"vmemmap alloc failure: order:%u", order);
warned = true;
}
return NULL;
} else
return __earlyonly_bootmem_alloc(node, size, size,
__pa(MAX_DMA_ADDRESS));
}
static void * __meminit altmap_alloc_block_buf(unsigned long size,
struct vmem_altmap *altmap);
/* need to make sure size is all the same during early stage */
void * __meminit vmemmap_alloc_block_buf(unsigned long size, int node,
struct vmem_altmap *altmap)
{
if (altmap)
return altmap_alloc_block_buf(size, altmap);
return vmemmap_alloc_block(size, node);
}
static unsigned long __meminit vmem_altmap_next_pfn(struct vmem_altmap *altmap)
{
return altmap->base_pfn + altmap->reserve + altmap->alloc
+ altmap->align;
}
static unsigned long __meminit vmem_altmap_nr_free(struct vmem_altmap *altmap)
{
unsigned long allocated = altmap->alloc + altmap->align;
if (altmap->free > allocated)
return altmap->free - allocated;
return 0;
}
static void * __meminit altmap_alloc_block_buf(unsigned long size,
struct vmem_altmap *altmap)
{
unsigned long pfn, nr_pfns, nr_align;
if (size & ~PAGE_MASK) {
pr_warn_once("%s: allocations must be multiple of PAGE_SIZE (%ld)\n",
__func__, size);
return NULL;
}
pfn = vmem_altmap_next_pfn(altmap);
nr_pfns = size >> PAGE_SHIFT;
nr_align = 1UL << find_first_bit(&nr_pfns, BITS_PER_LONG);
nr_align = ALIGN(pfn, nr_align) - pfn;
if (nr_pfns + nr_align > vmem_altmap_nr_free(altmap))
return NULL;
altmap->alloc += nr_pfns;
altmap->align += nr_align;
pfn += nr_align;
pr_debug("%s: pfn: %#lx alloc: %ld align: %ld nr: %#lx\n",
__func__, pfn, altmap->alloc, altmap->align, nr_pfns);
return __va(__pfn_to_phys(pfn));
}
void __meminit vmemmap_verify(pte_t *pte, int node,
unsigned long start, unsigned long end)
{
unsigned long pfn = pte_pfn(ptep_get(pte));
int actual_node = early_pfn_to_nid(pfn);
if (node_distance(actual_node, node) > LOCAL_DISTANCE)
pr_warn_once("[%lx-%lx] potential offnode page_structs\n",
start, end - 1);
}
static pte_t * __meminit vmemmap_pte_populate(pmd_t *pmd, unsigned long addr, int node,
struct vmem_altmap *altmap,
unsigned long ptpfn, unsigned long flags)
{
pte_t *pte = pte_offset_kernel(pmd, addr);
if (pte_none(ptep_get(pte))) {
pte_t entry;
void *p;
if (ptpfn == (unsigned long)-1) {
p = vmemmap_alloc_block_buf(PAGE_SIZE, node, altmap);
if (!p)
return NULL;
Annotation
- Immediate include surface: `linux/mm.h`, `linux/mmzone.h`, `linux/memblock.h`, `linux/memremap.h`, `linux/highmem.h`, `linux/slab.h`, `linux/spinlock.h`, `linux/vmalloc.h`.
- Detected declarations: `function vmemmap_populate`, `function vmemmap_alloc_block`, `function vmemmap_alloc_block_buf`, `function vmem_altmap_next_pfn`, `function vmem_altmap_nr_free`, `function altmap_alloc_block_buf`, `function vmemmap_verify`, `function vmemmap_pte_populate`, `function vmemmap_alloc_block_zero`, `function vmemmap_pmd_populate`.
- Atlas domain: Core OS / Memory Management.
- Implementation status: source implementation candidate.
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.