vmw_bo_pin_in_vram_or_gmr(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’– vmw_bo_pin_in_vram_or_gmr(9) β€” the "put this buffer in vram or gmr" moment πŸ’–

Okay bestie, welcome to the Kernel API Manual entry for vmw_bo_pin_in_vram_or_gmr. Yes that's a mouthful, but it's literally just a helper that moves a buffer over to vram or gmr, and we're gonna get through it together 🫢


✨ NAME ✨

vmw_bo_pin_in_vram_or_gmr β€” Move a buffer to vram or gmr. That's the whole vibe. No cap.


🌈 SYNOPSIS 🌈

int vmw_bo_pin_in_vram_or_gmr (struct vmw_private *dev_priv , struct
       vmw_bo *buf , bool interruptible );

Look at that signature slaying exactly as written. Don't touch it, don't "fix" the spacing, just appreciate it πŸ’…


πŸŽ€ ARGUMENTS πŸŽ€

  • dev_priv β€” Driver private. It's the driver's own little private stash, iykyk.
  • buf β€” DMA buffer to move. The actual buffer being moved, main character energy fr.
  • interruptible β€” Use interruptible wait. Set this and the wait is interruptible; that's the whole thing πŸ‘‘

πŸ¦‹ DESCRIPTION πŸ¦‹

So here's what happens, bestie: this function takes the reservation_sem in write mode. Yeah. Write mode. It's not playing around.

Then it flushes and unpins the query bo to avoid failures. That's it, that's the description β€” flushes it, unpins it, avoids the failures, periodt ✨


🌸 RETURN 🌸

  • Zero on success β€” slay πŸ’–
  • Negative error code on failure.
  • In particular -ERESTARTSYS if it gets interrupted by a signal 😭 that's the one to remember.

πŸ”₯ SEE ALSO πŸ”₯

Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_bo.c β€” and all of these icons, because the kernel is one big friend group:


And that's the whole page, bestie 🧚 This cutie came from the kernel source tree at ./drivers/gpu/drm/vmwgfx, dated October 2026, and it's part of the Kernel API Manual. Go forth and pin responsibly πŸ’œπŸ‘‘

πŸ“¦ where this page comes from