DEVLINK-PORT(8) Linux DEVLINK-PORT(8)

devlink-port - مدیریت پورتهای devlink


devlink [ OPTIONS ] port { COMMAND | help }

OPTIONS := { -V[ersion] | -n[no-nice-names] }

devlink port set DEV/PORT_INDEX [ type { eth | ib | auto } ]

devlink port split DEV/PORT_INDEX count COUNT

devlink port unsplit DEV/PORT_INDEX

devlink port show [ DEV/PORT_INDEX ]

devlink port health { show | recover | diagnose | dump | set }

devlink port add { DEV | DEV/PORT_INDEX } [ flavour FLAVOUR ] [ pfnum PFNUMBER ] [ sfnum SFNUMBER ] [ controller CNUM ]

devlink port del DEV/PORT_INDEX

devlink port function set DEV/PORT_INDEX [ hw_addr ADDR ] [ state { active | inactive } ] [ roce { enable | disable } ] [ migratable { enable | disable } ] [ ipsec_crypto { enable | disable } ] [ ipsec_packet { enable | disable } ] [ max_io_eqs EQS ]

devlink port function rate { show | set | add | del | help }

devlink dev param set DEV/PORT_INDEX name PARAMETER value VALUE cmode { runtime | driverinit | permanent }

devlink dev param show [ DEV/PORT_INDEX name PARAMETER ]

devlink port help

DEV/PORT_INDEX - پورت devlink مورد نظر برای عملیات را مشخص می‌کند.


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

تنظیم نوع پورت.

eth - اترنت (Ethernet)

ib - اینفینی‌بند (Infiniband)

auto - انتخاب خودکار (autoselect)

DEV/PORT_INDEX - پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

تعداد پورت‌هایی که باید به آن‌ها تقسیم شود.

می‌تواند روی هر پورت تقسیم‌شده از همان گروه تقسیم (split group) انجام شود.

DEV/PORT_INDEX - پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

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

یک نام مستعار برای devlink-health(8) است.

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

DEV/PORT_INDEX - شناسه پورت (index) devlink را برای استفاده در پورت درخواستی جدید مشخص می‌کند. این گزینه اختیاری است. در صورت حذف، درایور یک شناسه پورت یکتا اختصاص می‌دهد.

تنظیم گونه (flavour) پورت

pcipf - پورت PCI PF

pcisf - پورت PCI SF

شماره PCI PF را که دستگاه SF روی آن ایجاد می‌شود مشخص می‌کند.
شماره sfnumber اختصاصی به دستگاه SF را مشخص می‌کند. این فیلد برای دستگاه‌هایی که از تخصیص خودکار شماره SF پشتیبانی می‌کنند اختیاری است.
شماره کنترل‌کننده‌ای را که پورت SF برای آن ایجاد می‌شود مشخص می‌کند. این فیلد اختیاری است و تنها زمانی استفاده می‌شود که پورت SF برای یک کنترل‌کننده خارجی ایجاد شود.

DEV/PORT_INDEX - پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

آدرس سخت‌افزاری تابع برای تنظیم. هنگامی که نوع پورت Ethernet باشد، این آدرس MAC اترنت است.
وضعیت جدید تابع برای تغییر.

active - پس از اتمام پیکربندی تابع، تابع را فعال می‌کند.

inactive - برای غیرفعال کردن تابع و دستگاه(های) آن، روی inactive تنظیم کنید.

تنظیم قابلیت RoCE تابع.
تنظیم قابلیت مهاجرت‌پذیری (migratable) تابع.
تنظیم قابلیت آفلود رمزنگاری IPsec تابع. آفلود عملیات رمزنگاری (رمزگذاری/رمزگشایی) وضعیت XFRM را کنترل می‌کند.
تنظیم قابلیت آفلود بسته IPsec تابع. آفلود وضعیت و سیاست XFRM (عملیات رمزگذاری/رمزگشایی و کپسوله‌سازی IPsec) را کنترل می‌کند.
تنظیم حداکثر تعداد صف‌های رویداد ورودی/خروجی (IO event queues) تابع.

DEV/PORT_INDEX - پورت devlink مورد نظر برای حذف را مشخص می‌کند.

DEV/PORT_INDEX - پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

مشخص کردن نام پارامتر برای تنظیم.
مقدار جدید برای تنظیم.
حالت پیکربندی که در آن مقدار جدید تنظیم می‌شود.

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

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

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

DEV/PORT_INDEX - پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

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

یک نام مستعار برای devlink-rate(8) است.

devlink port show

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

devlink port show pci/0000:01:00.0/1

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

devlink port set pci/0000:01:00.0/1 type eth

تنظیم نوع پورت devlink مشخص‌شده به Ethernet.

devlink port split pci/0000:01:00.0/1 count 4

تقسیم پورت devlink مشخص‌شده به چهار پورت.

devlink port unsplit pci/0000:01:00.0/1

لغو تقسیم پورت devlink مشخص‌شده که قبلاً تقسیم شده است.

devlink port health show

نمایش وضعیت و پیکربندی تمام گزارش‌دهنده‌های پشتیبانی‌شده و ثبت‌شده روی تمام پورت‌های devlink.

devlink port health show pci/0000:01:00.0/1 reporter tx

نمایش وضعیت و پیکربندی گزارش‌دهنده tx ثبت‌شده روی پورت devlink با شناسه pci/0000:01:00.0/1.

devlink port add pci/0000:06:00.0 flavour pcisf pfnum 0 sfnum 88

افزودن یک پورت devlink با گونه PCI SF روی PCI PF با شماره 0 و با شماره SF برابر با 88. برای استفاده از تابع، یک توالی نمونه به این صورت است: افزودن پورت، پیکربندی ویژگی تابع و فعال‌سازی تابع. پس از اتمام استفاده از تابع، غیرفعال‌سازی تابع و در نهایت حذف پورت. زمانی که تمایل به استفاده مجدد از پورت بدون حذف آن وجود دارد، می‌توان آن را در وضعیتی که تابع غیرفعال (inactive) و وضعیت عملیاتی آن منفصل (detached) است، مجدداً پیکربندی و فعال کرد.

devlink port del pci/0000:06:00.0/1

حذف پورت devlink که قبلاً ایجاد شده است. توصیه می‌شود اگر تابع از مدیریت وضعیت پشتیبانی می‌کند، ابتدا تابع غیرفعال شود.

devlink port function set pci/0000:01:00.0/1 hw_addr 00:00:00:11:22:33

پیکربندی آدرس سخت‌افزاری تابع PCI ارائه‌شده توسط پورت devlink. اگر پورت از تغییر در وضعیت تابع پشتیبانی کند، آدرس سخت‌افزاری باید پیش از فعال‌سازی تابع پیکربندی شود.

devlink port function set pci/0000:01:00.0/1 state active

فعال‌سازی تابع. این عمل شمارش تابع و بارگذاری درایور را آغاز می‌کند.

devlink port function set pci/0000:01:00.0/1 state inactive

غیرفعال‌سازی تابع. این عمل برچیدن تابع را آغاز می‌کند که منجر به تخلیه درایور و حذف دستگاه می‌شود.

devlink port function set pci/0000:01:00.0/1 roce enable

قابلیت RoCE تابع را فعال می‌کند.

devlink port function set pci/0000:01:00.0/1 migratable enable

قابلیت مهاجرت‌پذیری (migratable) تابع را فعال می‌کند.

devlink port function set pci/0000:01:00.0/1 ipsec_crypto enable

قابلیت آفلود رمزنگاری IPsec تابع را فعال می‌کند.

devlink port function set pci/0000:01:00.0/1 ipsec_packet enable

قابلیت آفلود بسته IPsec تابع را فعال می‌کند.

devlink port function set pci/0000:01:00.0/1 max_io_eqs 4

حداکثر تعداد صف‌های رویداد ورودی/خروجی (IO event queues) تابع را روی 4 تنظیم می‌کند.

devlink port function set pci/0000:01:00.0/1 hw_addr 00:00:00:11:22:33 state active

پیکربندی آدرس سخت‌افزاری و همچنین فعال‌سازی تابع. هنگامی که یک تابع همراه با پیکربندی‌های دیگر در یک دستور تکی فعال می‌شود، ابتدا تمام پیکربندی‌ها اعمال شده و سپس وضعیت به active تغییر می‌یابد.

devlink dev param show

نمایش (تخلیه) تمام پارامترهای پورت در سراسر دستگاه‌های ثبت‌شده در devlink.

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

تنظیم پارامتر internal_error_reset پورت devlink مشخص‌شده (#1) به true.

devlink port add pci/0000:06:00.0 flavour pcisf pfnum 0 sfnum 88 controller 1

افزودن یک پورت devlink با گونه PCI SF روی کنترل‌کننده 1 که دارای PCI PF با شماره 0 و شماره SF برابر با 88 است. برای استفاده از تابع، یک توالی نمونه به این صورت است: افزودن پورت، پیکربندی ویژگی تابع و فعال‌سازی تابع. پس از اتمام استفاده از تابع، غیرفعال‌سازی تابع و در نهایت حذف پورت. زمانی که تمایل به استفاده مجدد از پورت بدون حذف آن وجود دارد، می‌توان آن را در وضعیتی که تابع غیرفعال (inactive) و وضعیت عملیاتی آن منفصل (detached) است، مجدداً پیکربندی و فعال کرد.

devlink(8), devlink-dev(8), devlink-sb(8), devlink-monitor(8), devlink-health(8),

Jiri Pirko <jiri@mellanox.com>

14 Mar 2016 iproute2