drivers/gpu/drm/nouveau/include/nvkm/core/intr.h

File Facts

System

Linux kernel

Corpus path

drivers/gpu/drm/nouveau/include/nvkm/core/intr.h

Extension

.h

Size

1997 bytes

Lines

74

Domain

Driver Families

Bucket

drivers/gpu

Inferred role

Driver Families: implementation source

Status

source 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.
• 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.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• core/os.h

Detected Declarations

• struct nvkm_device
• struct nvkm_subdev
• struct nvkm_intr
• struct nvkm_inth
• struct nvkm_inth
• enum nvkm_intr_prio
• enum nvkm_intr_type

Annotated Snippet

struct nvkm_intr {
	const struct nvkm_intr_func {
		bool (*pending)(struct nvkm_intr *);
		void (*unarm)(struct nvkm_intr *);
		void (*rearm)(struct nvkm_intr *);
		void (*block)(struct nvkm_intr *, int leaf, u32 mask);
		void (*allow)(struct nvkm_intr *, int leaf, u32 mask);
		void (*reset)(struct nvkm_intr *, int leaf, u32 mask);
	} *func;
	const struct nvkm_intr_data {
		int type; /* enum nvkm_subdev_type (+ve), enum nvkm_intr_type (-ve) */
		int inst;
		int leaf;
		u32 mask; /* 0-terminated. */
		bool legacy; /* auto-create "legacy" nvkm_subdev_intr() handler */
	} *data;

	struct nvkm_subdev *subdev;
	int leaves;
	u32 *stat;
	u32 *mask;

	struct list_head head;
};

void nvkm_intr_ctor(struct nvkm_device *);
void nvkm_intr_dtor(struct nvkm_device *);
int nvkm_intr_install(struct nvkm_device *);
void nvkm_intr_unarm(struct nvkm_device *);
void nvkm_intr_rearm(struct nvkm_device *);

int nvkm_intr_add(const struct nvkm_intr_func *, const struct nvkm_intr_data *,
		  struct nvkm_subdev *, int leaves, struct nvkm_intr *);
void nvkm_intr_block(struct nvkm_subdev *, enum nvkm_intr_type);
void nvkm_intr_allow(struct nvkm_subdev *, enum nvkm_intr_type);

struct nvkm_inth;
typedef irqreturn_t (*nvkm_inth_func)(struct nvkm_inth *);

struct nvkm_inth {
	struct nvkm_intr *intr;
	int leaf;
	u32 mask;
	nvkm_inth_func func;

	atomic_t allowed;

	struct list_head head;
};

int nvkm_inth_add(struct nvkm_intr *, enum nvkm_intr_type, enum nvkm_intr_prio,
		  struct nvkm_subdev *, nvkm_inth_func, struct nvkm_inth *);
void nvkm_inth_allow(struct nvkm_inth *);
void nvkm_inth_block(struct nvkm_inth *);
#endif

Annotation

• Immediate include surface: `core/os.h`.
• Detected declarations: `struct nvkm_device`, `struct nvkm_subdev`, `struct nvkm_intr`, `struct nvkm_inth`, `struct nvkm_inth`, `enum nvkm_intr_prio`, `enum nvkm_intr_type`.
• Atlas domain: Driver Families / drivers/gpu.
• Implementation status: source 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.