.TH DEVLINK\-DEV 8 "5 Jan 2021" "iproute2" "Linux"
.SH "نام (NAME)"
vdpa-dev \- پیکربندی دستگاه vdpa
.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
.RI "[ device_features " DEVICE_FEATURES " ]"
.RI "[ mac " MACADDR " ]"
.RI "[ mtu " MTU " ]"
.RI "[ max_vqp " MAX_VQ_PAIRS " ]"

.ti -8
.B vdpa dev del
.I DEV

.ti -8
.B vdpa dev config show
.RI "[ " DEV " ]"

.ti -8
.B vdpa dev vstats show
.I DEV
.B qidx
.I QUEUE_INDEX

.ti -8
.B vdpa dev set
.B name
.I NAME
.B mac
.RI "[ " MACADDR " ]"

.SH "توضیحات (DESCRIPTION)"
.SS vdpa dev show - نمایش ویژگی‌های دستگاه vdpa

.PP
.I "DEV"
\- دستگاه vdpa را برای نمایش مشخص می‌کند.
اگر این آرگومان حذف شود، همه دستگاه‌ها فهرست می‌شوند.

.in +4
قالب به این صورت است:
.in +2
VDPA_DEVICE_NAME

.SS vdpa dev add - افزودن یک دستگاه vdpa جدید.

.TP
.BI name " NAME"
نام دستگاه vdpa جدید برای افزودن.

.TP
.BI mgmtdev " MGMTDEV"
نام دستگاه مدیریتی (management device) برای استفاده در افزودن دستگاه.

.PP
.BI device_features " DEVICE_FEATURES"
ماسک بیتی ویژگی‌های دستگاه virtio را مشخص می‌کند که برای دستگاه vdpa جدید آماده‌سازی (provision) می‌شود.

بیت‌ها را می‌توان در مسیر
.BR include/uapi/linux/virtio*h
یافت.

ماکروهایی مانند
.B VIRTIO_F_
و
.B VIRTIO_XXX(e.g NET)_F_
را برای مقادیر بیتی مشخص ببینید.

این گزینه اختیاری است.

.BI mac " MACADDR"
\- آدرس mac را برای دستگاه vdpa جدید مشخص می‌کند.
این گزینه فقط برای دستگاه vdpa از نوع شبکه قابل اعمال است. این گزینه اختیاری است.

.BI mtu " MTU"
\- مقدار mtu را برای دستگاه vdpa جدید مشخص می‌کند.
این گزینه فقط برای دستگاه vdpa از نوع شبکه قابل اعمال است. این گزینه اختیاری است.

.SS vdpa dev del - حذف دستگاه vdpa.

.PP
.I "DEV"
\- دستگاه vdpa را برای حذف مشخص می‌کند.

.SS vdpa dev config show - نمایش پیکربندی یک دستگاه خاص یا تمام دستگاه‌ها.

.PP
.I "DEV"
\- دستگاه vdpa را برای نمایش پیکربندی آن مشخص می‌کند.
اگر این آرگومان حذف شود، پیکربندی همه دستگاه‌ها فهرست می‌شود.

.in +4
قالب به این صورت است:
.in +2
VDPA_DEVICE_NAME

.SS vdpa dev vstats show - نمایش اطلاعات آماری ویژه سازنده (vendor specific) برای دستگاه و نمایه صف virtqueue داده‌شده. اطلاعات به صورت جفت‌های نام-مقدار ارائه می‌شود که در آن name نام فیلد و value یک مقدار عددی برای آن است.

.TP
.BI "DEV"
\- دستگاه vdpa مورد نظر را برای پرس‌وجو مشخص می‌کند.

.TP
.BI qidx " QUEUE_INDEX"
\- نمایه صف virtqueue را برای پرس‌وجو مشخص می‌کند.

.SS vdpa dev set - اعمال پیکربندی بر روی دستگاه vdpa.

.BI name " NAME"
\- نام دستگاه vdpa برای پیکربندی.

.BI mac " MACADDR"
\- آدرس mac را برای دستگاه vdpa مشخص می‌کند.
این گزینه فقط برای دستگاه vdpa از نوع شبکه قابل اعمال است.

.SH "مثال‌ها (EXAMPLES)"
.PP
vdpa dev show
.RS 4
تمام دستگاه‌های vdpa موجود در سیستم را نمایش می‌دهد.
.RE
.PP
vdpa dev show foo
.RS 4
دستگاه vdpa مشخص‌شده را نمایش می‌دهد.
.RE
.PP
vdpa dev add name foo mgmtdev vdpa_sim_net
.RS 4
دستگاه vdpa با نام foo را روی دستگاه مدیریتی vdpa_sim_net اضافه می‌کند.
.RE
.PP
vdpa dev add name foo mgmtdev vdpa_sim_net device_features 0x300020000
.RS 4
دستگاه vdpa با نام foo را روی دستگاه مدیریتی vdpa_sim_net با device_features مقدار 0x300020000 اضافه می‌کند.
.RE
.PP
vdpa dev add name foo mgmtdev vdpa_sim_net mac 00:11:22:33:44:55
.RS 4
دستگاه vdpa با نام foo را روی دستگاه مدیریتی vdpa_sim_net با آدرس mac معادل 00:11:22:33:44:55 اضافه می‌کند.
.RE
.PP
vdpa dev add name foo mgmtdev vdpa_sim_net mac 00:11:22:33:44:55 mtu 9000
.RS 4
دستگاه vdpa با نام foo را روی دستگاه مدیریتی vdpa_sim_net با آدرس mac معادل 00:11:22:33:44:55 و mtu به میزان ۹۰۰۰ بایت اضافه می‌کند.
.RE
.PP
vdpa dev add name foo mgmtdev auxiliary/mlx5_core.sf.1 mac 00:11:22:33:44:55 max_vqp 8
.RS 4
دستگاه vdpa با نام foo را روی دستگاه مدیریتی auxiliary/mlx5_core.sf.1 با آدرس mac معادل 00:11:22:33:44:55 و حداکثر ۸ جفت virtqueue اضافه می‌کند.
.RE
.PP
vdpa dev del foo
.RS 4
دستگاه vdpa با نام foo که پیش‌تر ایجاد شده بود را حذف می‌کند.
.RE
.PP
vdpa dev config show foo
.RS 4
پیکربندی دستگاه vdpa با نام foo را نمایش می‌دهد.
.RE
.PP
vdpa dev vstats show vdpa0 qidx 1
.RS 4
اطلاعات آماری ویژه سازنده را برای دستگاه vdpa با نام vdpa0 و نمایه صف virtqueue با شماره ۱ نمایش می‌دهد.
.RE
.PP
vdpa dev set name vdpa0 mac 00:11:22:33:44:55
.RS 4
یک آدرس MAC مشخص را برای دستگاه vdpa با نام vdpa0 تنظیم می‌کند.
.RE

.SH "همچنین ببینید (SEE ALSO)"
.BR vdpa (8),
.BR vdpa-mgmtdev (8)
.br

.SH "نویسنده (AUTHOR)"
Parav Pandit <parav@nvidia.com>