vmw_stdu_init(9)

🎀 NAME 🎀

okay so this is vmw_stdu_init(9) from the Kernel API Manual, and it’s the function that sets up a Screen Target Display Unit 💅

---

✨ SYNOPSIS ✨

int vmw_stdu_init (struct vmw_private *dev_priv , unsigned unit );

---

🌸 ARGUMENTS 🌸

• dev_priv — VMW DRM device, aka the device context you’re handing over 🫶
• unit — the unit number, range from 0 to VMWGFX_NUM_DISPLAY_UNITS ✨

---

🦋 DESCRIPTION 🦋

the way this works: this function is called once per CRTC, and it allocates one Screen Target display unit to represent that CRTC. Since the SVGA device does not separate out encoder and connector, they are represented as part of the STDU as well. no cap, that’s the whole setup 💖

---

🔥 RETURN 🔥

0 on success or -errno code on failure. slay when it’s zero, weep when it’s errno 😭

---

🔮 SEE ALSO 🔮

the kernel file is ./drivers/gpu/drm/vmwgfx/vmwgfx_stdu.c; struct vmw_stdu_dirty(9) (yes, exactly like that, bestie) and the rest of the squad:

• struct vmw_screen_target_display_unit(9)
• vmw_stdu_crtc_destroy(9)
• vmw_stdu_define_st(9)
• vmw_stdu_bind_st(9)
• vmw_stdu_populate_update(9)
• vmw_stdu_update_st(9)
• vmw_stdu_destroy_st(9)
• vmw_stdu_crtc_mode_set_nofb(9)
• vmw_stdu_bo_cpu_clip(9)
• vmw_stdu_bo_cpu_commit(9)
• vmw_kms_stdu_readback(9)
• vmw_kms_stdu_surface_clip(9)
• vmw_kms_stdu_surface_fifo_commit(9)
• vmw_kms_stdu_surface_dirty(9)
• vmw_stdu_encoder_destroy(9)
• vmw_stdu_connector_destroy(9)
• vmw_stdu_primary_plane_cleanup_fb(9)
• vmw_stdu_primary_plane_prepare_fb(9)
• vmw_stdu_plane_update_bo(9)
• vmw_stdu_plane_update_surface(9)
• vmw_stdu_primary_plane_atomic_update(9)
• vmw_stdu_destroy(9)
• vmw_kms_stdu_init_display(9)

---

okay that’s the tea ☕ — source/version ./drivers/gpu/drm/vmwgfx, dated October 2026, for vmw_stdu_init(9). bye bestie, go set up those Screen Target Display Units 💖🦋