drivers/perf/arm_smmuv3_pmu.c

File Facts

System

Linux kernel

Corpus path

drivers/perf/arm_smmuv3_pmu.c

Extension

.c

Size

29725 bytes

Lines

1038

Domain

Driver Families

Bucket

drivers/perf

Inferred role

Driver Families: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

• Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• Touches IRQ or DMA behavior; this matters for the representative real-device path.
• Allocates kernel memory; connect allocation flags and lifetime to context constraints.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/acpi.h
• linux/acpi_iort.h
• linux/bitfield.h
• linux/bitops.h
• linux/cpuhotplug.h
• linux/cpumask.h
• linux/device.h
• linux/errno.h
• linux/interrupt.h
• linux/irq.h
• linux/kernel.h
• linux/list.h
• linux/msi.h
• linux/of.h
• linux/perf_event.h
• linux/platform_device.h
• linux/smp.h
• linux/sysfs.h
• linux/types.h

Detected Declarations

• struct smmu_pmu
• function smmu_pmu_enable
• function smmu_pmu_enable_quirk_hip08_09
• function smmu_pmu_disable
• function smmu_pmu_disable_quirk_hip08_09
• function smmu_pmu_counter_set_value
• function smmu_pmu_counter_get_value
• function smmu_pmu_counter_enable
• function smmu_pmu_counter_disable
• function smmu_pmu_interrupt_enable
• function smmu_pmu_interrupt_disable
• function smmu_pmu_set_evtyper
• function smmu_pmu_set_smr
• function smmu_pmu_event_update
• function smmu_pmu_set_period
• function smmu_pmu_set_event_filter
• function smmu_pmu_check_global_filter
• function smmu_pmu_apply_event_filter
• function smmu_pmu_get_event_idx
• function smmu_pmu_events_compatible
• function smmu_pmu_event_init
• function for_each_sibling_event
• function smmu_pmu_event_start
• function smmu_pmu_event_stop
• function smmu_pmu_event_add
• function smmu_pmu_event_del
• function smmu_pmu_event_read
• function smmu_pmu_cpumask_show
• function smmu_pmu_event_show
• function smmu_pmu_event_is_visible
• function smmu_pmu_identifier_attr_show
• function smmu_pmu_identifier_attr_visible
• function smmu_pmu_offline_cpu
• function smmu_pmu_handle_irq
• function smmu_pmu_free_msis
• function smmu_pmu_write_msi_msg
• function smmu_pmu_setup_msi
• function smmu_pmu_setup_irq
• function smmu_pmu_reset
• function smmu_pmu_get_acpi_options
• function smmu_pmu_coresight_id_regs
• function smmu_pmu_get_iidr
• function smmu_pmu_probe
• function smmu_pmu_remove
• function smmu_pmu_shutdown
• function arm_smmu_pmu_init
• function arm_smmu_pmu_exit
• module init arm_smmu_pmu_init

Annotated Snippet

module_init(arm_smmu_pmu_init);

static void __exit arm_smmu_pmu_exit(void)
{
	platform_driver_unregister(&smmu_pmu_driver);
	cpuhp_remove_multi_state(cpuhp_state_num);
}

module_exit(arm_smmu_pmu_exit);

MODULE_ALIAS("platform:arm-smmu-v3-pmcg");
MODULE_DESCRIPTION("PMU driver for ARM SMMUv3 Performance Monitors Extension");
MODULE_AUTHOR("Neil Leeder <nleeder@codeaurora.org>");
MODULE_AUTHOR("Shameer Kolothum <shameerali.kolothum.thodi@huawei.com>");
MODULE_LICENSE("GPL v2");

Annotation

• Immediate include surface: `linux/acpi.h`, `linux/acpi_iort.h`, `linux/bitfield.h`, `linux/bitops.h`, `linux/cpuhotplug.h`, `linux/cpumask.h`, `linux/device.h`, `linux/errno.h`.
• Detected declarations: `struct smmu_pmu`, `function smmu_pmu_enable`, `function smmu_pmu_enable_quirk_hip08_09`, `function smmu_pmu_disable`, `function smmu_pmu_disable_quirk_hip08_09`, `function smmu_pmu_counter_set_value`, `function smmu_pmu_counter_get_value`, `function smmu_pmu_counter_enable`, `function smmu_pmu_counter_disable`, `function smmu_pmu_interrupt_enable`.
• Atlas domain: Driver Families / drivers/perf.
• Implementation status: integration implementation candidate.
• IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.

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.