VDPA-DEV(8)

💖 VDPA-DEV — vdpa device configuration 💖

okay bestie, welcome to vdpa-dev, the manual page from the Linux fam that teaches you how to configure your vdpa devices. it's giving "niche but iconic" and honestly? obsessed. let's get into it 🦋

---

✨ SYNOPSIS ✨

vdpa dev [ OPTIONS ]  { COMMAND| help }

OPTIONS := { -V[ersion] }

vdpa dev show [ DEV ]

vdpa dev help

vdpa dev add name NAME mgmtdev MGMTDEV [ device_features DEVICE_FEATURES
        ] [ mac MACADDR ] [ mtu MTU ] [ max_vqp MAX_VQ_PAIRS ]

vdpa dev del DEV

vdpa dev config show [ DEV ]

vdpa dev vstats show DEV qidx QUEUE_INDEX

vdpa dev set name NAME mac [ MACADDR ]

like, that's the whole vibe at a glance 💅 everything below is the same thing but with feelings.

---

🌸 DESCRIPTION 🌸

🎀 vdpa dev show — display vdpa device attributes 🎀

• DEV — this one says which vdpa device you wanna show, bestie. and if you just… don't pass it? then all devices get listed, no cap.

the format is literally this and nothing else:

VDPA_DEVICE_NAME

---

🎀 vdpa dev add — add a new vdpa device 🎀

like, birthing a whole new device. main character energy fr fr.

• name NAME — the name of the brand new vdpa device you're adding. yes, you get to pick it. slay.
• mgmtdev MGMTDEV — the name of the management device you're using to do the adding. it's the plug, basically.
• device_features DEVICE_FEATURES — this specifies the virtio device features bit-mask that gets provisioned for your new vdpa device ✨

the bits live under include/uapi/linux/virtio*.h.

go look at macros like VIRTIO_F_ and VIRTIO_XXX (e.g., NET)_F_ for the specific bit values 👑

this one is optional, so you can totally skip it.

• mac MACADDR — specifies the mac address for the new vdpa device. heads up tho: this is applicable only for the network type of vdpa device. also optional. 🍓
• mtu MTU — specifies the mtu for the new vdpa device. same deal: applicable only for the network type of vdpa device, and also optional. 💜

---

🎀 vdpa dev del — Delete the vdpa device 🎀

• DEV — specifies the vdpa device to delete. bye bitch 👋 (affectionately).

---

🎀 vdpa dev config show — Show configuration of specific device or all devices 🎀

• DEV — specifies the vdpa device whose configuration you wanna see. omit it and all devices' configuration gets listed. your choice bestie.

the format is:

VDPA_DEVICE_NAME

---

🎀 vdpa dev vstats show — show vendor specific statistics 🎀

shows vendor specific statistics for the given device and virtqueue index, periodt. the info comes at you as name-value pairs where the name is the name of the field and the value is a numeric value for it. cute, right?

• DEV — specifies the vdpa device to query.
• qidx QUEUE_INDEX — specifies the virtqueue index to query.

---

🎀 vdpa dev set — set the configuration to the vdpa device 🎀

• name NAME — name of the vdpa device you're configuring.
• mac MACADDR — specifies the mac address for the vdpa device. this is applicable only for the network type of vdpa device. no exceptions, iykyk.

---

💅 EXAMPLES 💅

• vdpa dev show shows all vdpa devices on the system. the whole roster 🔥
• vdpa dev show foo shows the specified vdpa device. just foo. only foo.
• vdpa dev add name foo mgmtdev vdpa_sim_net add the vdpa device named foo on the management device vdpa_sim_net.
• vdpa dev add name foo mgmtdev vdpa_sim_net device_features 0x300020000 add the vdpa device named foo on the management device vdpa_sim_net with device_features of 0x300020000.
• vdpa dev add name foo mgmtdev vdpa_sim_net mac 00:11:22:33:44:55 add the vdpa device named foo on the management device vdpa_sim_net with mac address of 00:11:22:33:44:55.
• vdpa dev add name foo mgmtdev vdpa_sim_net mac 00:11:22:33:44:55 mtu 9000 add the vdpa device named foo on the management device vdpa_sim_net with mac address of 00:11:22:33:44:55 and mtu of 9000 bytes.
• vdpa dev add name foo mgmtdev auxiliary/mlx5_core.sf.1 mac 00:11:22:33:44:55 max_vqp 8 add the vdpa device named foo on the management device auxiliary/mlx5_core.sf.1 with mac address of 00:11:22:33:44:55 and max 8 virtqueue pairs.
• vdpa dev del foo delete the vdpa device named foo which was previously created. rip to foo 🪦
• vdpa dev config show foo shows the vdpa device configuration of device named foo.
• vdpa dev vstats show vdpa0 qidx 1 shows vendor specific statistics information for vdpa device vdpa0 and virtqueue index 1.
• vdpa dev set name vdpa0 mac 00:11:22:33:44:55 set a specific MAC address to vdpa device vdpa0.

---

👀 SEE ALSO 👀

vdpa(8), vdpa-mgmtdev(8),

go read those too bestie, they're part of the lore 🌈

---

🫶 AUTHOR 🫶

Parav Pandit <parav@nvidia.com> — thank you for your service, king 👑

---

and that's the whole page!! this came to you from iproute2, dated 5 Jan 2021, and it's the VDPA-DEV(8) manual page from the Linux set. mwah, go configure something gorgeous 💖✨🎀