VFIO_GROUP_UNSET_CONTAINER(9)

🦋 VFIO_GROUP_UNSET_CONTAINER 🦋

Bestie, welcome to the Kernel API Manual entry for VFIO_GROUP_UNSET_CONTAINER — yes, the name is long, but it's giving iconic cleanup energy. 💅

✨ NAME ✨

It's literally VFIO_GROUP_UNSET_CONTAINER, and its whole identity is _IO(VFIO_TYPE, VFIO_BASE + 5). 🎀

💖 SYNOPSIS 💖

VFIO_GROUP_UNSET_CONTAINER

🌸 DESCRIPTION 🌸

Okay so what it does: it removes the group from the attached container. This is the opposite of the SET_CONTAINER call, and it returns the group to an initial state.

Before you call this interface, all device file descriptors must be released — no cap, that's a hard requirement. 🫶

When you're removing the last group from a container, the IOMMU will be disabled and all state lost, effectively also returning the VFIO file descriptor to an initial state. Big yikes if you weren't ready, but that's the vibe. 💀

🌈 RETURN 🌈

• 0 on success
• -errno on failure
• Availability: When attached to container

🔥 SEE ALSO 🔥

Kernel file: ./include/uapi/linux/vfio.h

• VFIO_GET_API_VERSION(9)
• VFIO_CHECK_EXTENSION(9)
• VFIO_SET_IOMMU(9)
• VFIO_GROUP_SET_CONTAINER(9)
• VFIO_GROUP_GET_DEVICE_FD(9)
• struct vfio_region_gfx_edid(9)
• VFIO_DEVICE_RESET(9)
• VFIO_DEVICE_GET_GFX_DMABUF(9)
• VFIO_IOMMU_SPAPR_UNREGISTER_MEMORY(9)

That's the whole page, bestie. It's sourced from ./include/uapi/linux, dated October 2026 — mwah, bye! 💋🫶