vmw_kms_srf_ok(9)

💅 vmw_kms_srf_ok — the vibe check for surfaces

okay bestie, so we're in the Kernel API Manual today (yes, the Kernel API Manual, we're fancy now 🎀), and this little function is literally just a bouncer at the club door for surfaces. That's it. That's the whole job. Let's get into it ✨

---

🌸 SYNOPSIS 🌸

bool vmw_kms_srf_ok (struct vmw_private *dev_priv , uint32_t width ,
       uint32_t height );

she returns a bool, she takes three things, she's lowkey iconic for how unbothered she is 💜

---

🦋 ARGUMENTS 🦋

• dev_priv — a pointer to the device private struct, aka the VIP list she's checking things against 🫶
• width — the width you're requesting, like when you ask for a table at a restaurant that's already full 😭
• height — the height you're requesting, same energy, same dramatics

---

⭐ DESCRIPTION ⭐

So here's the tea: surfaces need to be less than texture size. That's the whole rule. That's the sacred text. If your surface is too big it simply does not pass the vibe check, sorry not sorry 🙈

no cap, that's genuinely the entire description — she's a small function with a big heart 💖

---

👑 SEE ALSO 👑

First up, the actual source file, hold onto it:

• Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_kms.c

and then, bestie, the friend group. It's a big friend group. Genuinely enormous. We're listing every single one because they all deserve their moment 🌈

• 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_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_update_layout_ioctl(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)

like I said. huge friend group. every single one a main character 👑

---

🍓 reminder bestie: this page lives in ./drivers/gpu/drm/vmwgfx, and it's dated October 2026 — so yes, we're reading the future's manpage, and it's still called vmw_kms_srf_ok(9). slay 💅✨ see you in the next one! 🧚‍♀️💜