.TH DCB-PFC 8 "31 October 2020" "iproute2" "Linux"
.SH "نام (NAME)"
dcb-pfc \- پیکربندی کنترل جریان مبتنی بر اولویت (Priority-based Flow Control) در dcb
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.ad l
.in +8

.ti -8
.B dcb
.RI "[ " OPTIONS " ] "
.B pfc
.RI "{ " COMMAND " | " help " }"
.sp

.ti -8
.B dcb pfc show dev
.RI DEV
.RB "[ " pfc-cap " ]"
.RB "[ " prio-pfc " ]"
.RB "[ " macsec-bypass " ]"
.RB "[ " delay " ]"
.RB "[ " requests " ]"
.RB "[ " indications " ]"

.ti -8
.B dcb pfc set dev
.RI DEV
.RB "[ " prio-pfc " " \fIPFC-MAP " ]"
.RB "[ " macsec-bypass " { " on " | " off " } ]"
.RB "[ " delay " " \fIINTEGER\fR " ]"

.ti -8
.IR PFC-MAP " := [ " PFC-MAP " ] " PFC-MAPPING

.ti -8
.IR PFC-MAPPING " := { " PRIO " | " \fBall " }" \fB:\fR "{ "
.IR \fBon\fR " | " \fBoff\fR " }"

.ti -8
.IR PRIO " := { " \fB0\fR " .. " \fB7\fR " }"

.SH "توضیحات (DESCRIPTION)"

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

.SH "پارامترها (PARAMETERS)"

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

.TP
.B pfc-cap
یک ویژگی فقط-خواندنی که تعداد رده‌های ترافیکی (traffic classes) را که می‌توانند هم‌زمان از PFC پشتیبانی کنند نمایش می‌دهد.

.TP
.B requests
شمارش فقط-خواندنی از فریم‌های PFC ارسال‌شده به ازای هر رده ترافیکی. تنها زمانی که
.B \-s
داده شده باشد، یا زمانی که به صراحت درخواست شود نمایش داده می‌شود.

.TP
.B indications
شمارش فقط-خواندنی از فریم‌های PFC دریافت‌شده به ازای هر رده ترافیکی. تنها زمانی که
.B \-s
داده شده باشد، یا زمانی که به صراحت درخواست شود نمایش داده می‌شود.

.TP
.B macsec-bypass \fR{ \fBon\fR | \fBoff\fR }
آیا ایستگاه فرستنده قادر به دور زدن (bypass) پردازش MACsec در هنگام غیرفعال بودن MACsec هست یا خیر.

.TP
.B prio-pfc \fIPFC-MAP
پارامتر
\fIPFC-MAP\fR
از نحو پارامتر آرایه‌ای استفاده می‌کند؛ برای جزئیات به
.BR dcb (8)
مراجعه کنید. کلیدها اولویت‌ها هستند و مقادیر نشانگرهای
.B on
/
.B off
از این‌که آیا PFC برای یک اولویت داده‌شده فعال است یا خیر می‌باشند.

.TP
.B delay \fIINTEGER
میزان مجاز در نظر گرفته‌شده برای تأخیر انتشار رفت و برگشت (round-trip propagation delay) پیوند به بیت. مقدار باید در بازه 0..65535 باشد.

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

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

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

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

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

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

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

.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت دستور، وضعیت خروج 0 و در صورت شکست یک عدد صحیح مثبت است.

.SH "همچنین ببینید (SEE ALSO)"
.BR dcb (8)

.SH "گزارش خطاها (REPORTING BUGS)"
هرگونه باگ را به فهرست پستی توسعه‌دهندگان شبکه
.B <netdev@vger.kernel.org>
که توسعه و نگهداری عمدتاً در آنجا انجام می‌شود گزارش دهید.
برای ارسال پیام به این فهرست پستی، نیازی به عضویت در آن ندارید.

.SH "نویسنده (AUTHOR)"
Petr Machata <me@pmachata.org>