include/linux/dma-map-ops.h

File Facts

System

Linux kernel

Corpus path

include/linux/dma-map-ops.h

Extension

.h

Size

14425 bytes

Lines

432

Domain

Core OS

Bucket

Core Kernel Interface

Inferred role

Core OS: operation-table or driver-model contract

Status

pattern implementation candidate

Why This File Exists

Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.

• Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
• Defines an operation table; this is where Linux turns generic core objects into subsystem-specific behavior.
• 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/dma-mapping.h
• linux/pgtable.h
• linux/slab.h
• asm/dma-mapping.h

Detected Declarations

• struct cma
• struct iommu_ops
• struct dma_map_ops
• function set_dma_ops
• function set_dma_ops
• function dma_contiguous_reserve
• function dma_release_from_contiguous
• function dma_free_contiguous
• function dma_declare_coherent_memory
• function dma_release_coherent_memory
• function dma_release_from_global_coherent
• function dma_mmap_from_global_coherent
• function dev_is_dma_coherent
• function dev_is_dma_coherent
• function dma_reset_need_sync
• function kmalloc
• function dma_kmalloc_size_aligned
• function kmalloc
• function dma_pgprot
• function arch_sync_dma_for_device
• function arch_sync_dma_for_cpu
• function arch_sync_dma_for_cpu_all
• function arch_dma_prep_coherent
• function arch_setup_dma_ops
• function arch_teardown_dma_ops
• function dma_debug_add_bus

Annotated Snippet

void dma_debug_add_bus(const struct bus_type *bus);
void debug_dma_dump_mappings(struct device *dev);
#else
static inline void dma_debug_add_bus(const struct bus_type *bus)
{
}
static inline void debug_dma_dump_mappings(struct device *dev)
{
}
#endif /* CONFIG_DMA_API_DEBUG */

extern const struct dma_map_ops dma_dummy_ops;
#endif /* _LINUX_DMA_MAP_OPS_H */

Annotation

• Immediate include surface: `linux/dma-mapping.h`, `linux/pgtable.h`, `linux/slab.h`, `asm/dma-mapping.h`.
• Detected declarations: `struct cma`, `struct iommu_ops`, `struct dma_map_ops`, `function set_dma_ops`, `function set_dma_ops`, `function dma_contiguous_reserve`, `function dma_release_from_contiguous`, `function dma_free_contiguous`, `function dma_declare_coherent_memory`, `function dma_release_coherent_memory`.
• Atlas domain: Core OS / Core Kernel Interface.
• Implementation status: pattern 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.