drivers/gpu/drm/virtio/virtgpu_drv.h
Source file repositories/reference/linux-study-clean/drivers/gpu/drm/virtio/virtgpu_drv.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/gpu/drm/virtio/virtgpu_drv.h- Extension
.h- Size
- 16666 bytes
- Lines
- 521
- 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/dma-direction.hlinux/virtio.hlinux/virtio_ids.hlinux/virtio_config.hlinux/virtio_gpu.hdrm/drm_atomic.hdrm/drm_drv.hdrm/drm_encoder.hdrm/drm_fourcc.hdrm/drm_framebuffer.hdrm/drm_gem.hdrm/drm_gem_shmem_helper.hdrm/drm_ioctl.hdrm/drm_probe_helper.hdrm/virtgpu_drm.h
Detected Declarations
struct virtio_gpu_object_paramsstruct virtio_gpu_objectstruct virtio_gpu_object_shmemstruct virtio_gpu_object_vramstruct virtio_gpu_object_arraystruct virtio_gpu_vbufferstruct virtio_gpu_devicestruct virtio_gpu_fence_driverstruct virtio_gpu_fence_eventstruct virtio_gpu_fencestruct virtio_gpu_vbufferstruct virtio_gpu_outputstruct virtio_gpu_framebufferstruct virtio_gpu_plane_statestruct virtio_gpu_queuestruct virtio_gpu_drv_capsetstruct virtio_gpu_drv_cap_cachestruct virtio_gpu_devicestruct virtio_gpu_fpriv
Annotated Snippet
struct virtio_gpu_object_params {
unsigned long size;
bool dumb;
/* 3d */
bool virgl;
bool blob;
/* classic resources only */
uint32_t format;
uint32_t width;
uint32_t height;
uint32_t target;
uint32_t bind;
uint32_t depth;
uint32_t array_size;
uint32_t last_level;
uint32_t nr_samples;
uint32_t flags;
/* blob resources only */
uint32_t ctx_id;
uint32_t blob_mem;
uint32_t blob_flags;
uint64_t blob_id;
uint32_t blob_hints;
};
struct virtio_gpu_object {
struct drm_gem_shmem_object base;
struct sg_table *sgt;
uint32_t hw_res_handle;
bool dumb;
bool created;
bool attached;
bool host3d_blob, guest_blob;
uint32_t blob_mem, blob_flags;
int uuid_state;
uuid_t uuid;
};
#define gem_to_virtio_gpu_obj(gobj) \
container_of((gobj), struct virtio_gpu_object, base.base)
struct virtio_gpu_object_shmem {
struct virtio_gpu_object base;
};
struct virtio_gpu_object_vram {
struct virtio_gpu_object base;
uint32_t map_state;
uint32_t map_info;
struct drm_mm_node vram_node;
};
#define to_virtio_gpu_shmem(virtio_gpu_object) \
container_of((virtio_gpu_object), struct virtio_gpu_object_shmem, base)
#define to_virtio_gpu_vram(virtio_gpu_object) \
container_of((virtio_gpu_object), struct virtio_gpu_object_vram, base)
struct virtio_gpu_object_array {
struct ww_acquire_ctx ticket;
struct list_head next;
u32 nents, total;
struct drm_gem_object *objs[] __counted_by(total);
};
struct virtio_gpu_vbuffer;
struct virtio_gpu_device;
typedef void (*virtio_gpu_resp_cb)(struct virtio_gpu_device *vgdev,
struct virtio_gpu_vbuffer *vbuf);
struct virtio_gpu_fence_driver {
atomic64_t last_fence_id;
uint64_t current_fence_id;
uint64_t context;
struct list_head fences;
spinlock_t lock;
};
struct virtio_gpu_fence_event {
struct drm_pending_event base;
struct drm_event event;
};
struct virtio_gpu_fence {
struct dma_fence f;
uint32_t ring_idx;
uint64_t fence_id;
Annotation
- Immediate include surface: `linux/dma-direction.h`, `linux/virtio.h`, `linux/virtio_ids.h`, `linux/virtio_config.h`, `linux/virtio_gpu.h`, `drm/drm_atomic.h`, `drm/drm_drv.h`, `drm/drm_encoder.h`.
- Detected declarations: `struct virtio_gpu_object_params`, `struct virtio_gpu_object`, `struct virtio_gpu_object_shmem`, `struct virtio_gpu_object_vram`, `struct virtio_gpu_object_array`, `struct virtio_gpu_vbuffer`, `struct virtio_gpu_device`, `struct virtio_gpu_fence_driver`, `struct virtio_gpu_fence_event`, `struct virtio_gpu_fence`.
- 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.