.TH GATE 8 "12 Mar 2020" "iproute2" "Linux"
.SH "نام (NAME)"
tc-gate \- کُنش دروازه جریان داده در کنترل ترافیک
.SH "خلاصه دستور (SYNOPSIS)"
.B tc " ... " action gate
.ti +8
.B [ base-time
BASETIME ]
.B [ clockid
CLOCKID ]
.ti +8
.B sched-entry
<gate state> <interval 1> [ <internal priority> <max octets> ]
.ti +8
.B sched-entry
<gate state> <interval 2> [ <internal priority> <max octets> ]
.ti +8
.B sched-entry
<gate state> <interval 3> [ <internal priority> <max octets> ]
.ti +8
.B ......
.ti +8
.B sched-entry
<gate state> <interval N> [ <internal priority> <max octets> ]

.SH "توضیحات (DESCRIPTION)"
کُنش
.B GATE
به فریم‌های ورودی (ingress) مشخص‌شده اجازه می‌دهد در یک بازه زمانی خاص عبور کنند یا در بازه زمانی خاص دیگری دور ریخته (drop) شوند. فیلتر
.B tc
فریم‌های ورودی را پالایش می‌کند، سپس کُنش
.B tc gate
مشخص می‌سازد که این فریم‌ها در چه بازه زمانی و به چه میزان بایت می‌توانند به دستگاه ارسال شوند و در چه بازه زمانی باید دور ریخته شوند.
.PP
کُنش
.B gate
همچنین یک زمان مبنا
.RB ( base-time )
را تخصیص می‌دهد تا مشخص کند فهرست ورودی‌ها از چه زمانی شروع می‌شود. سپس کُنش
.B gate
فهرست ورودی‌های دروازه را از زمان مبنای شروع، به صورت چرخه‌ای تکرار می‌کند.
.PP
برای شبیه‌سازی نرم‌افزاری، کُنش
.B gate
کاربر را ملزم می‌سازد تا نوع ساعت مرجع زمانی را تعیین کند.

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

.TP
.B base-time
لحظه زمانی را بر حسب نانوثانیه مشخص می‌کند و زمان شروع زمان‌بندی را تعریف می‌نماید. اگر
.B base-time
زمانی در گذشته باشد، زمان‌بندی در لحظه زیر آغاز خواهد شد:
.PP
.nf
base-time + (N * cycle-time)
.fi
.PP
که در آن
.B N
کوچک‌ترین عدد صحیحی است به گونه‌ای که زمان حاصل، بزرگ‌تر از زمان فعلی (now) باشد، و
.B cycle-time
مجموع تمام بازه‌های زمانی مربوط به ورودی‌های موجود در جدول زمان‌بندی است. در صورتی که
.B base-time
تعیین نشود، مقدار پیش‌فرض آن 0 خواهد بود.

.TP
.B clockid
ساعتی را مشخص می‌کند که تایمر داخلی qdisc برای اندازه‌گیری زمان و زمان‌بندی رویدادها از آن استفاده می‌نماید. این گزینه در صورتی که کُنش
.B gate
برای برون‌سپاری فیلتر به سخت‌افزار (offloading filter) به کار رود معتبر نیست؛ برای نمونه، در دستور
.B tc filter
همراه با پارامتر
.BR skip_sw .

.TP
.B sched-entry
در یک جدول زمان‌بندی واحد ممکن است چندین پارامتر
.B sched-entry
وجود داشته باشد. قالب هر کدام به صورت زیر است:
.PP
.nf
sched-entry <gate state> <interval> [ <internal priority> <max octets> ]
.fi
.PP
.BR <gate\ state> :
وضعیت دروازه را مشخص می‌کند؛
.B 'open'
دروازه را باز نگه می‌دارد و
.B 'close'
دروازه را می‌بندد.
.br
.BR <interval> :
مدت‌زمان این بازه زمانی (time slot) را بر حسب نانوثانیه مشخص می‌کند.
.br
.BR <internal\ priority> :
نشان‌دهنده مقدار اولویت داخلی است که بیانگر صف دریافت داخلی برای این جریان می‌باشد. مقدار
.B "\-1"
به معنای حالت عمومی (wildcard) است. مقادیر
.B <internal priority>
و
.B <max octets>
می‌توانند حذف شوند که در این حالت برای این
.BR <sched-entry> ،
مقدار پیش‌فرض هر دوی آن‌ها برابر با
.B "\-1"
خواهد بود.
.br
.BR <max\ octets> :
حداکثر حجم داده بر حسب بایت (اکتت) را که می‌تواند در این بازه زمانی عبور کند مشخص می‌نماید. در صورت فراتر رفتن از حد مجاز، بسته‌ها دور ریخته می‌شوند. مقدار
.B "\-1"
به معنای حالت عمومی (wildcard) است. پارامتر
.B <max octets>
می‌تواند حذف شود که در این حالت مقدار آن به طور پیش‌فرض برای این
.B <sched-entry>
برابر با
.B "\-1"
در نظر گرفته می‌شود.
.br
توجه داشته باشید که اگر وضعیت دروازه در یک
.B sched-entry
برابر با
.B 'close'
باشد، پارامترهای
.B <internal priority>
و
.B <max octets>
هیچ مفهومی ندارند؛ چرا که با وضعیت
.BR 'close' ،
تمام فریم‌ها دور ریخته می‌شوند.

.SH "مثال‌ها (EXAMPLES)"

مثال زیر نشان می‌دهد که فیلتر
.B tc
برای فریم‌هایی که نشانی IP مبدا آن‌ها با
.B 192.168.0.20
مطابقت دارد، در این ورودی زمان‌بندی دروازه را به مدت ۲۰۰ میلی‌ثانیه باز نگه می‌دارد و حجم ترافیک را به ۸ مگابایت محدود می‌کند؛ سپس دروازه ترافیک را به مدت ۱۰۰ میلی‌ثانیه می‌بندد. فریم‌هایی که در وضعیت بسته بودن دروازه برسند، دور ریخته می‌شوند. سپس چرخه، ورودی‌های دروازه را به صورت دوره‌ای اجرا می‌کند. جدول زمان‌بندی در لحظه ۲۰۰٫۰ ثانیه با استفاده از ساعت مرجع
.B CLOCK_TAI
آغاز می‌شود. این زمان‌بندی از دو ورودی تشکیل شده است که مدت زمان هر یک از آن‌ها ۳۰۰ میلی‌ثانیه است.
.PP
.EX
# tc qdisc add dev eth0 ingress
# tc filter add dev eth0 parent ffff: protocol ip \\
           flower skip_hw src_ip 192.168.0.20 \\
           action gate index 2 clockid CLOCK_TAI \\
           base-time 200000000000ns \\
           sched-entry open 200000000ns -1 8000000b \\
           sched-entry close 100000000ns
.EE
.PP
دستورهای زیر مثالی برای فیلتر کردن جریانی با آدرس MAC مبدا
.B 10:00:80:00:00:00
از فریم‌های ICMP است که در هر زمان با چرخه ۲۰۰ میلی‌ثانیه دور ریخته می‌شوند؛ همراه با زمان مبنای پیش‌فرض 0 و ساعت
.B CLOCK_TAI
به عنوان پیش‌فرض.
.PP
.EX
# tc qdisc add dev eth0 ingress
# tc filter add dev eth0 parent ffff:  protocol ip \\
	flower ip_proto icmp dst_mac 10:00:80:00:00:00 \\
	action gate index 12 sched-entry close 200000000ns
.EE

.SH "نویسندگان (AUTHORS)"
Po Liu <Po.Liu@nxp.com>