.TH "Packet sample action in tc" 8 "31 Jan 2017" "iproute2" "Linux"

.SH "نام (NAME)"
tc-sample \- کنش نمونه‌برداری از بسته‌ها در کنترل ترافیک (tc)
.SH "خلاصه دستور (SYNOPSIS)"
.in +8
.ti -8

.BR tc " ... " "action sample rate"
.I RATE
.BR "group"
.I GROUP
.RB "[ " trunc
.IR SIZE " ] "
.RB "[ " index
.IR INDEX " ] "
.ti -8

.BR tc " ... " "action sample index "
.I INDEX
.ti -8

.SH "توضیحات (DESCRIPTION)"
کنش
.B sample
امکان نمونه‌برداری از بسته‌های منطبق بر یک دسته‌بند (classifier) را فراهم می‌کند.

بسته‌ها به‌صورت تصادفی بر اساس پارامتر
.B rate
انتخاب می‌شوند و با استفاده از کانال عمومی netlink ماژول
.B psample
نمونه‌برداری می‌گردند. کاربر همچنین می‌تواند کوتاه‌سازی بسته (truncation) را به منظور صرفه‌جویی در ترافیک میان کاربر و هسته مشخص کند. هر نمونه شامل مقداری متادیتا درباره بسته اصلی است که با استفاده از مشخصه‌های netlink در کنار داده‌های بسته اصلی ارسال می‌شود.

کاربر می‌تواند پارامترهای کنش sample را همان‌طور که در قالب نخست در بالا نشان داده شده تعیین کند، یا مطابق قالب دوم، با استفاده از شناسه (index) یک کنش sample موجود را به‌کار گیرد.

.SH "فیلدهای متادیتای بسته‌های نمونه‌برداری‌شده (SAMPLED PACKETS METADATA FIELDS)"
متادیتا از طریق کانال عمومی netlink ماژول
.B psample
به برنامه‌های فضای کاربر تحویل داده می‌شود، جایی که هر نمونه شامل مشخصه‌های netlink زیر است:
.TP
.BI PSAMPLE_ATTR_IIFINDEX
شناسه رابط ورودی بسته، در صورت وجود.
.TP
.BI PSAMPLE_ATTR_OIFINDEX
شناسه رابط خروجی بسته. این فیلد در نمونه‌برداری ورودی (ingress) کاربرد ندارد.
.TP
.BI PSAMPLE_ATTR_ORIGSIZE
اندازه بسته اصلی (پیش از کوتاه‌سازی / truncation).
.TP
.BI PSAMPLE_ATTR_SAMPLE_GROUP
گروه
.B psample
که بسته به آن ارسال شده است.
.TP
.BI PSAMPLE_ATTR_GROUP_SEQ
شماره ترتیبی بسته نمونه‌برداری‌شده. این مقدار با هر بسته نمونه‌برداری‌شده در گروه
.B psample
فعلی افزایش می‌یابد.
.TP
.BI PSAMPLE_ATTR_SAMPLE_RATE
نرخی که بسته با آن نمونه‌برداری شده است.

.SH "گزینه‌ها (OPTIONS)"
.TP
.BI rate " RATE"
نرخ نمونه‌برداری از بسته.
.I "RATE"
نسبت مورد انتظار میان بسته‌های دیده‌شده و بسته‌های نمونه‌برداری‌شده است. برای نمونه، مقدار
.I "RATE"
برابر ۱۰۰ منجر به نمونه‌برداری میانگین یک بسته از هر ۱۰۰ بسته دیده‌شده خواهد شد.
.TP
.BI trunc " SIZE"
در صورت تنظیم، حداکثر اندازه بسته‌های نمونه‌برداری‌شده را تعیین می‌کند و در صورت نیاز سبب کوتاه‌سازی بسته می‌شود.
.TP
.BI group " GROUP"
گروه
.B psample
که بسته به آن فرستاده خواهد شد. ماژول
.B psample
مفهوم گروه‌ها را تعریف می‌کند که به کاربر اجازه می‌دهد بسته‌های نمونه‌برداری‌شده خاص را در شرایط وجود چندین قانون نمونه‌برداری تطبیق دهد و بدین ترتیب تنها بسته‌های برخاسته از یک قانون مشخص را شناسایی کند.
.TP
.BI index " INDEX"
یک شناسه یکتا برای کنش است. هنگام ایجاد یک نمونه کنش تازه، این پارامتر امکان تنظیم شناسه کنش جدید را فراهم می‌کند. هنگام استفاده از یک کنش موجود، این پارامتر امکان تعیین شناسه کنش موجود را می‌دهد. این شناسه باید یک عدد صحیح بدون علامت ۳۲ بیتی بزرگ‌تر از صفر باشد.
.SH "مثال‌ها (EXAMPLES)"
نمونه‌برداری از یک بسته از هر ۱۰۰ بسته جاری به درون رابط eth0 به سمت گروه psample شماره ۱۲:

.RS
.EX
tc qdisc add dev eth0 handle ffff: ingress
tc filter add dev eth0 parent ffff: matchall \\
     action sample rate 100 group 12 index 19
.EE
.RE

استفاده از همان نمونه کنش برای نمونه‌برداری از رابط eth1 نیز:

.RS
.EX
tc qdisc add dev eth1 handle ffff: ingress
tc filter add dev eth1 parent ffff: matchall \\
     action sample index 19
.EE
.RE

.SH "همچنین ببینید (SEE ALSO)"
.BR tc (8)،
.BR tc-matchall (8)،
.BR psample (1)