arch/powerpc/perf/kvm-hv-pmu.c

File Facts

System

Linux kernel

Corpus path

arch/powerpc/perf/kvm-hv-pmu.c

Extension

.c

Size

11050 bytes

Lines

437

Domain

Architecture Layer

Bucket

arch/powerpc

Inferred role

Architecture Layer: exported/initcall integration point

Status

integration 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.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• 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

• asm-generic/local64.h
• linux/kernel.h
• linux/errno.h
• linux/ratelimit.h
• linux/kvm_host.h
• linux/gfp_types.h
• linux/pgtable.h
• linux/perf_event.h
• linux/spinlock_types.h
• linux/spinlock.h
• linux/sysfs.h
• asm/types.h
• asm/kvm_ppc.h
• asm/kvm_book3s.h
• asm/mmu.h
• asm/pgalloc.h
• asm/pte-walk.h
• asm/reg.h
• asm/plpar_wrappers.h
• asm/firmware.h
• asm/guest-state-buffer.h

Detected Declarations

• enum kvmppc_pmu_eventid
• function kvmppc_events_sysfs_show
• function kvmppc_update_l0_stats
• function kvmppc_pmu_event_update
• function kvmppc_pmu_event_init
• function kvmppc_pmu_del
• function kvmppc_pmu_add
• function kvmppc_pmu_read
• function hostwide_get_size
• function hostwide_fill_info
• function hostwide_refresh_info
• function kvmppc_init_hostwide
• function kvmppc_cleanup_hostwide
• function kvmppc_register_pmu
• function kvmppc_unregister_pmu
• module init kvmppc_register_pmu

Annotated Snippet

module_init(kvmppc_register_pmu);
module_exit(kvmppc_unregister_pmu);
MODULE_DESCRIPTION("KVM PPC Book3s-hv PMU");
MODULE_AUTHOR("Vaibhav Jain <vaibhav@linux.ibm.com>");
MODULE_LICENSE("GPL");

Annotation

• Immediate include surface: `asm-generic/local64.h`, `linux/kernel.h`, `linux/errno.h`, `linux/ratelimit.h`, `linux/kvm_host.h`, `linux/gfp_types.h`, `linux/pgtable.h`, `linux/perf_event.h`.
• Detected declarations: `enum kvmppc_pmu_eventid`, `function kvmppc_events_sysfs_show`, `function kvmppc_update_l0_stats`, `function kvmppc_pmu_event_update`, `function kvmppc_pmu_event_init`, `function kvmppc_pmu_del`, `function kvmppc_pmu_add`, `function kvmppc_pmu_read`, `function hostwide_get_size`, `function hostwide_fill_info`.
• Atlas domain: Architecture Layer / arch/powerpc.
• Implementation status: integration 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.