| DEVLINK-DEV(8) | راهنمای مدیریت سیستم پارچ | DEVLINK-DEV(8) |
نام (NAME)
devlink-dev - مدیریت دستگاههای devlink
خلاصه دستور (SYNOPSIS)
devlink [ OPTIONS ] dev { COMMAND | help }
OPTIONS := { -V[ersion] | -n[no-nice-names] }
devlink dev show [ DEV ]
devlink dev help
devlink dev eswitch set DEV [ mode { legacy | switchdev } ] [ inline-mode { none | link | network | transport } ] [ encap-mode { none | basic } ]
devlink dev eswitch show DEV
devlink dev param set DEV name PARAMETER [ value VALUE | default ] cmode { runtime | driverinit | permanent }
devlink dev param show [ DEV name PARAMETER ]
devlink dev reload DEV [ netns { PID | NAME | ID } ] [ action { driver_reinit | fw_activate } ] [ limit no_reset ]
devlink dev info [ DEV ]
devlink dev flash DEV file PATH [ target ID ]
devlink dev selftests show [ DEV ]
devlink dev selftests run DEV [ id ID... ]
توضیحات (DESCRIPTION)
devlink dev show - نمایش ویژگیهای دستگاه devlink
DEV - دستگاه devlink مورد نظر برای نمایش را مشخص میکند. اگر این آرگومان حذف شود، همه دستگاهها فهرست میشوند.
قالب به این
صورت است:
BUS_NAME/BUS_ADDRESS
devlink dev eswitch show - نمایش ویژگیهای eswitch دستگاه devlink
devlink dev eswitch set - تنظیم ویژگیهای eswitch دستگاه devlink
- mode { legacy | switchdev }
- تنظیم حالت
eswitch.
legacy - حالت سنتی SRIOV (Legacy SRIOV).
switchdev - تخلیه بار switchdev مبتنی بر SRIOV (SRIOV switchdev offloads).
- inline-mode { none | link | network | transport }
- برخی
دستگاههای
سختافزاری
نیاز دارند
که درایور VF
بخشی از
سرآیند
بستهها را
روی
توصیفگر
ارسال (TX descriptor)
قرار دهد تا
e-switch بتواند
تطبیق و
هدایت بسته
را به درستی
انجام دهد.
none - هیچکدام (None)
link - حالت لایه ۲ (L2 mode)
network - حالت لایه ۳ (L3 mode)
transport - حالت لایه ۴ (L4 mode)
- encap-mode { none | basic }
- تنظیم
پشتیبانی
از
کپسولهسازی
(encapsulation) در eswitch.
none - غیرفعالسازی پشتیبانی از کپسولهسازی
basic - فعالسازی پشتیبانی از کپسولهسازی
devlink dev param set - تنظیم مقدار جدید برای پارامتر پیکربندی دستگاه devlink
- name PARAMETER
- نام پارامتر مورد نظر برای تنظیم را مشخص میکند.
- value VALUE
- مقدار جدید برای تنظیم. با گزینه default ناسازگار است.
- default
- بازیابی پارامتر به مقدار پیشفرض آن. با گزینه value ناسازگار است.
- cmode { runtime | driverinit | permanent }
- حالت
پیکربندی
(configuration mode) که
مقدار جدید
در آن تنظیم
میشود.
runtime - تنظیم مقدار جدید در حین اجرای درایور. این حالت پیکربندی برای اعمال مقدار جدید نیازی به بازنشانی ندارد.
driverinit - تنظیم مقدار جدید که در هنگام مقداردهی اولیه درایور اعمال خواهد شد. این حالت پیکربندی برای اعمال مقدار جدید نیازمند راهاندازی مجدد درایور با دستور devlink reload است.
permanent - مقدار جدید در حافظه پایدار (non-volatile) دستگاه نوشته میشود. این حالت پیکربندی برای اعمال مقدار جدید نیازمند بازنشانی سختافزاری است.
devlink dev param show - نمایش ویژگیهای پارامترهای پیکربندی پشتیبانیشده دستگاه devlink
- name
- PARAMETER نام پارامتر را برای نمایش مشخص میکند. اگر این آرگومان حذف شود، تمام پارامترهای پشتیبانیشده توسط دستگاههای devlink فهرست میشوند. هنگامی که هسته یک مقدار پیشفرض برای پارامتر ارائه دهد، آن مقدار به همراه مقدار فعلی به صورت خودکار در خروجی نمایش داده خواهد شد.
devlink dev reload - انجام بارگذاری مجدد گرم درایور
DEV - دستگاه devlink مورد نظر را برای بارگذاری مجدد مشخص میکند.
netns { PID | NAME | ID } - فضای نام شبکه (network namespace) را برای بارگذاری مجدد در آن، بر اساس pid، نام یا شناسه (id) مشخص میکند.
action { driver_reinit | fw_activate } - عملیات بارگذاری مجدد مورد نیاز را تعیین میکند. اگر این آرگومان حذف شود، عملیات driver_reinit استفاده خواهد شد. توجه داشته باشید حتی اگر کاربر عملیات خاصی را درخواست کند، پیادهسازی درایور ممکن است مستلزم انجام عملیات دیگری در کنار آن باشد. برای مثال، برخی درایورها از مقداردهی اولیه مجدد درایور بدون فعالسازی سفتافزار پشتیبانی نمیکنند. بنابراین، دستور devlink reload فهرستی از عملیاتی را که واقعاً انجام شدهاند بازمیگرداند.
driver_reinit - مقداردهی اولیه مجدد نهادهای درایور، و اعمال مقادیر devlink-param و devlink-resource.
fw_activate - سفتافزار جدید را در صورتی که چنین تصویری ذخیره شده و در انتظار فعالسازی باشد، فعال میکند. اگر محدودیتی تعیین نشده باشد، این عملیات ممکن است شامل بازنشانی سفتافزار باشد. اگر تصویر جدیدی در انتظار نباشد، این عملیات تصویر سفتافزار فعلی را دوباره بارگذاری میکند.
limit no_reset - محدودیت را روی عملیات بارگذاری مجدد مشخص میکند. اگر این آرگومان حذف شود، محدودیت مشخص نشده و عملیات بارگذاری مجدد نامحدود خواهد بود. در چنین حالتی پیادهسازی درایور ممکن است در صورت نیاز شامل بازنشانی یا زمان ازکارافتادگی (downtime) برای انجام عملیات باشد.
no_reset - عدم مجاز بودن بازنشانی، عدم مجاز بودن زمان ازکارافتادگی، عدم قطع و وصل شدن پیوند (link flap) و از دست نرفتن هیچگونه پیکربندی.
devlink dev info - نمایش اطلاعات دستگاه
اطلاعات ارائهشده توسط درایور درباره دستگاه را نمایش میدهد. این دستور میتواند برای پرسوجوی نسخههای قطعات سختافزاری یا اجزای دستگاه که قابل بهروزرسانی نیستند ( fixed ) و همچنین سفتافزار دستگاه که قابل بهروزرسانی است به کار رود. برای اجزای سفتافزار، running نسخههای سفتافزاری را که در حال حاضر روی دستگاه بارگذاری شدهاند نمایش میدهد، در حالی که stored نسخههای موجود در حافظه فلش دستگاه را گزارش میکند. نسخههای Running و stored ممکن است پس از بهروزرسانی فلش اما قبل از راهاندازی مجدد سیستم با یکدیگر متفاوت باشند.
DEV - دستگاه devlink را برای نمایش مشخص میکند. اگر این آرگومان حذف شود، همه دستگاهها فهرست میشوند.
devlink dev flash - نوشتن روی حافظه پایدار دستگاه
DEV - دستگاه devlink را برای نوشتن مشخص میکند.
file PATH - مسیر فایلی که در حافظه فلش دستگاه نوشته خواهد شد. این مسیر باید نسبت به یکی از پوشههایی باشد که توسط بارگذار سفتافزار هسته جستجو میشوند، مانند /lib/firmware.
component NAME - اگر دستگاه چندین تصویر سفتافزار را در حافظه پایدار ذخیره میکند، میتوان از این پارامتر برای مشخص کردن اینکه کدام تصویر سفتافزار باید نوشته شود استفاده کرد. مقدار NAME باید با نامهای مؤلفه برگرفته از devlink dev info مطابقت داشته باشد و ممکن است وابسته به درایور باشد.
devlink dev selftests show - نمایش خودآزماییهای پشتیبانیشده در دستگاه devlink
DEV - دستگاه devlink را مشخص میکند. اگر این آرگومان حذف شود، تمام خودآزماییهای مربوط به دستگاههای devlink فهرست میشوند.
devlink dev selftests run - اجرای خودآزماییها روی دستگاه devlink
DEV - دستگاه devlink را برای اجرای خودآزماییها مشخص میکند.
id ID... - مقدار ID(s) باید با خودآزماییهای نشاندادهشده در devlink dev selftests show مطابقت داشته باشد تا خودآزماییها روی دستگاه devlink اجرا شوند. اگر این آرگومان حذف شود، تمام خودآزماییهای پشتیبانیشده توسط دستگاههای devlink اجرا خواهند شد.
مثالها (EXAMPLES)
devlink dev show
devlink dev show pci/0000:01:00.0
devlink dev eswitch show pci/0000:01:00.0
devlink dev eswitch set pci/0000:01:00.0 mode switchdev
devlink dev param show pci/0000:01:00.0 name max_macs
devlink dev param set pci/0000:01:00.0 name internal_error_reset value true cmode runtime
devlink dev param set pci/0000:01:00.0 name internal_error_reset default cmode runtime
devlink dev reload pci/0000:01:00.0
devlink dev flash pci/0000:01:00.0 file firmware.bin
Preparing to flash
Flashing 100%
Flashing done
devlink dev selftests show pci/0000:01:00.0
devlink dev selftests run pci/0000:01:00.0 id flash
همچنین ببینید (SEE ALSO)
devlink(8), devlink-port(8), devlink-sb(8), devlink-monitor(8)
نویسنده (AUTHOR)
Jiri Pirko <jiri@mellanox.com>
| 14 Mar 2016 | iproute2 |