mirror_iproute2/man/man8/vdpa-dev.8
Parav Pandit c2ecc82b9d vdpa: Add vdpa tool
vdpa tool is created to create, delete and query vdpa devices.
examples:
Show vdpa management device that supports creating, deleting vdpa devices.

$ vdpa mgmtdev show
vdpasim:
  supported_classes net

$ vdpa mgmtdev show -jp
{
    "show": {
        "vdpasim": {
            "supported_classes": [ "net" ]
        }
    }
}

Create a vdpa device of type networking named as "foo2" from
the management device vdpasim_net:

$ vdpa dev add mgmtdev vdpasim_net name foo2

Show the newly created vdpa device by its name:
$ vdpa dev show foo2
foo2: type network mgmtdev vdpasim_net vendor_id 0 max_vqs 2 max_vq_size 256

$ vdpa dev show foo2 -jp
{
    "dev": {
        "foo2": {
            "type": "network",
            "mgmtdev": "vdpasim_net",
            "vendor_id": 0,
            "max_vqs": 2,
            "max_vq_size": 256
        }
    }
}

Delete the vdpa device after its use:
$ vdpa dev del foo2

Signed-off-by: Parav Pandit <parav@nvidia.com>
Signed-off-by: David Ahern <dsahern@kernel.org>
2021-02-11 09:09:15 -07:00

97 lines
1.4 KiB
Groff

.TH DEVLINK\-DEV 8 "5 Jan 2021" "iproute2" "Linux"
.SH NAME
vdpa-dev \- vdpa device configuration
.SH SYNOPSIS
.sp
.ad l
.in +8
.ti -8
.B vdpa
.B dev
.RI "[ " OPTIONS " ] "
.RI " { " COMMAND | " "
.BR help " }"
.sp
.ti -8
.IR OPTIONS " := { "
\fB\-V\fR[\fIersion\fR]
}
.ti -8
.B vdpa dev show
.RI "[ " DEV " ]"
.ti -8
.B vdpa dev help
.ti -8
.B vdpa dev add
.B name
.I NAME
.B mgmtdev
.I MGMTDEV
.ti -8
.B vdpa dev del
.I DEV
.SH "DESCRIPTION"
.SS vdpa dev show - display vdpa device attributes
.PP
.I "DEV"
- specifies the vdpa device to show.
If this argument is omitted all devices are listed.
.in +4
Format is:
.in +2
VDPA_DEVICE_NAME
.SS vdpa dev add - add a new vdpa device.
.TP
.BI name " NAME"
Name of the new vdpa device to add.
.TP
.BI mgmtdev " MGMTDEV"
Name of the management device to use for device addition.
.SS vdpa dev del - Delete the vdpa device.
.PP
.I "DEV"
- specifies the vdpa device to delete.
.SH "EXAMPLES"
.PP
vdpa dev show
.RS 4
Shows the all vdpa devices on the system.
.RE
.PP
vdpa dev show foo
.RS 4
Shows the specified vdpa device.
.RE
.PP
vdpa dev add name foo mgmtdev vdpa_sim_net
.RS 4
Add the vdpa device named foo on the management device vdpa_sim_net.
.RE
.PP
vdpa dev del foo
.RS 4
Delete the vdpa device named foo which was previously created.
.RE
.SH SEE ALSO
.BR vdpa (8),
.BR vdpa-mgmtdev (8),
.br
.SH AUTHOR
Parav Pandit <parav@nvidia.com>