vmw_kms_update_layout_ioctl(9)

💖 vmw_kms_update_layout_ioctl(9) — Kernel API Manual 💖

okay bestie, welcome to the group chat for the DRM_VMW_UPDATE_LAYOUT ioctl handler. this is the function that handles that call, and yes it's a whole vibe ✨

---

✨ NAME ✨

vmw_kms_update_layout_ioctl — it's literally the handler for the DRM_VMW_UPDATE_LAYOUT ioctl 💅

---

🎀 SYNOPSIS 🎀

int vmw_kms_update_layout_ioctl (struct drm_device *dev , void *data ,
struct drm_file *file_priv );

---

🦋 ARGUMENTS 🦋

• dev — the drm device this ioctl is running on 🖥️
• data — the data pointer for the ioctl, iykyk 📦
• file_priv — the drm file for the ioctl call 🗂️

---

🌸 DESCRIPTION 🌸

so what it does is update the preferred topology of the display unit to match whatever the ioctl request asked for. that's the whole assignment, no cap.

the topology comes in as an array of drm_vmw_rect, like this iconic little lineup:

[0 0 640 480] [640 0 800 600] [0 480 640 480]

---

👑 NOTE 👑

listen up because this part is important fr fr:

• the x and y offset (upper left) in drm_vmw_rect cannot be less than 0 🙅‍♀️
• besides the device limit on topology, x + w and y + h (lower right) cannot be greater than INT_MAX 😭

so if the topology goes beyond those limits, it comes back with an error. no slay, just nope.

---

🔥 RETURN 🔥

• 0 on success — we love a win 💖
• negative errno on failure — it's giving error, unfortunately 💀

---

🌈 SEE ALSO 🌈

the kernel file lives at ./drivers/gpu/drm/vmwgfx/vmwgfx_kms.c — go read it if you're feeling curious 🧚

and here's the whole bestie list of related functions, every single one:

• vmw_du_plane_unpin_surf(9)
• vmw_du_plane_cleanup_fb(9)
• vmw_du_primary_plane_atomic_check(9)
• vmw_du_crtc_duplicate_state(9)
• vmw_du_crtc_reset(9)
• vmw_du_crtc_destroy_state(9)
• vmw_du_plane_duplicate_state(9)
• vmw_du_plane_reset(9)
• vmw_du_plane_destroy_state(9)
• vmw_du_connector_duplicate_state(9)
• vmw_du_connector_reset(9)
• vmw_du_connector_destroy_state(9)
• vmw_kms_readback(9)
• vmw_kms_srf_ok(9)
• vmw_kms_new_framebuffer(9)
• vmw_kms_check_display_memory(9)
• vmw_crtc_state_and_lock(9)
• vmw_kms_check_implicit(9)
• vmw_kms_check_topology(9)
• vmw_kms_atomic_check_modeset(9)
• vmw_du_update_layout(9)
• vmw_guess_mode_timing(9)
• vmw_kms_helper_dirty(9)
• vmw_kms_helper_validation_finish(9)
• vmw_kms_create_implicit_placement_property(9)
• vmw_kms_suspend(9)
• vmw_kms_resume(9)
• vmw_kms_lost_device(9)
• vmw_du_helper_plane_update(9)
• vmw_connector_mode_valid(9)
• vmw_connector_get_modes(9)

---

and that's the page, bestie 🫶 this cutie came from ./drivers/gpu/drm/vmwgfx, dated October 2026 — periodt 💜