arch/powerpc/include/asm/book3s/32/kup.h

File Facts

System

Linux kernel

Corpus path

arch/powerpc/include/asm/book3s/32/kup.h

Extension

.h

Size

3725 bytes

Lines

175

Domain

Architecture Layer

Bucket

arch/powerpc

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.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• asm/bug.h
• asm/book3s/32/mmu-hash.h
• asm/mmu.h
• asm/synch.h
• linux/sched.h

Detected Declarations

• function kuap_lock_one
• function kuap_unlock_one
• function uaccess_begin_32s
• function uaccess_end_32s
• function __kuap_save_and_lock
• function kuap_user_restore
• function __kuap_get_and_assert_locked
• function allow_user_access
• function prevent_user_access
• function prevent_user_access_return
• function restore_user_access
• function __bad_kuap_fault

Annotated Snippet

if (!(kuap & 0x0fffffff) && address > kuap - 4 && fix_alignment(regs)) {
			regs_add_return_ip(regs, 4);
			emulate_single_step(regs);
		} else {
			regs->kuap = address;
		}
	}

	return false;
}

#endif /* CONFIG_PPC_KUAP */

#endif /* __ASSEMBLER__ */

#endif /* _ASM_POWERPC_BOOK3S_32_KUP_H */

Annotation

• Immediate include surface: `asm/bug.h`, `asm/book3s/32/mmu-hash.h`, `asm/mmu.h`, `asm/synch.h`, `linux/sched.h`.
• Detected declarations: `function kuap_lock_one`, `function kuap_unlock_one`, `function uaccess_begin_32s`, `function uaccess_end_32s`, `function __kuap_save_and_lock`, `function kuap_user_restore`, `function __kuap_get_and_assert_locked`, `function allow_user_access`, `function prevent_user_access`, `function prevent_user_access_return`.
• Atlas domain: Architecture Layer / arch/powerpc.
• 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.