نام (NAME)

dcb-pfc - پیکربندی کنترل جریان مبتنی بر اولویت (Priority-based Flow Control) در dcb

خلاصه دستور (SYNOPSIS)

dcb [ OPTIONS ] pfc { COMMAND | help }

dcb pfc show dev DEV [ pfc-cap ] [ prio-pfc ] [ macsec-bypass ] [ delay ] [ requests ] [ indications ]

dcb pfc set dev DEV [ prio-pfc PFC-MAP ] [ macsec-bypass { on | off } ] [ delay INTEGER ]

PFC-MAP := [ PFC-MAP ] PFC-MAPPING

PFC-MAPPING := { PRIO | all }:{ on | off }

PRIO := { 0 .. 7 }

توضیحات (DESCRIPTION)

دستور dcb pfc برای پیکربندی ویژگی‌های کنترل جریان مبتنی بر اولویت (PFC یا Priority-based Flow Control) از طریق رابط DCB (پل‌بندی مرکز داده یا Data Center Bridging) لینوکس استفاده می‌شود. سازوکار PFC امکان نشانه‌گذاری جریان‌ها با اولویتی خاص را به عنوان جریان بدون افت (lossless) فراهم می‌آورد و پیکربندی‌های مرتبط و همچنین شمارنده‌های PFC را در خود نگه می‌دارد.

پارامترها (PARAMETERS)

برای پارامترهای خواندنی-نوشتنی، موارد زیر تنها جهت نوشتن را شرح می‌دهند، یعنی همان‌گونه که با دستور set استفاده می‌شوند. برای دستور show، نام پارامتر باید به عنوان یک کلیدواژه ساده بدون آرگومان‌های بیشتر استفاده شود. این کار به ابزار اعلام می‌کند که مقدار یک پارامتر داده‌شده را نمایش دهد. هنگامی که هیچ پارامتری داده نشود، ابزار پیکربندی کامل PFC را نمایش می‌دهد.

pfc-cap: یک ویژگی فقط-خواندنی که تعداد رده‌های ترافیکی (traffic classes) را که می‌توانند هم‌زمان از PFC پشتیبانی کنند نمایش می‌دهد.
requests: شمارش فقط-خواندنی از فریم‌های PFC ارسال‌شده به ازای هر رده ترافیکی. تنها زمانی که -s داده شده باشد، یا زمانی که به صراحت درخواست شود نمایش داده می‌شود.
indications: شمارش فقط-خواندنی از فریم‌های PFC دریافت‌شده به ازای هر رده ترافیکی. تنها زمانی که -s داده شده باشد، یا زمانی که به صراحت درخواست شود نمایش داده می‌شود.
macsec-bypass { on | off }: آیا ایستگاه فرستنده قادر به دور زدن (bypass) پردازش MACsec در هنگام غیرفعال بودن MACsec هست یا خیر.
prio-pfc PFC-MAP: پارامتر PFC-MAP از نحو پارامتر آرایه‌ای استفاده می‌کند؛ برای جزئیات به dcb(8) مراجعه کنید. کلیدها اولویت‌ها هستند و مقادیر نشانگرهای on / off از این‌که آیا PFC برای یک اولویت داده‌شده فعال است یا خیر می‌باشند.
delay INTEGER: میزان مجاز در نظر گرفته‌شده برای تأخیر انتشار رفت و برگشت (round-trip propagation delay) پیوند به بیت. مقدار باید در بازه 0..65535 باشد.

مثال‌ها و کاربرد (EXAMPLE & USAGE)

فعال کردن PFC روی اولویت‌های ۶ و ۷، بدون تغییر باقی موارد:

# dcb pfc set dev eth0 prio-pfc 6:on 7:on

غیرفعال کردن PFC برای همه اولویت‌ها به جز ۶ و ۷، و پیکربندی تأخیر به ۴۰۹۶ بیت:

# dcb pfc set dev eth0 prio-pfc all:off 6:on 7:on delay 0x1000

نمایش آن‌چه تنظیم شده است:

# dcb pfc show dev eth0
pfc-cap 8 macsec-bypass off delay 4096
prio-pfc 0:off 1:off 2:off 3:off 4:off 5:off 6:on 7:on

وضعیت خروج (EXIT STATUS)

در صورت موفقیت دستور، وضعیت خروج 0 و در صورت شکست یک عدد صحیح مثبت است.

همچنین ببینید (SEE ALSO)

dcb(8)

گزارش خطاها (REPORTING BUGS)

هرگونه باگ را به فهرست پستی توسعه‌دهندگان شبکه <netdev@vger.kernel.org> که توسعه و نگهداری عمدتاً در آنجا انجام می‌شود گزارش دهید. برای ارسال پیام به این فهرست پستی، نیازی به عضویت در آن ندارید.

نویسنده (AUTHOR)

Petr Machata <me@pmachata.org>