include/asm-generic/flat.h

File Facts

System

Linux kernel

Corpus path

include/asm-generic/flat.h

Extension

.h

Size

610 bytes

Lines

27

Domain

Repository Root And Misc

Bucket

include

Inferred role

Repository Root And Misc: implementation source

Status

source implementation candidate

Why This File Exists

Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.

• Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.
• Touches user memory; correctness depends on fault-safe copying and privilege boundary handling.

Dependency Surface

• linux/uaccess.h

Detected Declarations

• function flat_get_addr_from_rp
• function flat_put_addr_at_rp

Annotated Snippet

#ifndef _ASM_GENERIC_FLAT_H
#define _ASM_GENERIC_FLAT_H

#include <linux/uaccess.h>

static inline int flat_get_addr_from_rp(u32 __user *rp, u32 relval, u32 flags,
		u32 *addr)
{
#ifndef CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS
	return copy_from_user(addr, rp, 4) ? -EFAULT : 0;
#else
	return get_user(*addr, rp);
#endif
}

static inline int flat_put_addr_at_rp(u32 __user *rp, u32 addr, u32 rel)
{
#ifndef CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS
	return copy_to_user(rp, &addr, 4) ? -EFAULT : 0;
#else
	return put_user(addr, rp);
#endif
}

#endif /* _ASM_GENERIC_FLAT_H */

Annotation

• Immediate include surface: `linux/uaccess.h`.
• Detected declarations: `function flat_get_addr_from_rp`, `function flat_put_addr_at_rp`.
• Atlas domain: Repository Root And Misc / include.
• Implementation status: source implementation candidate.
• This snippet crosses the user/kernel memory boundary; validate fault handling and access checks before translating the pattern.

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.