include/drm/drm_gem_dma_helper.h

File Facts

System

Linux kernel

Corpus path

include/drm/drm_gem_dma_helper.h

Extension

.h

Size

9516 bytes

Lines

275

Domain

Repository Root And Misc

Bucket

include

Inferred role

Repository Root And Misc: operation-table or driver-model contract

Status

pattern implementation candidate

Why This File Exists

Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.

• Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.
• Defines an operation table; this is where Linux turns generic core objects into subsystem-specific behavior.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• drm/drm_file.h
• drm/drm_ioctl.h
• drm/drm_gem.h

Detected Declarations

• struct drm_mode_create_dumb
• struct drm_gem_dma_object
• function drm_gem_dma_free_object
• function drm_gem_dma_object_print_info
• function drm_gem_dma_get_sg_table
• function drm_gem_dma_vmap
• function drm_gem_dma_mmap

Annotated Snippet

* This macro autogenerates a suitable &struct file_operations for DMA based
 * drivers, which can be assigned to &drm_driver.fops. Note that this structure
 * cannot be shared between drivers, because it contains a reference to the
 * current module using THIS_MODULE.
 *
 * Note that the declaration is already marked as static - if you need a
 * non-static version of this you're probably doing it wrong and will break the
 * THIS_MODULE reference by accident.
 */
#define DEFINE_DRM_GEM_DMA_FOPS(name) \
	static const struct file_operations name = {\
		.owner		= THIS_MODULE,\
		.open		= drm_open,\
		.release	= drm_release,\
		.unlocked_ioctl	= drm_ioctl,\
		.compat_ioctl	= drm_compat_ioctl,\
		.poll		= drm_poll,\
		.read		= drm_read,\
		.llseek		= noop_llseek,\
		.mmap		= drm_gem_mmap,\
		.fop_flags = FOP_UNSIGNED_OFFSET, \
		DRM_GEM_DMA_UNMAPPED_AREA_FOPS \
	}

#endif /* __DRM_GEM_DMA_HELPER_H__ */

Annotation

• Immediate include surface: `drm/drm_file.h`, `drm/drm_ioctl.h`, `drm/drm_gem.h`.
• Detected declarations: `struct drm_mode_create_dumb`, `struct drm_gem_dma_object`, `function drm_gem_dma_free_object`, `function drm_gem_dma_object_print_info`, `function drm_gem_dma_get_sg_table`, `function drm_gem_dma_vmap`, `function drm_gem_dma_mmap`.
• Atlas domain: Repository Root And Misc / include.
• Implementation status: pattern implementation candidate.

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.