drivers/gpu/drm/vboxvideo/vbox_drv.h
Source file repositories/reference/linux-study-clean/drivers/gpu/drm/vboxvideo/vbox_drv.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/gpu/drm/vboxvideo/vbox_drv.h- Extension
.h- Size
- 4708 bytes
- Lines
- 160
- 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.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/genalloc.hlinux/io.hlinux/irqreturn.hlinux/string.hdrm/drm_encoder.hdrm/drm_gem.hdrm/drm_gem_vram_helper.hvboxvideo_guest.hvboxvideo_vbe.hhgsmi_ch_setup.h
Detected Declarations
struct vbox_privatestruct vbox_connectorstruct vbox_crtcstruct vbox_encoderfunction vbox_write_ioport
Annotated Snippet
struct vbox_private {
/* Must be first; or we must define our own release callback */
struct drm_device ddev;
u8 __iomem *guest_heap;
u8 __iomem *vbva_buffers;
struct gen_pool *guest_pool;
struct vbva_buf_ctx *vbva_info;
bool any_pitch;
u32 num_crtcs;
/* Amount of available VRAM, including space used for buffers. */
u32 full_vram_size;
/* Amount of available VRAM, not including space used for buffers. */
u32 available_vram_size;
/* Array of structures for receiving mode hints. */
struct vbva_modehint *last_mode_hints;
int fb_mtrr;
struct mutex hw_mutex; /* protects modeset and accel/vbva accesses */
struct work_struct hotplug_work;
u32 input_mapping_width;
u32 input_mapping_height;
/*
* Is user-space using an X.Org-style layout of one large frame-buffer
* encompassing all screen ones or is the fbdev console active?
*/
bool single_framebuffer;
u8 cursor_data[CURSOR_DATA_SIZE];
};
#undef CURSOR_PIXEL_COUNT
#undef CURSOR_DATA_SIZE
struct vbox_connector {
struct drm_connector base;
char name[32];
struct vbox_crtc *vbox_crtc;
struct {
u32 width;
u32 height;
bool disconnected;
} mode_hint;
};
struct vbox_crtc {
struct drm_crtc base;
bool disconnected;
unsigned int crtc_id;
u32 fb_offset;
bool cursor_enabled;
u32 x_hint;
u32 y_hint;
/*
* When setting a mode we not only pass the mode to the hypervisor,
* but also information on how to map / translate input coordinates
* for the emulated USB tablet. This input-mapping may change when
* the mode on *another* crtc changes.
*
* This means that sometimes we must do a modeset on other crtc-s then
* the one being changed to update the input-mapping. Including crtc-s
* which may be disabled inside the guest (shown as a black window
* on the host unless closed by the user).
*
* With atomic modesetting the mode-info of disabled crtcs gets zeroed
* yet we need it when updating the input-map to avoid resizing the
* window as a side effect of a mode_set on another crtc. Therefor we
* cache the info of the last mode below.
*/
u32 width;
u32 height;
u32 x;
u32 y;
};
struct vbox_encoder {
struct drm_encoder base;
};
#define to_vbox_crtc(x) container_of(x, struct vbox_crtc, base)
#define to_vbox_connector(x) container_of(x, struct vbox_connector, base)
#define to_vbox_encoder(x) container_of(x, struct vbox_encoder, base)
#define to_vbox_dev(x) container_of(x, struct vbox_private, ddev)
bool vbox_check_supported(u16 id);
int vbox_hw_init(struct vbox_private *vbox);
void vbox_hw_fini(struct vbox_private *vbox);
int vbox_mode_init(struct vbox_private *vbox);
void vbox_mode_fini(struct vbox_private *vbox);
Annotation
- Immediate include surface: `linux/genalloc.h`, `linux/io.h`, `linux/irqreturn.h`, `linux/string.h`, `drm/drm_encoder.h`, `drm/drm_gem.h`, `drm/drm_gem_vram_helper.h`, `vboxvideo_guest.h`.
- Detected declarations: `struct vbox_private`, `struct vbox_connector`, `struct vbox_crtc`, `struct vbox_encoder`, `function vbox_write_ioport`.
- Atlas domain: Driver Families / drivers/gpu.
- Implementation status: source 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.