DEVLINK-DEV(8) راهنمای مدیریت سیستم پارچ DEVLINK-DEV(8)

devlink-dev - مدیریت دستگاههای devlink


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... ]

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


قالب به این صورت است:
BUS_NAME/BUS_ADDRESS

تنظیم حالت eswitch.

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

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

برخی دستگاه‌های سخت‌افزاری نیاز دارند که درایور VF بخشی از سرآیند بسته‌ها را روی توصیف‌گر ارسال (TX descriptor) قرار دهد تا e-switch بتواند تطبیق و هدایت بسته را به درستی انجام دهد.

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

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

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

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

تنظیم پشتیبانی از کپسوله‌سازی (encapsulation) در eswitch.

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

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

نام پارامتر مورد نظر برای تنظیم را مشخص می‌کند.
مقدار جدید برای تنظیم. با گزینه default ناسازگار است.
بازیابی پارامتر به مقدار پیش‌فرض آن. با گزینه value ناسازگار است.
حالت پیکربندی (configuration mode) که مقدار جدید در آن تنظیم می‌شود.

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

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

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

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

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) و از دست نرفتن هیچ‌گونه پیکربندی.

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

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

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

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

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

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

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

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

devlink dev show

وضعیت تمام دستگاه‌های devlink موجود در سیستم را نمایش می‌دهد.

devlink dev show pci/0000:01:00.0

وضعیت دستگاه devlink مشخص‌شده را نمایش می‌دهد.

devlink dev eswitch show pci/0000:01:00.0

حالت eswitch دستگاه devlink مشخص‌شده را نمایش می‌دهد.

devlink dev eswitch set pci/0000:01:00.0 mode switchdev

حالت eswitch دستگاه devlink مشخص‌شده را روی switchdev تنظیم می‌کند.

devlink dev param show pci/0000:01:00.0 name max_macs

ویژگی‌های پارامتر max_macs را نمایش می‌دهد. در صورت وجود مقدار پیش‌فرض، در کنار مقدار فعلی نمایش داده خواهد شد.

devlink dev param set pci/0000:01:00.0 name internal_error_reset value true cmode runtime

مقدار پارامتر internal_error_reset دستگاه devlink مشخص‌شده را برابر با true قرار می‌دهد.

devlink dev param set pci/0000:01:00.0 name internal_error_reset default cmode runtime

پارامتر internal_error_reset دستگاه devlink مشخص‌شده را به مقدار پیش‌فرض آن بازمی‌گرداند.

devlink dev reload pci/0000:01:00.0

بارگذاری مجدد گرم (hot reload) را روی دستگاه devlink مشخص‌شده انجام می‌دهد.

devlink dev flash pci/0000:01:00.0 file firmware.bin

دستگاه devlink مشخص‌شده را با فایل سفت‌افزار ارائه‌شده فلش می‌کند. اگر درایور پشتیبانی کند، کاربر وضعیت روند فلش را دریافت می‌کند؛ برای مثال:
Preparing to flash
Flashing 100%
Flashing done

devlink dev selftests show pci/0000:01:00.0

خودآزمایی‌های پشتیبانی‌شده توسط دستگاه devlink را نمایش می‌دهد.

devlink dev selftests run pci/0000:01:00.0 id flash

یک آزمون فلش روی دستگاه devlink انجام می‌دهد.

devlink(8), devlink-port(8), devlink-sb(8), devlink-monitor(8)

Jiri Pirko <jiri@mellanox.com>

14 Mar 2016 iproute2