.TH DEVLINK\-DEV 8 "14 Mar 2016" "iproute2" "راهنمای مدیریت سیستم پارچ"
.SH "نام (NAME)"
devlink-dev \- مدیریت دستگاههای devlink
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.ad l
.in +8
.ti -8
.B devlink
.RI "[ " OPTIONS " ]"
.B dev
.RI  " { " COMMAND " | "
.BR help " }"
.sp

.ti -8
.IR OPTIONS " := { "
\fB\-V\fR[\fIersion\fR] |
\fB\-n\fR[\fIno-nice-names\fR] }

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

.ti -8
.B devlink dev help

.ti -8
.B devlink dev eswitch set
.I DEV
[
.BR mode " { " legacy " | " switchdev " } "
] [
.BR inline-mode " { " none " | " link " | " network " | " transport " } "
] [
.BR encap-mode " { " none " | " basic " } "
]

.ti -8
.B devlink dev eswitch show
.I DEV

.ti -8
.B devlink dev param set
.I DEV
.B name
.I PARAMETER
[
.B value
.I VALUE
|
.B default
]
.BR cmode " { " runtime " | " driverinit " | " permanent " } "

.ti -8
.B devlink dev param show
[
.I DEV
.B name
.I PARAMETER
]

.ti -8
.B devlink dev reload
.I DEV
[
.B netns
.RI "{ " PID " | " NAME " | " ID " }"
] [
.BR action " { " driver_reinit " | " fw_activate " }"
] [
.B limit no_reset
]

.ti -8
.B devlink dev info
[
.I DEV
]

.ti -8
.B devlink dev flash
.I DEV
.B file
.I PATH
[
.B target
.I ID
]

.ti -8
.B devlink dev selftests show
[
.I DEV
]

.ti -8
.B devlink dev selftests run
.I DEV
[
.B id
.I ID...
]

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

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

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

.SS "devlink dev eswitch show \- نمایش ویژگی‌های eswitch دستگاه devlink"
.SS "devlink dev eswitch set \- تنظیم ویژگی‌های eswitch دستگاه devlink"

.TP
.BR mode " { " legacy " | " switchdev " } "
تنظیم حالت eswitch.

.I legacy
\- حالت سنتی SRIOV (Legacy SRIOV).

.I switchdev
\- تخلیه بار switchdev مبتنی بر SRIOV (SRIOV switchdev offloads).

.TP
.BR inline-mode " { " none " | " link " | " network " | " transport " } "
برخی دستگاه‌های سخت‌افزاری نیاز دارند که درایور VF بخشی از سرآیند بسته‌ها را روی توصیف‌گر ارسال (TX descriptor) قرار دهد تا e-switch بتواند تطبیق و هدایت بسته را به درستی انجام دهد.

.I none
\- هیچ‌کدام (None)

.I link
\- حالت لایه ۲ (L2 mode)

.I network
\- حالت لایه ۳ (L3 mode)

.I transport
\- حالت لایه ۴ (L4 mode)

.TP
.BR encap-mode " { " none " | " basic " } "
تنظیم پشتیبانی از کپسوله‌سازی (encapsulation) در eswitch.

.I none
\- غیرفعال‌سازی پشتیبانی از کپسوله‌سازی

.I basic
\- فعال‌سازی پشتیبانی از کپسوله‌سازی

.SS "devlink dev param set \- تنظیم مقدار جدید برای پارامتر پیکربندی دستگاه devlink"

.TP
.BI name " PARAMETER"
نام پارامتر مورد نظر برای تنظیم را مشخص می‌کند.

.TP
.BI value " VALUE"
مقدار جدید برای تنظیم. با گزینه
.BR default
ناسازگار است.

.TP
.B default
بازیابی پارامتر به مقدار پیش‌فرض آن. با گزینه
.BR value
ناسازگار است.

.TP
.BR cmode " { " runtime " | " driverinit " | " permanent " } "
حالت پیکربندی (configuration mode) که مقدار جدید در آن تنظیم می‌شود.

.I runtime
\- تنظیم مقدار جدید در حین اجرای درایور. این حالت پیکربندی برای اعمال مقدار جدید نیازی به بازنشانی ندارد.

.I driverinit
\- تنظیم مقدار جدید که در هنگام مقداردهی اولیه درایور اعمال خواهد شد. این حالت پیکربندی برای اعمال مقدار جدید نیازمند راه‌اندازی مجدد درایور با دستور devlink reload است.

.I permanent
\- مقدار جدید در حافظه پایدار (non-volatile) دستگاه نوشته می‌شود. این حالت پیکربندی برای اعمال مقدار جدید نیازمند بازنشانی سخت‌افزاری است.

.SS "devlink dev param show \- نمایش ویژگی‌های پارامترهای پیکربندی پشتیبانی‌شده دستگاه devlink"

.TP
.B name
.I PARAMETER
نام پارامتر را برای نمایش مشخص می‌کند.
اگر این آرگومان حذف شود، تمام پارامترهای پشتیبانی‌شده توسط دستگاه‌های devlink فهرست می‌شوند.
هنگامی که هسته یک مقدار پیش‌فرض برای پارامتر ارائه دهد، آن مقدار به همراه مقدار فعلی به صورت خودکار در خروجی نمایش داده خواهد شد.

.SS "devlink dev reload \- انجام بارگذاری مجدد گرم درایور"

.PP
.I "DEV"
\- دستگاه devlink مورد نظر را برای بارگذاری مجدد مشخص می‌کند.

.B netns
.RI { " PID " | " NAME " | " ID " }
\- فضای نام شبکه (network namespace) را برای بارگذاری مجدد در آن، بر اساس pid، نام یا شناسه (id) مشخص می‌کند.

.BR action " { " driver_reinit " | " fw_activate " }"
\- عملیات بارگذاری مجدد مورد نیاز را تعیین می‌کند.
اگر این آرگومان حذف شود، عملیات
.I driver_reinit
استفاده خواهد شد.
توجه داشته باشید حتی اگر کاربر عملیات خاصی را درخواست کند، پیاده‌سازی درایور ممکن است مستلزم انجام عملیات دیگری در کنار آن باشد. برای مثال، برخی درایورها از مقداردهی اولیه مجدد درایور بدون فعال‌سازی سفت‌افزار پشتیبانی نمی‌کنند. بنابراین، دستور devlink reload فهرستی از عملیاتی را که واقعاً انجام شده‌اند بازمی‌گرداند.

.I driver_reinit
\- مقداردهی اولیه مجدد نهادهای درایور، و اعمال مقادیر devlink-param و devlink-resource.

.I fw_activate
\- سفت‌افزار جدید را در صورتی که چنین تصویری ذخیره شده و در انتظار فعال‌سازی باشد، فعال می‌کند. اگر محدودیتی تعیین نشده باشد، این عملیات ممکن است شامل بازنشانی سفت‌افزار باشد. اگر تصویر جدیدی در انتظار نباشد، این عملیات تصویر سفت‌افزار فعلی را دوباره بارگذاری می‌کند.

.B limit no_reset
\- محدودیت را روی عملیات بارگذاری مجدد مشخص می‌کند.
اگر این آرگومان حذف شود، محدودیت مشخص نشده و عملیات بارگذاری مجدد نامحدود خواهد بود. در چنین حالتی پیاده‌سازی درایور ممکن است در صورت نیاز شامل بازنشانی یا زمان ازکارافتادگی (downtime) برای انجام عملیات باشد.

.I no_reset
\- عدم مجاز بودن بازنشانی، عدم مجاز بودن زمان ازکارافتادگی، عدم قطع و وصل شدن پیوند (link flap) و از دست نرفتن هیچ‌گونه پیکربندی.

.SS "devlink dev info \- نمایش اطلاعات دستگاه"
اطلاعات ارائه‌شده توسط درایور درباره دستگاه را نمایش می‌دهد. این دستور می‌تواند برای پرس‌وجوی نسخه‌های قطعات سخت‌افزاری یا اجزای دستگاه که قابل به‌روزرسانی نیستند (
.I fixed
) و همچنین سفت‌افزار دستگاه که قابل به‌روزرسانی است به کار رود. برای اجزای سفت‌افزار،
.I running
نسخه‌های سفت‌افزاری را که در حال حاضر روی دستگاه بارگذاری شده‌اند نمایش می‌دهد، در حالی که
.I stored
نسخه‌های موجود در حافظه فلش دستگاه را گزارش می‌کند. نسخه‌های
.I Running
و
.I stored
ممکن است پس از به‌روزرسانی فلش اما قبل از راه‌اندازی مجدد سیستم با یکدیگر متفاوت باشند.

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

.SS "devlink dev flash \- نوشتن روی حافظه پایدار دستگاه"

.PP
.I "DEV"
\- دستگاه devlink را برای نوشتن مشخص می‌کند.

.B file
.I PATH
\- مسیر فایلی که در حافظه فلش دستگاه نوشته خواهد شد. این مسیر باید نسبت به یکی از پوشه‌هایی باشد که توسط بارگذار سفت‌افزار هسته جستجو می‌شوند، مانند /lib/firmware.

.B component
.I NAME
\- اگر دستگاه چندین تصویر سفت‌افزار را در حافظه پایدار ذخیره می‌کند، می‌توان از این پارامتر برای مشخص کردن اینکه کدام تصویر سفت‌افزار باید نوشته شود استفاده کرد. مقدار
.I NAME
باید با نام‌های مؤلفه برگرفته از
.B "devlink dev info"
مطابقت داشته باشد و ممکن است وابسته به درایور باشد.

.SS "devlink dev selftests show \- نمایش خودآزمایی‌های پشتیبانی‌شده در دستگاه devlink"

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

.SS "devlink dev selftests run \- اجرای خودآزمایی‌ها روی دستگاه devlink"

.PP
.I "DEV"
\- دستگاه devlink را برای اجرای خودآزمایی‌ها مشخص می‌کند.

.B id
.I  ID...
\- مقدار
.I ID(s)
باید با خودآزمایی‌های نشان‌داده‌شده در
.B "devlink dev selftests show"
مطابقت داشته باشد تا خودآزمایی‌ها روی دستگاه devlink اجرا شوند.
اگر این آرگومان حذف شود، تمام خودآزمایی‌های پشتیبانی‌شده توسط دستگاه‌های devlink اجرا خواهند شد.

.SH "مثال‌ها (EXAMPLES)"
.PP
devlink dev show
.RS 4
وضعیت تمام دستگاه‌های devlink موجود در سیستم را نمایش می‌دهد.
.RE
.PP
devlink dev show pci/0000:01:00.0
.RS 4
وضعیت دستگاه devlink مشخص‌شده را نمایش می‌دهد.
.RE
.PP
devlink dev eswitch show pci/0000:01:00.0
.RS 4
حالت eswitch دستگاه devlink مشخص‌شده را نمایش می‌دهد.
.RE
.PP
devlink dev eswitch set pci/0000:01:00.0 mode switchdev
.RS 4
حالت eswitch دستگاه devlink مشخص‌شده را روی switchdev تنظیم می‌کند.
.RE
.PP
devlink dev param show pci/0000:01:00.0 name max_macs
.RS 4
ویژگی‌های پارامتر max_macs را نمایش می‌دهد. در صورت وجود مقدار پیش‌فرض، در کنار مقدار فعلی نمایش داده خواهد شد.
.RE
.PP
devlink dev param set pci/0000:01:00.0 name internal_error_reset value true cmode runtime
.RS 4
مقدار پارامتر internal_error_reset دستگاه devlink مشخص‌شده را برابر با true قرار می‌دهد.
.RE
.PP
devlink dev param set pci/0000:01:00.0 name internal_error_reset default cmode runtime
.RS 4
پارامتر internal_error_reset دستگاه devlink مشخص‌شده را به مقدار پیش‌فرض آن بازمی‌گرداند.
.RE
.PP
devlink dev reload pci/0000:01:00.0
.RS 4
بارگذاری مجدد گرم (hot reload) را روی دستگاه devlink مشخص‌شده انجام می‌دهد.
.RE
.PP
devlink dev flash pci/0000:01:00.0 file firmware.bin
.RS 4
دستگاه devlink مشخص‌شده را با فایل سفت‌افزار ارائه‌شده فلش می‌کند. اگر درایور پشتیبانی کند، کاربر وضعیت روند فلش را دریافت می‌کند؛ برای مثال:
.br
Preparing to flash
.br
Flashing 100%
.br
Flashing done
.RE
.PP
devlink dev selftests show pci/0000:01:00.0
.RS 4
خودآزمایی‌های پشتیبانی‌شده توسط دستگاه devlink را نمایش می‌دهد.
.RE
.PP
devlink dev selftests run pci/0000:01:00.0 id flash
.RS 4
یک آزمون فلش روی دستگاه devlink انجام می‌دهد.
.RE

.SH "همچنین ببینید (SEE ALSO)"
.BR devlink (8),
.BR devlink-port (8),
.BR devlink-sb (8),
.BR devlink-monitor (8)
.br

.SH "نویسنده (AUTHOR)"
Jiri Pirko <jiri@mellanox.com>