arch/loongarch/include/asm/pgtable.h

File Facts

System

Linux kernel

Corpus path

arch/loongarch/include/asm/pgtable.h

Extension

.h

Size

16529 bytes

Lines

647

Domain

Architecture Layer

Bucket

arch/loongarch

Inferred role

Architecture Layer: implementation source

Status

source implementation candidate

Why This File Exists

CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.

• CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/compiler.h
• asm/addrspace.h
• asm/asm.h
• asm/page.h
• asm/pgtable-bits.h
• asm-generic/pgtable-nopmd.h
• asm-generic/pgtable-nopud.h
• asm-generic/pgtable-nop4d.h
• asm/highmem.h
• linux/mm_types.h
• linux/mmzone.h
• asm/fixmap.h
• asm/sparsemem.h

Detected Declarations

• struct mm_struct
• struct vm_area_struct
• function p4d_none
• function p4d_bad
• function p4d_present
• function set_p4d
• function p4d_clear
• function pud_none
• function pud_bad
• function pud_present
• function set_pud
• function pud_clear
• function pmd_none
• function pmd_bad
• function pmd_present
• function set_pmd
• function pmd_clear
• function mk_swap_pte
• function pte_swp_exclusive
• function pte_swp_mkexclusive
• function pte_swp_clear_exclusive
• function set_pte
• function pte_clear
• function pte_present
• function pte_young
• function pte_dirty
• function pte_mkold
• function pte_mkyoung
• function pte_mkclean
• function pte_mkdirty
• function pte_mkwrite_novma
• function pte_wrprotect
• function pte_huge
• function pte_mkhuge
• function pte_special
• function pte_mkspecial
• function pte_accessible
• function pte_modify
• function update_mmu_cache_range
• function update_mmu_cache_pmd
• function pmd_pfn
• function pmd_trans_huge
• function pmd_mkhuge
• function pmd_write
• function pmd_mkwrite_novma
• function pmd_wrprotect
• function pmd_dirty
• function pmd_mkclean

Annotated Snippet

static inline int pte_write(pte_t pte)	{ return pte_val(pte) & _PAGE_WRITE; }
static inline int pte_young(pte_t pte)	{ return pte_val(pte) & _PAGE_ACCESSED; }
static inline int pte_dirty(pte_t pte)	{ return pte_val(pte) & (_PAGE_DIRTY | _PAGE_MODIFIED); }

static inline pte_t pte_mkold(pte_t pte)
{
	pte_val(pte) &= ~_PAGE_ACCESSED;
	return pte;
}

static inline pte_t pte_mkyoung(pte_t pte)
{
	pte_val(pte) |= _PAGE_ACCESSED;
	return pte;
}

static inline pte_t pte_mkclean(pte_t pte)
{
	pte_val(pte) &= ~(_PAGE_DIRTY | _PAGE_MODIFIED);
	return pte;
}

static inline pte_t pte_mkdirty(pte_t pte)
{
	pte_val(pte) |= _PAGE_MODIFIED;
	if (pte_val(pte) & _PAGE_WRITE)
		pte_val(pte) |= _PAGE_DIRTY;
	return pte;
}

static inline pte_t pte_mkwrite_novma(pte_t pte)
{
	pte_val(pte) |= _PAGE_WRITE;
	if (pte_val(pte) & _PAGE_MODIFIED)
		pte_val(pte) |= _PAGE_DIRTY;
	return pte;
}

static inline pte_t pte_wrprotect(pte_t pte)
{
	pte_val(pte) &= ~(_PAGE_WRITE | _PAGE_DIRTY);
	return pte;
}

static inline int pte_huge(pte_t pte)	{ return pte_val(pte) & _PAGE_HUGE; }

static inline pte_t pte_mkhuge(pte_t pte)
{
	pte_val(pte) |= _PAGE_HUGE;
	return pte;
}

#if defined(CONFIG_ARCH_HAS_PTE_SPECIAL)
static inline int pte_special(pte_t pte)	{ return pte_val(pte) & _PAGE_SPECIAL; }
static inline pte_t pte_mkspecial(pte_t pte)	{ pte_val(pte) |= _PAGE_SPECIAL; return pte; }
#endif /* CONFIG_ARCH_HAS_PTE_SPECIAL */

#define pte_accessible pte_accessible
static inline unsigned long pte_accessible(struct mm_struct *mm, pte_t a)
{
	if (pte_val(a) & _PAGE_PRESENT)
		return true;

	if ((pte_val(a) & _PAGE_PROTNONE) &&
			atomic_read(&mm->tlb_flush_pending))
		return true;

	return false;
}

static inline pte_t pte_modify(pte_t pte, pgprot_t newprot)
{
	if (pte_val(pte) & _PAGE_DIRTY)
		pte_val(pte) |= _PAGE_MODIFIED;

	return __pte((pte_val(pte) & _PAGE_CHG_MASK) |
		     (pgprot_val(newprot) & ~_PAGE_CHG_MASK));
}

extern void __update_tlb(struct vm_area_struct *vma,
			unsigned long address, pte_t *ptep);

static inline void update_mmu_cache_range(struct vm_fault *vmf,
		struct vm_area_struct *vma, unsigned long address,
		pte_t *ptep, unsigned int nr)
{
	for (;;) {
		__update_tlb(vma, address, ptep);
		if (--nr == 0)
			break;

Annotation

• Immediate include surface: `linux/compiler.h`, `asm/addrspace.h`, `asm/asm.h`, `asm/page.h`, `asm/pgtable-bits.h`, `asm-generic/pgtable-nopmd.h`, `asm-generic/pgtable-nopud.h`, `asm-generic/pgtable-nop4d.h`.
• Detected declarations: `struct mm_struct`, `struct vm_area_struct`, `function p4d_none`, `function p4d_bad`, `function p4d_present`, `function set_p4d`, `function p4d_clear`, `function pud_none`, `function pud_bad`, `function pud_present`.
• Atlas domain: Architecture Layer / arch/loongarch.
• Implementation status: source 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.