STRUCT VDUSE_DEV_CONFIG(9)

👑 struct vduse_dev_config(9) — the Kernel API Manual, but make it cute ✨

okay bestie, listen up 💖 this is the whole entire kernel API manual entry for struct vduse_dev_config, and it's genuinely giving "the blueprint of a VDUSE device" energy. no cap, it's the starting point of everything. let's get into it 🎀

🌸 NAME 🌸

struct vduse_dev_config — the basic configuration of a VDUSE device, like, the whole vibe of it in one struct 🦋

✨ SYNOPSIS ✨

struct vduse_dev_config {
  #define VDUSE_NAME_MAX  256;
    char name[VDUSE_NAME_MAX];
    __u32 vendor_id;
    __u32 device_id;
    __u64 features;
    __u32 vq_num;
    __u32 vq_align;
    __u32 ngroups;
    __u32 nas;
    __u32 reserved[11];
    __u32 config_size;
    __u8 config[];
};

like, that's it. that's the struct. she's iconic, she's flexible (that config[] is a flexible array member, iykyk 💅), and she holds everything.

🫶 Members 🫶

• name — the VDUSE device name. and listen, it needs to be NUL terminated — no exceptions, bestie, the kernel is not playing about this one 🔥
• vendor_id — the virtio vendor id
• device_id — the virtio device id
• features — the virtio features
• vq_num — the number of virtqueues
• vq_align — the allocation alignment of the virtqueue's metadata
• ngroups — the number of vq groups that the VDUSE device declares
• nas — the number of address spaces that the VDUSE device declares
• reserved — reserved for future use, and it needs to be initialized to zero. periodt. don't get creative with it 🙈
• config_size — the size of the configuration space
• config — the buffer of the configuration space

---

💜 Description 💜

so like, this is the structure that the VDUSE_CREATE_DEV ioctl uses to create a VDUSE device. that's the whole thing. that's her job. main character energy honestly 👑

🚨 reminder from your girl: name must be NUL terminated, and reserved must be initialized to zero. the kernel will notice. don't test her 😭

🦋 SEE ALSO 🦋

the kernel file is ./include/uapi/linux/vduse.h, and honestly the whole friend group is here — go say hi 💖

• 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_request(9)
• struct vduse_dev_response(9)

---

and that's the whole page, bestie 🌈 slay, you read it all 💅

this little masterpiece lives in ./include/uapi/linux and it was dated October 2026 — so yeah, grab your calendar and mark it, because that's the version you're looking at 🎀 ily, go build something iconic with it 🫶✨