drivers/parport/parport_ip32.c

File Facts

System

Linux kernel

Corpus path

drivers/parport/parport_ip32.c

Extension

.c

Size

67732 bytes

Lines

2227

Domain

Driver Families

Bucket

drivers/parport

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.
• 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/completion.h
• linux/delay.h
• linux/dma-mapping.h
• linux/err.h
• linux/init.h
• linux/interrupt.h
• linux/jiffies.h
• linux/kernel.h
• linux/module.h
• linux/parport.h
• linux/sched/signal.h
• linux/slab.h
• linux/spinlock.h
• linux/stddef.h
• linux/types.h
• asm/io.h
• asm/ip32/ip32_ints.h
• asm/ip32/mace.h

Detected Declarations

• struct parport_ip32_regs
• struct parport_ip32_private
• struct parport_ip32_dma_data
• enum parport_ip32_irq_mode
• function parport_ip32_dump_state
• function parport_ip32_dma_setup_context
• function parport_ip32_dma_interrupt
• function parport_ip32_merr_interrupt
• function parport_ip32_dma_start
• function parport_ip32_dma_start
• function parport_ip32_dma_get_residue
• function parport_ip32_dma_register
• function parport_ip32_dma_unregister
• function parport_ip32_wakeup
• function parport_ip32_interrupt
• function parport_ip32_read_econtrol
• function parport_ip32_write_econtrol
• function parport_ip32_frob_econtrol
• function state
• function parport_ip32_read_data
• function parport_ip32_write_data
• function parport_ip32_read_status
• function __parport_ip32_read_control
• function __parport_ip32_write_control
• function __parport_ip32_frob_control
• function parport_ip32_read_control
• function parport_ip32_write_control
• function __parport_ip32_frob_control
• function parport_ip32_disable_irq
• function parport_ip32_enable_irq
• function parport_ip32_data_forward
• function parport_ip32_data_reverse
• function parport_ip32_init_state
• function parport_ip32_save_state
• function parport_ip32_restore_state
• function parport_ip32_clear_epp_timeout
• function parport_ip32_epp_read
• function parport_ip32_epp_write
• function parport_ip32_epp_read_data
• function parport_ip32_epp_write_data
• function parport_ip32_epp_read_addr
• function parport_ip32_epp_write_addr
• function cond_resched
• function parport_ip32_fwp_wait_polling
• function parport_ip32_fwp_wait_interrupt
• function parport_ip32_fifo_write_block_pio
• function parport_ip32_fifo_write_block_dma
• function parport_ip32_fifo_write_block

Annotated Snippet

module_init(parport_ip32_init);
module_exit(parport_ip32_exit);

module_param(verbose_probing, bool, S_IRUGO);
MODULE_PARM_DESC(verbose_probing, "Log chit-chat during initialization");

module_param(features, uint, S_IRUGO);
MODULE_PARM_DESC(features,
		 "Bit mask of features to enable"
		 ", bit 0: IRQ support"
		 ", bit 1: DMA support"
		 ", bit 2: hardware SPP mode"
		 ", bit 3: hardware EPP mode"
		 ", bit 4: hardware ECP mode");

Annotation

• Immediate include surface: `linux/completion.h`, `linux/delay.h`, `linux/dma-mapping.h`, `linux/err.h`, `linux/init.h`, `linux/interrupt.h`, `linux/jiffies.h`, `linux/kernel.h`.
• Detected declarations: `struct parport_ip32_regs`, `struct parport_ip32_private`, `struct parport_ip32_dma_data`, `enum parport_ip32_irq_mode`, `function parport_ip32_dump_state`, `function parport_ip32_dma_setup_context`, `function parport_ip32_dma_interrupt`, `function parport_ip32_merr_interrupt`, `function parport_ip32_dma_start`, `function parport_ip32_dma_start`.
• Atlas domain: Driver Families / drivers/parport.
• Implementation status: integration 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.