drivers/hwtracing/ptt/hisi_ptt.c
Source file repositories/reference/linux-study-clean/drivers/hwtracing/ptt/hisi_ptt.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/hwtracing/ptt/hisi_ptt.c- Extension
.c- Size
- 39420 bytes
- Lines
- 1443
- Domain
- Driver Families
- Bucket
- drivers/hwtracing
- Inferred role
- Driver Families: operation-table or driver-model contract
- Status
- pattern 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.
- Defines an operation table; this is where Linux turns generic core objects into subsystem-specific behavior.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- 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/bitfield.hlinux/bitops.hlinux/cpuhotplug.hlinux/delay.hlinux/dma-mapping.hlinux/interrupt.hlinux/io.hlinux/iommu.hlinux/iopoll.hlinux/module.hlinux/sysfs.hlinux/vmalloc.hhisi_ptt.h
Detected Declarations
function hisi_ptt_wait_tuning_finishfunction hisi_ptt_tune_attr_showfunction hisi_ptt_tune_attr_storefunction hisi_ptt_get_filter_valfunction hisi_ptt_wait_trace_hw_idlefunction hisi_ptt_wait_dma_reset_donefunction hisi_ptt_trace_endfunction hisi_ptt_trace_startfunction hisi_ptt_update_auxfunction hisi_ptt_isrfunction hisi_ptt_irq_free_vectorsfunction hisi_ptt_register_irqfunction hisi_ptt_del_free_filterfunction hisi_ptt_alloc_add_filterfunction hisi_ptt_filter_showfunction hisi_ptt_create_rp_filter_attrfunction hisi_ptt_remove_rp_filter_attrfunction hisi_ptt_create_req_filter_attrfunction hisi_ptt_remove_req_filter_attrfunction hisi_ptt_create_filter_attrfunction hisi_ptt_remove_filter_attrfunction hisi_ptt_remove_all_filter_attributesfunction hisi_ptt_init_filter_attributesfunction list_for_each_entryfunction list_for_each_entryfunction hisi_ptt_update_filtersfunction hisi_ptt_init_filter_attributesfunction list_for_each_entry_safefunction hisi_ptt_notifier_callfunction hisi_ptt_init_filtersfunction hisi_ptt_release_filtersfunction hisi_ptt_config_trace_buffunction hisi_ptt_init_ctrlsfunction cpumask_showfunction hisi_ptt_filter_multiselect_showfunction hisi_ptt_trace_valid_directionfunction hisi_ptt_trace_valid_typefunction hisi_ptt_trace_valid_formatfunction hisi_ptt_trace_valid_filterfunction list_for_each_entryfunction hisi_ptt_pmu_init_configsfunction hisi_ptt_pmu_event_initfunction hisi_ptt_pmu_free_auxfunction hisi_ptt_pmu_startfunction hisi_ptt_pmu_stopfunction hisi_ptt_pmu_addfunction hisi_ptt_pmu_delfunction hisi_ptt_pmu_read
Annotated Snippet
static struct pci_driver hisi_ptt_driver = {
.name = DRV_NAME,
.id_table = hisi_ptt_id_tbl,
.probe = hisi_ptt_probe,
};
static int hisi_ptt_cpu_teardown(unsigned int cpu, struct hlist_node *node)
{
struct hisi_ptt *hisi_ptt;
struct device *dev;
int target, src;
hisi_ptt = hlist_entry_safe(node, struct hisi_ptt, hotplug_node);
src = hisi_ptt->trace_ctrl.on_cpu;
dev = hisi_ptt->hisi_ptt_pmu.dev;
if (!hisi_ptt->trace_ctrl.started || src != cpu)
return 0;
target = cpumask_any_but(cpumask_of_node(dev_to_node(&hisi_ptt->pdev->dev)), cpu);
if (target >= nr_cpu_ids) {
dev_err(dev, "no available cpu for perf context migration\n");
return 0;
}
perf_pmu_migrate_context(&hisi_ptt->hisi_ptt_pmu, src, target);
/*
* Also make sure the interrupt bind to the migrated CPU as well. Warn
* the user on failure here.
*/
if (irq_set_affinity(hisi_ptt->trace_irq, cpumask_of(target)))
dev_warn(dev, "failed to set the affinity of trace interrupt\n");
hisi_ptt->trace_ctrl.on_cpu = target;
return 0;
}
static int __init hisi_ptt_init(void)
{
int ret;
ret = cpuhp_setup_state_multi(CPUHP_AP_ONLINE_DYN, DRV_NAME, NULL,
hisi_ptt_cpu_teardown);
if (ret < 0)
return ret;
hisi_ptt_pmu_online = ret;
ret = pci_register_driver(&hisi_ptt_driver);
if (ret)
cpuhp_remove_multi_state(hisi_ptt_pmu_online);
return ret;
}
module_init(hisi_ptt_init);
static void __exit hisi_ptt_exit(void)
{
pci_unregister_driver(&hisi_ptt_driver);
cpuhp_remove_multi_state(hisi_ptt_pmu_online);
}
module_exit(hisi_ptt_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Yicong Yang <yangyicong@hisilicon.com>");
MODULE_DESCRIPTION("Driver for HiSilicon PCIe tune and trace device");
Annotation
- Immediate include surface: `linux/bitfield.h`, `linux/bitops.h`, `linux/cpuhotplug.h`, `linux/delay.h`, `linux/dma-mapping.h`, `linux/interrupt.h`, `linux/io.h`, `linux/iommu.h`.
- Detected declarations: `function hisi_ptt_wait_tuning_finish`, `function hisi_ptt_tune_attr_show`, `function hisi_ptt_tune_attr_store`, `function hisi_ptt_get_filter_val`, `function hisi_ptt_wait_trace_hw_idle`, `function hisi_ptt_wait_dma_reset_done`, `function hisi_ptt_trace_end`, `function hisi_ptt_trace_start`, `function hisi_ptt_update_aux`, `function hisi_ptt_isr`.
- Atlas domain: Driver Families / drivers/hwtracing.
- Implementation status: pattern implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
- 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.