vmw_bo_unpin(9)

📦 version 7.3.1, in nixpkgs unstable

💅 vmw_bo_unpin(9) — like, the Kernel API Manual page you didn't know you needed 🎀

okay so bestie, welcome to the ✨ vmw_bo_unpin(9) ✨ glow-up. this is a kernel API manual page, and yes it's short, but it's iconic and we're gonna treat it with the respect it deserves. it's giving "small but mighty". 🦋

🌸 NAME 🌸

vmw_bo_unpin — unpins the buffer that you handed it. that's it. that's the whole vibe. it does not move the buffer, periodt. no cap, the buffer stays exactly where it is, we're just releasing the pin. 💅

✨ SYNOPSIS ✨

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

it returns an int, bestie. keep that in mind for the RETURN section, okay? 👀

🫶 ARGUMENTS 🫶

  • dev_priv — the driver private. like, your driver's whole personality and private data, passed in as struct vmw_private *. literally the main character of the argument list. 👑
  • buf — the DMA buffer to unpin. this is the one getting unpinned. struct vmw_bo *. so sorry to it, but its pinning era is over. 💀
  • interruptible — a bool, and it means "use interruptible wait." so if you set it, the wait is interruptible. that's the whole deal. 🎀

🧚 DESCRIPTION 🧚

okay so here's what's happening under the hood, iykyk: this function takes the reservation_sem in write mode. that's it. that's literally the description of the function. it takes the reservation_sem in write mode. no more, no less. slay. ✨🔥

🌈 RETURN 🌈

  • Zero on success. 🎉 zero is the goal, zero is the dream, zero means we ate. 💖
  • Negative error code on failure. 😭
  • in particular, -ERESTARTSYS if it got interrupted by a signal. that's the specific one you gotta watch for, bestie. so if interruptible is doing its thing and a signal comes through, boom, -ERESTARTSYS. fr fr. 💀

⭐ SEE ALSO ⭐

okay so the source lives at the kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_bo.c — that's where all this magic is written, bestie. 🫶 and here's the whole friend group of related functions, all of them, every single one, no skipping:

that's the whole group chat. go say hi. 💬💜

🎀 tiny reminder bestie: vmw_bo_unpin unpins the buffer given — it does not move it. don't go expecting any movement. it's not that kind of function. 🙈

and that's a wrap, bestie! 🦋 this page is brought to you by the source ./drivers/gpu/drm/vmwgfx, dated October 2026 — so mark your calendars, mwah 💋👑, and remember: every option, every arg, every return code stays exactly the same, only the vibe got a glow-up. periodt. 💅✨

📦 where this page comes from