__vdpa_alloc_device(9)

🌸 NAME 🌸

Hey bestie, welcome to __vdpa_alloc_device(9) from the Kernel API Manual! ✨ This is the function that will allocate and initilaize a vDPA device — yes, initilaize is the original spelling and I am obsessed with the chaos 😭. The way that it’s all about letting a driver do some prepartion after the device is initialized but before it gets registered — prepartion spelling included, no cap.

🦋 SYNOPSIS 🦋

struct vdpa_device * __vdpa_alloc_device (struct device *parent , const
       struct vdpa_config_ops *config , const struct virtio_map_ops *map ,
       unsigned int ngroups , unsigned int nas , size_t size , const char *name
       , bool use_va );

🎀 ARGUMENTS 🎀

• parent — the parent device 👑
• config — the bus operations that is supported by this device
• map — the map operations that is supported by this device
• ngroups — number of groups supported by this device
• nas — number of address spaces supported by this device
• size — size of the parent structure that contains private data
• name — name of the vdpa device; optional. ✨
• use_va — indicate whether virtual address must be used by this device

💅 DESCRIPTION 💅

Okay so the big vibe here: drivers should use the vdpa_alloc_device wrapper macro instead of using this directly. That’s literally the whole note, bestie — do not come for this function directly unless you’re the wrapper macro living your main character energy. Periodt. 💅

The manual is very clear: “Driver should use vdpa_alloc_device wrapper macro instead of using this directly.” Not me making it up. 🫶

🔥 RETURN 🔥

Returns an error when parent/config/map is not set or fail to get ida. That’s the whole return section, fr fr. 😭

🌈 SEE ALSO 🌈

• Kernel file ./drivers/vdpa/vdpa.c — the source file reference, iykyk.
• _vdpa_register_device(9)
• vdpa_register_device(9)
• _vdpa_unregister_device(9)
• vdpa_unregister_device(9)
• __vdpa_register_driver(9)
• vdpa_unregister_driver(9)
• vdpa_mgmtdev_register(9)
• vdpa_get_config(9)
• vdpa_set_config(9)

That’s the page, bestie! Footer energy: source path ./drivers/vdpa, date October 2026, and title __vdpa_alloc_device(9). Bye bestie, go slay your vDPA device allocation 💅🫶✨