vmw_legacy_srf_dma(9)

💖 vmw_legacy_srf_dma(9) 💖

okay so bestie, welcome to the Kernel API Manual — this page is all about vmw_legacy_srf_dma, and it is lowkey giving “copy the backup data, but make it legacy surface.” Buckle up. 🦋✨

NAME 🌸

vmw_legacy_srf_dma — copy backup data to or from a legacy surface. That's the name, that's the function, we love a clear icon. 💅

SYNOPSIS 🎀

int vmw_legacy_srf_dma (struct vmw_resource *res , struct
       ttm_validate_buffer *val_buf , bool bind );

ARGUMENTS 🫶

• res — pointer to a struct vmw_res that's embedded in a struct vmw_surface. Cute nesting, no cap. 🪆
• val_buf — pointer to a struct ttm_validate_buffer holding the info about the backup buffer. It's the backup buffer's little info card. 💌
• bind — a Boolean for wether to DMA to the surface. (Yes, “wether” is in the original, we are not correcting the lore. 😭)

DESCRIPTION 🔥

So what does it actually do? It transfers backup data to or from a legacy surface as part of the validation process. Literally the main character of this page. 👑

Heads up though: it may return other errors if the kernel is out of guest resources. Not the slay we wanted, but okay. 💀

On successful completion, the backup buffer will be fenced or idle. And if the surface needs persistent backup storage, the backup buffer will also be returned reserved iff bind is true. (iff = if and only if, bestie — logic girlies know. 🧠✨)

SEE ALSO 🌈

First up, the kernel file: ./drivers/gpu/drm/vmwgfx/vmwgfx_surface.c.

Then the whole friend group:

• struct vmw_user_surface(9)
• struct vmw_surface_offset(9)
• struct vmw_surface_dirty(9)
• vmw_surface_dma_size(9)
• vmw_surface_define_size(9)
• vmw_surface_destroy_size(9)
• vmw_surface_destroy_encode(9)
• vmw_surface_define_encode(9)
• vmw_surface_dma_encode(9)
• vmw_hw_surface_destroy(9)
• vmw_legacy_srf_create(9)
• vmw_legacy_srf_bind(9)
• vmw_legacy_srf_unbind(9)
• vmw_legacy_srf_destroy(9)
• vmw_surface_init(9)
• vmw_user_surface_base_to_res(9)
• vmw_user_surface_free(9)
• vmw_user_surface_base_release(9)
• vmw_surface_destroy_ioctl(9)
• vmw_surface_define_ioctl(9)
• vmw_surface_reference_ioctl(9)
• vmw_gb_surface_create(9)
• vmw_gb_surface_define_ioctl(9)
• vmw_gb_surface_reference_ioctl(9)
• vmw_gb_surface_define_ext_ioctl(9)
• vmw_gb_surface_reference_ext_ioctl(9)
• vmw_gb_surface_define_internal(9)
• vmw_gb_surface_reference_internal(9)
• vmw_subres_dirty_add(9)
• vmw_subres_dirty_full(9)
• vmw_dumb_create(9)

made with 💖 and way too much surface-maintenance energy by your kernel bestie. this page came from ./drivers/gpu/drm/vmwgfx, dated October 2026, and the footer vibe is vmw_legacy_srf_dma(9) — periodt. 🎀👑