نام (NAME)

netshaper - نمایش و مدیریت پیکربندی شکلدهی سختافزاری دستگاه شبکه

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

netshaper [ OPTIONS ] { COMMAND | help }

OPTIONS := { -V[ersion] | -c[olor] | -help }

netshaper set dev DEV handle scope HANDLE_SCOPE [ id HANDLE_ID ] [ bw-min BW_MIN ] [ bw-max BW_MAX ] [ weight WEIGHT ]

netshaper { show | delete } dev DEV handle scope HANDLE_SCOPE [ id HANDLE_ID ]

netshaper group dev DEV handle scope { node | netdev } [ id HANDLE_ID ] [ parent scope { netdev [ id PARENT_ID ] | node id PARENT_ID } ] [ bw-min BW_MIN ] [ bw-max BW_MAX ] [ weight WEIGHT ] leaves LEAF_SPEC [ LEAF_SPEC ... ]

LEAF_SPEC := scope queue id ID [ weight WEIGHT ] [ priority PRIO ]

توضیحات (DESCRIPTION)

دستور netshaper امکان پیکربندی و مدیریت قابلیت‌های محدودسازی نرخ ترافیک سخت‌افزاری (شکل‌دهی) موجود بر روی دستگاه‌های شبکه را فراهم می‌کند. این رابط برنامه‌نویسی (API) امکان کنترل شکل‌دهنده‌ها را در سطوح گوناگون از جمله دستگاه‌های شبکه، صف‌ها و گره‌های زمان‌بندی مهیا ساخته و دستکاری درخت زمان‌بندی دستگاه را ممکن می‌سازد.

هر شکل‌دهنده در یک دستگاه به‌طور یکتا با یک handle (دستگیره) مشخص می‌شود که شامل یک scope (دامنه) و یک id (شناسه) اختیاری است. بسته به مقدار دامنه، شکل‌دهنده‌ها به اشیاء سخت‌افزاری خاصی متصل می‌شوند:

netdev

شکل‌دهنده‌های متصل به کل دستگاه شبکه. پارامتر id برای این دامنه اختیاری است (در صورت عدم تعیین، مقدار پیش‌فرض آن 0 خواهد بود).

queue

شکل‌دهنده‌های متصل به صف‌های مشخص دستگاه. پارامتر id الزامی بوده و شماره صف را مشخص می‌کند.

node

گره‌های زمان‌بندی میانی که می‌توانند در مکان‌های دلخواه از درخت زمان‌بندی قرار گیرند. پارامتر id برای دستورات set، show و delete الزامی است. برای دستور group این پارامتر اختیاری است؛ در صورت حذف، هسته به‌طور خودکار یک شناسه اختصاص می‌دهد.

دستورات (COMMANDS)

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

dev DEV

نام دستگاه شبکه‌ای را مشخص می‌کند که عملیات روی آن انجام می‌شود.

handle

دستگیره شکل‌دهنده را تعریف می‌کند که متشکل از موارد زیر است:

bw-min BW_MIN

حداقل پهنای باند تضمین‌شده برای شکل‌دهنده. مقادیر با پسوندهای زیر را می‌پذیرد: kbit، mbit، gbit به‌ترتیب برای کیلوبیت، مگابیت و گیگابیت بر ثانیه.

bw-max BW_MAX

حداکثر سقف پهنای باند برای شکل‌دهنده. همان پسوندهای bw-min را می‌پذیرد.

weight WEIGHT

وزن زمان‌بندی برای شکل‌دهنده که برای تسهیم عادلانه وزن‌دار بین گره‌های همتا زیر همان گره والد به کار می‌رود. مقدار آن یک عدد صحیح بدون علامت است.

parent

والد را برای دستور group تعریف می‌کند. دامنه والد باید node یا netdev باشد؛ queue به‌عنوان دامنه والد معتبر نیست. برای دامنه والد node، پارامتر id الزامی است. برای دامنه والد netdev، پارامتر id اختیاری است. در صورت حذف، والد از والد فعلی برگ‌ها به ارث برده می‌شود که این امر مستلزم آن است که همه برگ‌ها دارای یک والد مشترک باشند.

leaves

یک یا چند شکل‌دهنده برگ را برای اتصال به گروه مشخص می‌کند. هر برگ باید از دامنه queue استفاده کند؛ هیچ دامنه دیگری برای برگ‌ها پذیرفته نمی‌شود. هر برگ به‌صورت scope queue id ID مشخص می‌شود، به همراه پارامترهای اختیاری weight و priority برای زمان‌بندی به ازای هر صف در داخل گروه. چندین برگ را می‌توان به‌صورت پشت‌سرهم مشخص کرد.

گزینه‌ها (OPTIONS)

-V, -Version

چاپ نسخه ابزار netshaper و خروج.

-c[color] = {always | auto | never}

پیکربندی خروجی رنگی. اگر پارامتر حذف شود یا برابر با always باشد، خروجی رنگی صرف‌نظر از وضعیت stdout فعال می‌شود. اگر پارامتر برابر با auto باشد، وضعیت ترمینال بودن stdout پیش از فعال‌سازی خروجی رنگی بررسی می‌شود. اگر پارامتر برابر با never باشد، خروجی رنگی غیرفعال می‌گردد. در صورت مشخص شدن چندباره، آخرین مورد اولویت خواهد داشت.

-help

نمایش اطلاعات نحوه استفاده و خروج.

مثال‌ها (EXAMPLES)

مثال ۱: ایجاد یک شکل‌دهنده در سطح دستگاه

# netshaper set dev foo handle scope netdev bw-max 10gbit

مثال ۲: تنظیم پهنای باند و وزن روی شکل‌دهنده صف

# netshaper set dev foo handle scope queue id 0 \
    bw-min 1gbit bw-max 5gbit weight 10

مثال ۳: نمایش پیکربندی شکل‌دهنده

# netshaper show dev foo handle scope netdev

مثال ۴: ایجاد سلسله‌مراتب زمان‌بندی با group

# netshaper group dev foo handle scope node \
    parent scope netdev bw-max 10gbit \
    leaves scope queue id 0 weight 3 \
    scope queue id 1 weight 2

مثال ۵: حذف پیکربندی شکل‌دهنده

# netshaper delete dev foo handle scope netdev

نکات (NOTES)

• برای دامنه netdev، پارامتر id اختیاری است و در صورت عدم تعیین، به‌طور پیش‌فرض 0 خواهد بود.
• برای دامنه‌های queue و node، پارامتر id الزامی است. برای دستور group، شناسه id گره می‌تواند حذف شود تا هسته به‌طور خودکار شناسه‌ای اختصاص دهد.
• مقادیر پهنای باند از پسوندهای استاندارد پشتیبانی می‌کنند: kbit (کیلوبیت بر ثانیه)، mbit (مگابیت بر ثانیه)، gbit (گیگابیت بر ثانیه).
• دستور group برگ‌های صف را در یک عملیات اتمیک (تجزیه‌ناپذیر) منفرد به دستگیره netdev یا node متصل می‌کند.

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

ip(8), ip-link(8), tc(8)

نویسنده (AUTHOR)

Erni Sri Satya Vennela <ernis@linux.microsoft.com>
Mohsin Bashir <hmohsin@meta.com>