drivers/ata/pata_macio.c
Source file repositories/reference/linux-study-clean/drivers/ata/pata_macio.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/ata/pata_macio.c- Extension
.c- Size
- 41277 bytes
- Lines
- 1423
- Domain
- Driver Families
- Bucket
- drivers/ata
- 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.
- 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/kernel.hlinux/module.hlinux/init.hlinux/blkdev.hlinux/ata.hlinux/libata.hlinux/adb.hlinux/pmu.hlinux/scatterlist.hlinux/irqdomain.hlinux/of.hlinux/gfp.hlinux/pci.hscsi/scsi.hscsi/scsi_host.hscsi/scsi_device.hasm/macio.hasm/io.hasm/dbdma.hasm/machdep.hasm/pmac_feature.hasm/mediabay.h
Detected Declarations
struct pata_macio_timingstruct pata_macio_privstruct pata_macio_timingfunction pata_macio_apply_timingsfunction pata_macio_dev_selectfunction pata_macio_set_timingsfunction pata_macio_default_timingsfunction pata_macio_cable_detectfunction pata_macio_qc_prepfunction pata_macio_freezefunction pata_macio_bmdma_setupfunction pata_macio_bmdma_startfunction pata_macio_bmdma_stopfunction pata_macio_bmdma_statusfunction pata_macio_port_startfunction pata_macio_irq_clearfunction pata_macio_reset_hwfunction pata_macio_sdev_configurefunction pata_macio_do_suspendfunction pci_set_power_statefunction pata_macio_do_resumefunction pata_macio_invariantsfunction pata_macio_setup_iosfunction pmac_macio_calc_timing_masksfunction pata_macio_common_initfunction pata_macio_attachfunction pata_macio_detachfunction pata_macio_suspendfunction pata_macio_resumefunction pata_macio_mb_eventfunction pata_macio_pci_attachfunction pata_macio_pci_detachfunction pata_macio_pci_suspendfunction pata_macio_pci_resumefunction pata_macio_initfunction pata_macio_exitmodule init pata_macio_init
Annotated Snippet
static struct pci_driver pata_macio_pci_driver = {
.name = "pata-pci-macio",
.id_table = pata_macio_pci_match,
.probe = pata_macio_pci_attach,
.remove = pata_macio_pci_detach,
#ifdef CONFIG_PM_SLEEP
.suspend = pata_macio_pci_suspend,
.resume = pata_macio_pci_resume,
#endif
};
MODULE_DEVICE_TABLE(pci, pata_macio_pci_match);
static int __init pata_macio_init(void)
{
int rc;
if (!machine_is(powermac))
return -ENODEV;
rc = pci_register_driver(&pata_macio_pci_driver);
if (rc)
return rc;
rc = macio_register_driver(&pata_macio_driver);
if (rc) {
pci_unregister_driver(&pata_macio_pci_driver);
return rc;
}
return 0;
}
static void __exit pata_macio_exit(void)
{
macio_unregister_driver(&pata_macio_driver);
pci_unregister_driver(&pata_macio_pci_driver);
}
module_init(pata_macio_init);
module_exit(pata_macio_exit);
MODULE_AUTHOR("Benjamin Herrenschmidt");
MODULE_DESCRIPTION("Apple MacIO PATA driver");
MODULE_LICENSE("GPL");
MODULE_VERSION(DRV_VERSION);
Annotation
- Immediate include surface: `linux/kernel.h`, `linux/module.h`, `linux/init.h`, `linux/blkdev.h`, `linux/ata.h`, `linux/libata.h`, `linux/adb.h`, `linux/pmu.h`.
- Detected declarations: `struct pata_macio_timing`, `struct pata_macio_priv`, `struct pata_macio_timing`, `function pata_macio_apply_timings`, `function pata_macio_dev_select`, `function pata_macio_set_timings`, `function pata_macio_default_timings`, `function pata_macio_cable_detect`, `function pata_macio_qc_prep`, `function pata_macio_freeze`.
- Atlas domain: Driver Families / drivers/ata.
- Implementation status: pattern 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.