drivers/firmware/arm_ffa/driver.c

File Facts

System

Linux kernel

Corpus path

drivers/firmware/arm_ffa/driver.c

Extension

.c

Size

57234 bytes

Lines

2240

Domain

Driver Families

Bucket

drivers/firmware

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/acpi.h
• linux/arm_ffa.h
• linux/bitfield.h
• linux/cpuhotplug.h
• linux/delay.h
• linux/device.h
• linux/hashtable.h
• linux/interrupt.h
• linux/io.h
• linux/kernel.h
• linux/module.h
• linux/mm.h
• linux/mutex.h
• linux/of_irq.h
• linux/platform_device.h
• linux/scatterlist.h
• linux/slab.h
• linux/smp.h
• linux/uuid.h
• linux/xarray.h
• asm/virt.h
• common.h

Detected Declarations

• struct ffa_pcpu_irq
• struct ffa_drv_info
• struct ffa_partition_info_le
• struct ffa_notify_bitmaps
• struct ffa_dev_part_info
• struct notifier_cb_info
• enum notify_type
• function ffa_to_linux_errno
• function caller
• function ffa_version_check
• function invoke_ffa_fn
• function ffa_rx_release
• function invoke_ffa_fn
• function ffa_rxtx_map
• function invoke_ffa_fn
• function ffa_rxtx_unmap
• function invoke_ffa_fn
• function ffa_features
• function invoke_ffa_fn
• function __ffa_partition_info_get
• function __ffa_partition_info_get_regs
• function invoke_ffa_fn
• function ffa_partition_probe
• function ffa_id_get
• function invoke_ffa_fn
• function ffa_msg_send_wait_for_completion
• function invoke_ffa_fn
• function ffa_msg_send_direct_req
• function invoke_ffa_fn
• function ffa_msg_send2
• function ffa_msg_send_direct_req2
• function ffa_mem_first_frag
• function invoke_ffa_fn
• function ffa_mem_next_frag
• function invoke_ffa_fn
• function ffa_transmit_fragment
• function ffa_get_num_pages_sg
• function ffa_memory_attributes_get
• function ffa_emad_impdef_value_init
• function ffa_mem_region_additional_setup
• function ffa_setup_and_transmit
• function ffa_memory_ops
• function ffa_memory_reclaim
• function invoke_ffa_fn
• function ffa_notification_bitmap_create
• function invoke_ffa_fn
• function ffa_notification_bitmap_destroy
• function invoke_ffa_fn

Annotated Snippet

module_init(ffa_init);

static void __exit ffa_exit(void)
{
	platform_device_unregister(ffa_pdev);
	platform_driver_unregister(&ffa_driver);
}
module_exit(ffa_exit);

MODULE_ALIAS("arm-ffa");
MODULE_AUTHOR("Sudeep Holla <sudeep.holla@arm.com>");
MODULE_DESCRIPTION("Arm FF-A interface driver");
MODULE_LICENSE("GPL v2");

Annotation

• Immediate include surface: `linux/acpi.h`, `linux/arm_ffa.h`, `linux/bitfield.h`, `linux/cpuhotplug.h`, `linux/delay.h`, `linux/device.h`, `linux/hashtable.h`, `linux/interrupt.h`.
• Detected declarations: `struct ffa_pcpu_irq`, `struct ffa_drv_info`, `struct ffa_partition_info_le`, `struct ffa_notify_bitmaps`, `struct ffa_dev_part_info`, `struct notifier_cb_info`, `enum notify_type`, `function ffa_to_linux_errno`, `function caller`, `function ffa_version_check`.
• Atlas domain: Driver Families / drivers/firmware.
• 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.