drivers/net/ethernet/aquantia/atlantic/aq_pci_func.c

File Facts

System

Linux kernel

Corpus path

drivers/net/ethernet/aquantia/atlantic/aq_pci_func.c

Extension

.c

Size

12255 bytes

Lines

488

Domain

Driver Families

Bucket

drivers/net

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.
• 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/interrupt.h
• linux/module.h
• aq_main.h
• aq_nic.h
• aq_vec.h
• aq_hw.h
• aq_pci_func.h
• hw_atl/hw_atl_a0.h
• hw_atl/hw_atl_b0.h
• hw_atl2/hw_atl2.h
• aq_filters.h
• aq_drvinfo.h
• aq_macsec.h

Detected Declarations

• function aq_pci_probe_get_hw_by_id
• function aq_pci_func_init
• function aq_pci_func_alloc_irq
• function aq_pci_func_free_irqs
• function aq_pci_func_get_irq_type
• function aq_pci_free_irq_vectors
• function aq_pci_probe
• function aq_pci_remove
• function aq_pci_shutdown
• function aq_suspend_common
• function atl_resume_common
• function aq_pm_freeze
• function aq_pm_suspend_poweroff
• function aq_pm_thaw
• function aq_pm_resume_restore
• function aq_pci_func_register_driver
• function aq_pci_func_unregister_driver

Annotated Snippet

static struct pci_driver aq_pci_driver = {
	.name = AQ_CFG_DRV_NAME,
	.id_table = aq_pci_tbl,
	.probe = aq_pci_probe,
	.remove = aq_pci_remove,
	.shutdown = aq_pci_shutdown,
#ifdef CONFIG_PM
	.driver.pm = &aq_pm_ops,
#endif
};

int aq_pci_func_register_driver(void)
{
	return pci_register_driver(&aq_pci_driver);
}

void aq_pci_func_unregister_driver(void)
{
	pci_unregister_driver(&aq_pci_driver);
}

Annotation

• Immediate include surface: `linux/interrupt.h`, `linux/module.h`, `aq_main.h`, `aq_nic.h`, `aq_vec.h`, `aq_hw.h`, `aq_pci_func.h`, `hw_atl/hw_atl_a0.h`.
• Detected declarations: `function aq_pci_probe_get_hw_by_id`, `function aq_pci_func_init`, `function aq_pci_func_alloc_irq`, `function aq_pci_func_free_irqs`, `function aq_pci_func_get_irq_type`, `function aq_pci_free_irq_vectors`, `function aq_pci_probe`, `function aq_pci_remove`, `function aq_pci_shutdown`, `function aq_suspend_common`.
• Atlas domain: Driver Families / drivers/net.
• Implementation status: pattern 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.