drivers/gpu/drm/i915/i915_gpu_error.h
Source file repositories/reference/linux-study-clean/drivers/gpu/drm/i915/i915_gpu_error.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/gpu/drm/i915/i915_gpu_error.h- Extension
.h- Size
- 9121 bytes
- Lines
- 424
- 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.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/atomic.hlinux/kref.hlinux/ktime.hlinux/sched.hdrm/drm_mm.hgt/intel_engine.hgt/intel_engine_types.hgt/intel_gt_types.hgt/uc/intel_uc_fw.hintel_device_info.hi915_gem.hi915_gem_gtt.hi915_params.hi915_scheduler.h
Detected Declarations
struct drm_i915_privatestruct i915_vma_compressstruct intel_engine_capture_vmastruct intel_display_snapshotstruct i915_vma_coredumpstruct i915_request_coredumpstruct __guc_capture_parsed_outputstruct intel_engine_coredumpstruct i915_gem_context_coredumpstruct intel_ctb_coredumpstruct intel_gt_coredumpstruct intel_uc_coredumpstruct guc_infostruct i915_gpu_coredumpstruct i915_gpu_errorstruct drm_i915_error_state_buffunction i915_reset_countfunction i915_reset_engine_countfunction i915_increase_reset_engine_countfunction intel_klog_error_capturefunction i915_gpu_coredump_getfunction i915_gpu_coredump_putfunction i915_error_printffunction intel_gt_coredump_allocfunction intel_engine_coredump_allocfunction intel_engine_coredump_add_requestfunction intel_engine_coredump_add_vmafunction i915_vma_capture_finish
Annotated Snippet
struct i915_vma_coredump {
struct i915_vma_coredump *next;
char name[20];
u64 gtt_offset;
u64 gtt_size;
u32 gtt_page_sizes;
int unused;
struct list_head page_list;
};
struct i915_request_coredump {
unsigned long flags;
pid_t pid;
u32 context;
u32 seqno;
u32 head;
u32 tail;
struct i915_sched_attr sched_attr;
};
struct __guc_capture_parsed_output;
struct intel_engine_coredump {
const struct intel_engine_cs *engine;
bool hung;
bool simulated;
u32 reset_count;
/* position of active request inside the ring */
u32 rq_head, rq_post, rq_tail;
/* Register state */
u32 ccid;
u32 start;
u32 tail;
u32 head;
u32 ctl;
u32 mode;
u32 hws;
u32 ipeir;
u32 ipehr;
u32 esr;
u32 bbstate;
u32 instpm;
u32 instps;
u64 bbaddr;
u64 acthd;
u32 fault_reg;
u64 faddr;
u32 rc_psmi; /* sleep state */
u32 nopid;
u32 excc;
u32 cmd_cctl;
u32 cscmdop;
u32 ctx_sr_ctl;
u32 dma_faddr_hi;
u32 dma_faddr_lo;
struct intel_instdone instdone;
/* GuC matched capture-lists info */
struct intel_guc_state_capture *guc_capture;
struct __guc_capture_parsed_output *guc_capture_node;
struct i915_gem_context_coredump {
char comm[TASK_COMM_LEN];
u64 total_runtime;
u64 avg_runtime;
pid_t pid;
int active;
int guilty;
struct i915_sched_attr sched_attr;
u32 hwsp_seqno;
} context;
struct i915_vma_coredump *vma;
struct i915_request_coredump execlist[EXECLIST_MAX_PORTS];
unsigned int num_ports;
struct {
u32 gfx_mode;
union {
u64 pdp[4];
u32 pp_dir_base;
Annotation
- Immediate include surface: `linux/atomic.h`, `linux/kref.h`, `linux/ktime.h`, `linux/sched.h`, `drm/drm_mm.h`, `gt/intel_engine.h`, `gt/intel_engine_types.h`, `gt/intel_gt_types.h`.
- Detected declarations: `struct drm_i915_private`, `struct i915_vma_compress`, `struct intel_engine_capture_vma`, `struct intel_display_snapshot`, `struct i915_vma_coredump`, `struct i915_request_coredump`, `struct __guc_capture_parsed_output`, `struct intel_engine_coredump`, `struct i915_gem_context_coredump`, `struct intel_ctb_coredump`.
- 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.
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.