drivers/pci/endpoint/functions/pci-epf-ntb.c

File Facts

System

Linux kernel

Corpus path

drivers/pci/endpoint/functions/pci-epf-ntb.c

Extension

.c

Size

73251 bytes

Lines

2103

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.
• 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/delay.h
• linux/io.h
• linux/module.h
• linux/slab.h
• linux/pci-epc.h
• linux/pci-epf.h

Detected Declarations

• struct epf_ntb
• struct epf_ntb_epc
• struct epf_ntb_ctrl
• enum epf_ntb_bar
• function epf_ntb_link_up
• function epf_ntb_configure_mw
• function epf_ntb_teardown_mw
• function epf_ntb_configure_msi
• function epf_ntb_configure_msix
• function epf_ntb_configure_db
• function epf_ntb_teardown_db
• function epf_ntb_cmd_handler
• function epf_ntb_peer_spad_bar_clear
• function epf_ntb_peer_spad_bar_set
• function epf_ntb_config_sspad_bar_clear
• function epf_ntb_config_sspad_bar_set
• function epf_ntb_config_spad_bar_free
• function epf_ntb_config_spad_bar_alloc
• function epf_ntb_config_spad_bar_alloc_interface
• function epf_ntb_free_peer_mem
• function epf_ntb_db_mw_bar_clear
• function epf_ntb_db_mw_bar_cleanup
• function epf_ntb_configure_interrupt
• function epf_ntb_alloc_peer_mem
• function epf_ntb_db_mw_bar_init
• function epf_ntb_epc_create_interface
• function epf_ntb_epc_create
• function epf_ntb_init_epc_bar_interface
• function epf_ntb_init_epc_bar
• function epf_ntb_epc_init_interface
• function epf_ntb_epc_cleanup_interface
• function epf_ntb_epc_cleanup
• function epf_ntb_epc_init
• function epf_ntb_bind
• function epf_ntb_unbind
• function epf_ntb_num_mws_store
• function epf_ntb_add_cfs
• function epf_ntb_probe
• function epf_ntb_init
• function epf_ntb_exit
• module init epf_ntb_init

Annotated Snippet

module_init(epf_ntb_init);

static void __exit epf_ntb_exit(void)
{
	pci_epf_unregister_driver(&epf_ntb_driver);
	destroy_workqueue(kpcintb_workqueue);
}
module_exit(epf_ntb_exit);

MODULE_DESCRIPTION("PCI EPF NTB DRIVER");
MODULE_AUTHOR("Kishon Vijay Abraham I <kishon@ti.com>");
MODULE_LICENSE("GPL v2");

Annotation

• Immediate include surface: `linux/delay.h`, `linux/io.h`, `linux/module.h`, `linux/slab.h`, `linux/pci-epc.h`, `linux/pci-epf.h`.
• Detected declarations: `struct epf_ntb`, `struct epf_ntb_epc`, `struct epf_ntb_ctrl`, `enum epf_ntb_bar`, `function epf_ntb_link_up`, `function epf_ntb_configure_mw`, `function epf_ntb_teardown_mw`, `function epf_ntb_configure_msi`, `function epf_ntb_configure_msix`, `function epf_ntb_configure_db`.
• Atlas domain: Representative Device Path / PCIe NVMe Storage Path.
• Implementation status: integration 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.