drivers/pci/hotplug/pnv_php.c

File Facts

System

Linux kernel

Corpus path

drivers/pci/hotplug/pnv_php.c

Extension

.c

Size

31153 bytes

Lines

1247

Domain

Representative Device Path

Bucket

PCIe NVMe Storage Path

Inferred role

Representative Device Path: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

Part of the selected hardware vertical slice: PCI discovery, driver binding, NVMe queues, block requests, DMA, interrupts, and completion.

• Part of the selected hardware vertical slice: PCI discovery, driver binding, NVMe queues, block requests, DMA, interrupts, and completion.
• 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/bitfield.h
• linux/libfdt.h
• linux/module.h
• linux/pci.h
• linux/delay.h
• linux/pci_hotplug.h
• linux/of_fdt.h
• asm/opal.h
• asm/pnv-pci.h
• asm/ppc-pci.h

Detected Declarations

• struct pnv_php_event
• function pnv_php_disable_irq
• function pnv_php_free_slot
• function pnv_php_put_slot
• function list_for_each_entry
• function pnv_php_rmv_pdns
• function for_each_child_of_node
• function of_node_release
• function for_each_child_of_node
• function pnv_php_rmv_devtree
• function pnv_php_reverse_nodes
• function pnv_php_populate_changeset
• function for_each_child_of_node_scoped
• function pnv_php_add_pdns
• function pnv_php_add_devtree
• function pnv_php_set_slot_power_state
• function pnv_php_get_power_state
• function pcie_check_link_active
• function pnv_php_get_adapter_state
• function pnv_php_get_raw_indicator_status
• function pnv_php_get_attention_state
• function pnv_php_set_attention_state
• function pnv_php_activate_slot
• function pnv_php_enable
• function pnv_php_reset_slot
• function pnv_php_enable_slot
• function pnv_php_disable_all_irqs
• function pnv_php_disable_all_downstream_irqs
• function pnv_php_disable_slot
• function pnv_php_release
• function pnv_php_register_slot
• function pnv_php_enable_msix
• function pnv_php_detect_clear_suprise_removal_freeze
• function pnv_php_event_handler
• function pnv_php_interrupt
• function pnv_php_init_irq
• function pnv_php_enable_irq
• function pnv_php_register_one
• function pnv_php_register
• function pnv_php_unregister_one
• function pnv_php_unregister
• function pnv_php_init
• function pnv_php_exit
• module init pnv_php_init
• export pnv_php_find_slot
• export pnv_php_set_slot_power_state

Annotated Snippet

module_init(pnv_php_init);
module_exit(pnv_php_exit);

MODULE_VERSION(DRIVER_VERSION);
MODULE_LICENSE("GPL v2");
MODULE_AUTHOR(DRIVER_AUTHOR);
MODULE_DESCRIPTION(DRIVER_DESC);

Annotation

• Immediate include surface: `linux/bitfield.h`, `linux/libfdt.h`, `linux/module.h`, `linux/pci.h`, `linux/delay.h`, `linux/pci_hotplug.h`, `linux/of_fdt.h`, `asm/opal.h`.
• Detected declarations: `struct pnv_php_event`, `function pnv_php_disable_irq`, `function pnv_php_free_slot`, `function pnv_php_put_slot`, `function list_for_each_entry`, `function pnv_php_rmv_pdns`, `function for_each_child_of_node`, `function of_node_release`, `function for_each_child_of_node`, `function pnv_php_rmv_devtree`.
• Atlas domain: Representative Device Path / PCIe NVMe Storage Path.
• 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.