.TH DCB-REWR 8 "15 مه 2023" "iproute2" "راهنمای لینوکس"
.SH "نام (NAME)"
dcb-rewr \- پیکربندی بازنویسی اولویت به کدپوینت در dcb
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.ad l
.in +8

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

.ti -8
.B dcb rewr " { " show " | " flush " } " dev
.RI DEV
.RB "[ " prio-dscp " ]"
.RB "[ " prio-pcp " ]"

.ti -8
.B dcb rewr " { " add " | " del " | " replace " } " dev
.RI DEV
.RB "[ " prio-dscp " " \fIDSCP-MAP\fB " ]"
.RB "[ " prio-pcp " " \fIPCP-MAP\fB " ]"

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

.ti -8
.IR DSCP-MAPPING " := " \fIPRIO \fB:\fR "{ " DSCP " | " \fBall\fR " }"

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

.ti -8
.IR PCP-MAPPING " := " \fIPRIO \fB:\fR PCP\fR

.ti -8
.IR DSCP " := { " \fB0\fR " .. " \fB63\fR " }"

.ti -8
.IR PCP " := { " \fB0(nd/de)\fR " .. " \fB7(nd/de)\fR " }"

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

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

دستور
.B dcb rewr
برای پیکربندی جدول بازنویسی (rewrite table) در زیرسیستم DCB (کوتاه‌نوشت Data Center Bridging) به کار می‌رود. جدول بازنویسی برای بازنویسی مقادیر مشخصی در سرآیندهای بسته بر اساس اولویت بسته استفاده می‌شود.
.PP
مدخل‌های بازنویسی DCB، همانند مدخل‌های DCB APP، سه‌گانه‌هایی (3-tuples) متشکل از انتخاب‌گر (selector)، شناسه پروتکل (protocol ID) و اولویت (priority) هستند. انتخاب‌گر یک شمارش است که یکی از فضاهای نام اولویت‌بندی را مشخص می‌کند. در حال حاضر، فقط فضاهای نام انتخاب‌گر DSCP و PCP توسط
.B dcb rewr
پشتیبانی می‌شوند.
.PP
جدول بازنویسی فهرستی از قوانین بازنویسی DCB است که برای بسته‌های دارای اولویت منطبق اعمال می‌شود. شایان ذکر است که داشتن انتساب‌های بازنویسی متعارض برای یک انتخاب‌گر و اولویت یکسان مجاز است. به عنوان مثال، مجموعه دو مدخل بازنویسی (DSCP, 10, 1) و (DSCP, 11, 1)، که در آن بسته‌های دارای اولویت ۱ باید مقادیر DSCP آن‌ها هم به ۱۰ و هم به ۱۱ بازنویسی شود، یک جدول بازنویسی کاملاً معتبر را تشکیل می‌دهند. ابزار
.B dcb rewr
مدیریت سطح پایین جدول بازنویسی را از طریق افزودن و حذف سه‌گانه‌های منفرد بازنویسی با دستورهای
.B add
و
.B del
فراهم می‌کند. از سوی دیگر، دستور
.B replace
کاری را انجام می‌دهد که معمولاً در این شرایط مورد انتظار است: ابتدا پیکربندی جدید را اضافه می‌کند و سپس پیکربندی منسوخ را حذف می‌نماید، به طوری که فقط یک قانون بازنویسی برای یک انتخاب‌گر و اولویت مشخص اعمال شود.

.SH "دستورها (COMMANDS)"

.TP
.B show
تمام مدخل‌های مربوط به یک انتخاب‌گر مشخص را نمایش می‌دهد. چنانچه هیچ انتخاب‌گری تعیین نشود، تمام مدخل‌های جدول بازنویسی را به تفکیک انتخاب‌گر نمایش می‌دهد.

.TP
.B flush
تمام مدخل‌های مربوط به یک انتخاب‌گر مشخص را پاکسازی می‌کند. در صورت عدم تعیین انتخاب‌گر، تمام مدخل‌های جدول بازنویسی را پاکسازی می‌نماید.

.TP
.B add
.TQ
.B del
سه‌گانه‌های منفرد بازنویسی را به ترتیب به جدول بازنویسی DCB اضافه یا از آن حذف می‌کنند.

.TP
.B replace
فهرست مدخل‌های ذکرشده به عنوان پارامتر را دریافت کرده و مواردی را که هنوز در جدول بازنویسی وجود ندارند، اضافه می‌کند. سپس آن مدخل‌هایی را که انتخاب‌گر و اولویت آن‌ها به عنوان پارامتر ذکر شده است اما شناسه پروتکل دقیقاً یکسانی ندارند، حذف می‌نماید. این کار تضمین می‌کند که برای انتخاب‌گر و اولویت مشخص‌شده، جدول فقط شامل شناسه (یا شناسه‌های) پروتکل ارائه‌شده به عنوان پارامتر باشد.

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

جدول زیر پارامترها را به همان شیوه‌ای که با دستورهای
\fBadd\fR، \fBdel\fR
و
\fBreplace\fR
استفاده می‌شوند، نشان می‌دهد. برای
\fBshow\fR
و
\fBflush\fR،
نام پارامتر به عنوان یک کلیدواژه ساده بدون آرگومان‌های بیشتر به کار می‌رود.

.TP
.B prio-dscp \fIDSCP-MAP
\fIDSCP-MAP\fR
از نحو پارامتر آرایه‌ای استفاده می‌کند؛ برای جزئیات به
.BR dcb (8)
مراجعه کنید. کلیدها اولویت‌ها هستند و مقادیر، نقاط DSCP برای ترافیک با اولویت منطبق می‌باشند. نقاط DSCP را می‌توان به صورت مستقیم با مقادیر عددی یا با استفاده از نام‌های نمادین مشخص‌شده در
.B /etc/iproute2/rt_dsfield
نوشت (البته توجه داشته باشید که این پرونده مقادیر کامل ۸ بیتی dsfield را مشخص می‌کند، در حالی که
.B dcb rewr
فقط از شش بیت بالاتر استفاده خواهد کرد). دستور
.B dcb rewr show
نیز در صورت امکان مقادیر DSCP را به عنوان نام‌های نمادین قالب‌بندی می‌کند. گزینه خط فرمان
.B \-N
ترجمه نام‌ها در نمایش را غیرفعال می‌کند.

.TP
.B prio-pcp \fIPCP-MAP
\fIPCP-MAP\fR
از نحو پارامتر آرایه‌ای استفاده می‌کند؛ برای جزئیات به
.BR dcb (8)
مراجعه کنید. کلیدها اولویت‌ها هستند. مقادیر، PCP/DEI برای ترافیک با اولویت منطبق می‌باشند. مقادیر PCP/DEI به صورت ترکیبی از مقادیر عددی و نمادین نوشته می‌شوند تا هر دو را پوشش دهند. PCP همیشه به صورت عددی است، مثلاً 0 .. 7، و DEI به صورت نمادین است، مانند \(aqde\(aq (واجد شرایط دور انداختن / drop-eligible) که نشان‌دهنده ۱ بودن بیت DEI است، یا \(aqnd\(aq (فاقد شرایط دور انداختن / not-drop-eligible) که نشان‌دهنده ۰ بودن بیت DEI است. در ترکیب، مقدار 1:2de به نگاشت اولویت ۱ به PCP=2 و DEI=1 ترجمه می‌شود.

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

افزودن یک قانون برای بازنویسی DSCP به ترتیب به مقادیر 0، 24 و 48 برای ترافیک با اولویت 0، 3 و 6:
.P
# dcb rewr add dev eth0 prio-dscp 0:0 3:24 6:48

افزودن یک قانون برای بازنویسی DSCP به 25 برای ترافیک با اولویت 3:
.P
# dcb rewr add dev eth0 prio-dscp 3:25
.br
# dcb rewr show dev eth0 prio-dscp
.br
prio-dscp 0:0 3:CS3 3:25 6:CS6
.br
# dcb -N rewr show dev eth0 prio-dscp
.br
prio-dscp 0:0 3:24 3:25 6:48

پیکربندی مجدد جدول به طوری که فقط یک قانون برای بازنویسی ترافیک با اولویت 3 وجود داشته باشد:

.P
# dcb rewr replace dev eth0 prio-dscp 3:26
.br
# dcb rewr -N show dev eth0 prio-dscp
.br
prio-dscp 0:0 3:26 6:48

پاکسازی تمام قوانین DSCP:

.P
# dcb rewr flush dev eth0 prio-dscp
.br
# dcb rewr show dev eth0 prio-dscp
.br
(nothing)

افزودن یک قانون برای بازنویسی PCP به 1 و DEI به 0 برای ترافیک با اولویت 1، و یک قانون برای بازنویسی PCP به 2 و DEI به 1 برای ترافیک با اولویت 2:

.P
# dcb rewr add dev eth0 prio-pcp 1:1nd 2:2de
.br
# dcb rewr show dev eth0 prio-pcp
.br
prio-pcp 1:1nd 2:2de

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

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

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

.SH "نویسنده (AUTHOR)"
Daniel Machon <daniel.machon@microchip.com>