{
    "mode": "man",
    "parameter": "vdpa-dev",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/vdpa-dev/8/json",
    "generated": "2026-10-08T09:20:46Z",
    "synopsis": "vdpa dev [ OPTIONS ]  { COMMAND| help }\nOPTIONS := { -V[ersion] }\nvdpa dev show [ DEV ]",
    "sections": {
        "NAME": {
            "content": "vdpa-dev - vdpa device configuration\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "vdpa dev [ OPTIONS ]  { COMMAND| help }\n\n\nOPTIONS := { -V[ersion] }\n\nvdpa dev show [ DEV ]\n",
            "subsections": [
                {
                    "name": "vdpa dev help",
                    "content": "vdpa dev add name NAME mgmtdev MGMTDEV [ mac MACADDR ] [ mtu MTU ] [ maxvqp MAXVQPAIRS ]\n\nvdpa dev del DEV\n\nvdpa dev config show [ DEV ]\n\nvdpa dev vstats show DEV qidx QUEUEINDEX\n\n\n"
                }
            ]
        },
        "DESCRIPTION": {
            "content": "",
            "subsections": [
                {
                    "name": "vdpa dev show - display vdpa device attributes",
                    "content": "DEV - specifies the vdpa device to show.  If this argument is omitted all devices are listed.\n\nFormat is:\nVDPADEVICENAME\n\n"
                },
                {
                    "name": "vdpa dev add - add a new vdpa device.",
                    "content": "name NAME\nName of the new vdpa device to add.\n\n\nmgmtdev MGMTDEV\nName of the management device to use for device addition.\n\n\nmac MACADDR - specifies the mac address for the new vdpa device.  This is applicable only for\nthe network type of vdpa device. This is optional.\n\nmtu MTU - specifies the mtu for the new vdpa device.  This is applicable only for the network\ntype of vdpa device. This is optional.\n\n"
                },
                {
                    "name": "vdpa dev del - Delete the vdpa device.",
                    "content": "DEV - specifies the vdpa device to delete.\n\n"
                },
                {
                    "name": "vdpa dev config show - Show configuration of specific device or all devices.",
                    "content": "DEV  -  specifies the vdpa device to show its configuration.  If this argument is omitted all\ndevices configuration is listed.\n\nFormat is:\nVDPADEVICENAME\n\n"
                },
                {
                    "name": "vdpa dev vstats show - shows vendor specific statistics for the given device and virtqueue index.",
                    "content": ""
                },
                {
                    "name": "The information is presented as name-value pairs where name is the  name  of  the  field  and",
                    "content": ""
                },
                {
                    "name": "value is a numeric value for it.",
                    "content": "DEV    - specifies the vdpa device to query\n\n\nqidx QUEUEINDEX\n- specifies the virtqueue index to query\n\n"
                }
            ]
        },
        "EXAMPLES": {
            "content": "vdpa dev show\nShows the all vdpa devices on the system.\n\nvdpa dev show foo\nShows the specified vdpa device.\n\nvdpa dev add name foo mgmtdev vdpasimnet\nAdd the vdpa device named foo on the management device vdpasimnet.\n\nvdpa dev add name foo mgmtdev vdpasimnet mac 00:11:22:33:44:55\nAdd  the  vdpa device named foo on the management device vdpasimnet with mac address of\n00:11:22:33:44:55.\n\nvdpa dev add name foo mgmtdev vdpasimnet mac 00:11:22:33:44:55 mtu 9000\nAdd the vdpa device named foo on the management device vdpasimnet with mac  address  of\n00:11:22:33:44:55 and mtu of 9000 bytes.\n\nvdpa dev add name foo mgmtdev auxiliary/mlx5core.sf.1 mac 00:11:22:33:44:55 maxvqp 8\nAdd  the vdpa device named foo on the management device auxiliary/mlx5core.sf.1 with mac\naddress of 00:11:22:33:44:55 and max 8 virtqueue pairs\n\nvdpa dev del foo\nDelete the vdpa device named foo which was previously created.\n\nvdpa dev config show foo\nShows the vdpa device configuration of device named foo.\n\nvdpa dev vstats show vdpa0 qidx 1\nShows vendor specific statistics information for vdpa device vdpa0 and virtqueue index 1\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "vdpa(8), vdpa-mgmtdev(8),\n\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Parav Pandit <parav@nvidia.com>\n\niproute2                                     5 Jan 2021                               DEVLINK-DEV(8)",
            "subsections": []
        }
    },
    "summary": "vdpa-dev - vdpa device configuration",
    "flags": [],
    "examples": [
        "vdpa dev show",
        "Shows the all vdpa devices on the system.",
        "vdpa dev show foo",
        "Shows the specified vdpa device.",
        "vdpa dev add name foo mgmtdev vdpasimnet",
        "Add the vdpa device named foo on the management device vdpasimnet.",
        "vdpa dev add name foo mgmtdev vdpasimnet mac 00:11:22:33:44:55",
        "Add  the  vdpa device named foo on the management device vdpasimnet with mac address of",
        "00:11:22:33:44:55.",
        "vdpa dev add name foo mgmtdev vdpasimnet mac 00:11:22:33:44:55 mtu 9000",
        "Add the vdpa device named foo on the management device vdpasimnet with mac  address  of",
        "00:11:22:33:44:55 and mtu of 9000 bytes.",
        "vdpa dev add name foo mgmtdev auxiliary/mlx5core.sf.1 mac 00:11:22:33:44:55 maxvqp 8",
        "Add  the vdpa device named foo on the management device auxiliary/mlx5core.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.",
        "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"
    ],
    "see_also": [
        {
            "name": "vdpa",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vdpa/8/json"
        },
        {
            "name": "vdpa-mgmtdev",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vdpa-mgmtdev/8/json"
        }
    ]
}