STRUCT VDUSE_DEV_REQUEST(9)

💜 struct vduse_dev_request(9) — the control request glow-up ✨

okay bestie, welcome to the Kernel API Manual page for struct vduse_dev_request(9) — yes it's a control request, and yes it's lowkey iconic. buckle up 🎀

---

🌸 NAME 🌸

struct vduse_dev_request — the control request struct, fr fr 💅

---

✨ SYNOPSIS ✨

struct vduse_dev_request {
    __u32 type;
    __u32 request_id;
    __u32 reserved[4];
    union {
      struct vduse_vq_state vq_state;
      struct vduse_dev_status s;
      struct vduse_iova_range iova;
      struct vduse_iova_range_v2 iova_v2;
      struct vduse_vq_group_asid vq_group_asid;
      struct vduse_vq_ready vq_ready;
      __u32 padding[32];
    };
 };

like, look at that union bestie, it's giving choose your own adventure 🦋 nothing was copy-pasted here, every field is exactly where it belongs ✨

---

🫶 Members 🫶

• type — the request type, iykyk 💫
• request_id — the request id, so you know which one's which 🎀
• reserved — reserved for future use, aka it's literally just vibing and waiting its turn 🙈
• {unnamed_union} — an anonymous union, no name, no cap, main character energy 👑
• vq_state — the virtqueue state, but heads up: only the index field is available ⭐
• s — the device status 💅
• iova — the IOVA range for updating 🌸
• iova_v2 — the IOVA range for updating if API_VERSION >= 1 🔥 (read that conditional carefully bestie, it's load-bearing)
• vq_group_asid — the ASID of a virtqueue group 🦋
• vq_ready — the virtqueue ready request ✅
• padding — padding, that's it, that's the whole job 💀

---

🌈 Description 🌈

this structure is the one used by read(2) on /dev/vduse/$NAME. periodt. that's the whole description, don't @ me 🧚

ngl, $NAME is a placeholder there — copy the path exactly, don't swap in something cute 💖

---

🍓 SEE ALSO 🍓

• Kernel file ./include/uapi/linux/vduse.h
• struct vduse_dev_config(9)
• struct vduse_iotlb_entry(9)
• struct vduse_config_data(9)
• struct vduse_vq_config(9)
• struct vduse_vq_state_split(9)
• struct vduse_vq_state_packed(9)
• struct vduse_vq_group_asid(9)
• struct vduse_vq_info(9)
• struct vduse_vq_eventfd(9)
• struct vduse_iova_umem(9)
• struct vduse_iova_info(9)
• struct vduse_iotlb_entry_v2(9)
• enum vduse_req_type(9)
• struct vduse_vq_state(9)
• struct vduse_dev_status(9)
• struct vduse_iova_range(9)
• struct vduse_iova_range_v2(9)
• struct vduse_vq_ready(9)
• struct vduse_dev_response(9)

---

and that's the whole page bestie!! 💖 this gem lives over in ./include/uapi/linux and it's dated October 2026 — go read the source, slay, and hydrate 💅🫶✨