arch/arm64/kvm/hyp/include/nvhe/trace.h

File Facts

System

Linux kernel

Corpus path

arch/arm64/kvm/hyp/include/nvhe/trace.h

Extension

.h

Size

2456 bytes

Lines

71

Domain

Architecture Layer

Bucket

arch/arm64

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/trace_remote_event.h
• asm/kvm_hyptrace.h

Detected Declarations

• function __tracing_get_vcpu_pid
• function tracing_commit_entry
• function __tracing_unload
• function __tracing_swap_reader
• function __tracing_update_clock
• function __tracing_enable_event

Annotated Snippet

static inline void tracing_commit_entry(void) { }
#define HYP_EVENT(__name, __proto, __struct, __assign, __printk)      \
	static inline void trace_##__name(__proto) {}

static inline int __tracing_load(unsigned long desc_va, size_t desc_size) { return -ENODEV; }
static inline void __tracing_unload(void) { }
static inline int __tracing_enable(bool enable) { return -ENODEV; }
static inline int __tracing_swap_reader(unsigned int cpu) { return -ENODEV; }
static inline void __tracing_update_clock(u32 mult, u32 shift, u64 epoch_ns, u64 epoch_cyc) { }
static inline int __tracing_reset(unsigned int cpu) { return -ENODEV; }
static inline int __tracing_enable_event(unsigned short id, bool enable)  { return -ENODEV; }
#endif
#endif

Annotation

• Immediate include surface: `linux/trace_remote_event.h`, `asm/kvm_hyptrace.h`.
• Detected declarations: `function __tracing_get_vcpu_pid`, `function tracing_commit_entry`, `function __tracing_unload`, `function __tracing_swap_reader`, `function __tracing_update_clock`, `function __tracing_enable_event`.
• Atlas domain: Architecture Layer / arch/arm64.
• 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.