نام (NAME)

tipc-link - نمایش پیوندها یا تغییر ویژگی‌های پیوند

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

tipc link set
[ { priority PRIORITY | tolerance TOLERANCE | window WINDOW } link LINK ] |
[ { broadcast [ BROADCAST | REPLICAST | AUTOSELECT [ ratio SIZE ] ] } ]

tipc link get
[ { priority | tolerance | window } link LINK ] |
[ { broadcast } ]

tipc link statistics { show [ link LINK ] | reset link LINK }

tipc link list

tipc link monitor set { threshold }

tipc link monitor get { threshold }

tipc link monitor summary

tipc link monitor list
[ media { eth | ib } device DEVICE ] |
[ media udp name NAME ]

گزینه‌ها (OPTIONS)

گزینه‌ها (فلگ‌ها) که می‌توانند در هر جای زنجیره دستور مشخص شوند.

-h, --help: نمایش راهنما دربارهٔ آخرین دستور معتبر. برای نمونه tipc link --help راهنمای پیوند را نشان می‌دهد و tipc --help راهنمای عمومی را نشان خواهد داد. موقعیت قرارگیری گزینه در رشته دستور تأثیری ندارد.
-j, -json: نمایش خروجی نتایج در قالب نمادگذاری اشیاء جاوااسکریپت (JSON).
-p, -pretty: قالب پیش‌فرض JSON فشرده بوده و پردازش خودکار آن کارآمدتر است اما خواندن آن برای بیشتر کاربران دشوار است. این فلگ برای خوانایی بهتر، فاصله‌گذاری و تورفتگی اضافه می‌کند.

توضیحات (DESCRIPTION)

آمار پیوند (Link statistics)

ACTIVE link state

یک پیوند ACTIVE (فعال) در حال تبادل ترافیک است. دو پیوند به یک گره یکسان در صورتی که دارای priority (اولویت) پیوند یکسانی باشند، می‌توانند به حالت ACTIVE درآیند. اگر بیش از دو پیوند با اولویت یکسان وجود داشته باشد، پیوندهای اضافی در وضعیت STANDBY (آماده‌به‌کار) قرار می‌گیرند.

STANDBY link state

یک پیوند STANDBY اولویت پیوند کمتری نسبت به یک پیوند ACTIVE دارد. در یک پیوند STANDBY ترافیک کنترلی در جریان است و پیوند آماده است تا در صورت از کار افتادن پیوند(های) ACTIVE، انتقال ترافیک را به دست بگیرد.

MTU

حداکثر واحد انتقال (Maximum Transmission Unit). دو نقطه انتهایی، مقدار MTU پیش‌فرض یا پیکربندی‌شده خود را در هنگام راه‌اندازی اولیه پیوند اعلان می‌کنند و در صورت متفاوت بودن، بر سر استفاده از مقدار کمتر توافق خواهند کرد.

Packets

تعداد کل بسته‌های TIPC ارسال‌شده یا دریافت‌شده بر روی یک پیوند؛ از جمله بسته‌های تکه‌تکه‌شده (fragmented) و بسته‌بندی‌شده (bundled).

Fragments

به صورت fragments/fragmented نشان داده می‌شود؛ که در آن fragmented تعداد پیام‌های داده‌ای است که به fragments (قطعات) شکسته شده‌اند. متعاقباً fragments تعداد کل بسته‌هایی است که پیام‌های fragmented به آن‌ها تقسیم شده‌اند.

Bundles

به صورت bundles/bundled نشان داده می‌شود. اگر پیوندی دچار ازدحام شود، سعی می‌کند پیش از ارسال، داده‌های بسته‌های کوچک bundled را در قالب bundles (دسته‌هایی) با اندازه کامل MTU تجمیع و بسته‌بندی کند.

Profile

نمایش‌دهنده اندازه average (میانگین) بسته به بایت/اکتت برای یک sample (نمونه) از بسته‌ها است. همچنین توزیع اندازه بسته‌های نمونه‌برداری‌شده ( sampled) را در بازه‌های زیر نشان می‌دهد:

0-64 bytes
64-256 bytes
256-1024 bytes
1024-4096 bytes
4096-16384 bytes
16384-32768 bytes
32768-66000 bytes

Message counters

states - تعداد پیام‌های وضعیت پیوند

probes - پیام‌های وضعیت پیوند با فلگ probe فعال؛ معمولاً هنگامی که پیوند بی‌کار (idle) است ارسال می‌شوند

nacks - تعداد بسته‌های تصدیق منفی (NACK) ارسال‌شده و دریافت‌شده توسط پیوند

defs - تعداد بسته‌های دریافت‌شده خارج از ترتیب (out of order)

dups - تعداد بسته‌های تکراری دریافت‌شده

Congestion link

تعداد دفعاتی که یک برنامه کاربردی در هنگام ازدحام پیوند TIPC تلاش کرده است داده ارسال کند.

Send queue

Max حداکثر تعداد پیام‌هایی است که در طول دوره جمع‌آوری آمار یک پیوند در صف خروجی قرار داشته‌اند.

Avg میانگین اندازه صف خروجی در طول مدت حیات یک پیوند است.

ویژگی‌های پیوند (Link properties)

priority: اولویت میان پیوندهای منطقی TIPC به یک گره مشخص. اولویت پیوند می‌تواند از 0 (کمترین) تا 31 (بیشترین) باشد.
tolerance: میزان تحمل پیوند (tolerance) حداکثر زمانی را بر حسب میلی‌ثانیه مشخص می‌کند که TIPC پیش از قطع کردن پیوند، اجازه می‌دهد یک مشکل ارتباطی پابرجا بماند. مقدار پیش‌فرض 1500 میلی‌ثانیه است.
window: پنجره پیوند کنترل می‌کند که پیش از فعال شدن سازوکار کنترل ازدحام TIPC، یک نقطه انتهایی پیوند چه تعداد پیام تأییدنشده می‌تواند در صف ارسال خود داشته باشد.

ویژگی‌های پایشگر (Monitor properties)

threshold: آستانه (threshold) اندازه خوشه‌ای را مشخص می‌کند که با فراتر رفتن از آن، الگوریتم پایش پیوند از «مش کامل» (full-mesh) به «حلقه همپوشان» (overlapping-ring) تغییر می‌کند. اگر روی 0 تنظیم شود، پایش حلقه همپوشان همواره فعال است و اگر روی مقداری بزرگتر از اندازه پیش‌بینی‌شده خوشه تنظیم شود، پایش حلقه همپوشان غیرفعال می‌شود. مقدار پیش‌فرض 32 است.

اطلاعات پایشگر (Monitor information)

table_generation: بیانگر شمارش رویدادها در فهرست پایش محلی یک گره است. هر بار که چیزی در فهرست پایش محلی تغییر کند، از جمله تغییرات در دامنه محلی، مقدار آن یک گام افزایش می‌یابد.
cluster_size: بیانگر تعداد اعضای فعلی خوشه است.
algorithm: الگوریتم نظارت فعلی که برای پایش همسایه در حامل (bearer) استفاده می‌شود. مقادیر ممکن عبارتند از full-mesh یا overlapping-ring.
status: وضعیت گره که توسط گره محلی تعیین شده است. وضعیت‌های ممکن up یا down هستند.
monitored: بیانگر نوع پایش انتخاب‌شده توسط گره محلی است. مقادیر ممکن direct یا indirect هستند.
generation: بیانگر نسل دامنه (domain generation) است که شمارش رویدادها در دامنه محلی یک گره می‌باشد. هر بار که تغییری رخ دهد (افزودن/حذف/up/down شدن همتا)، نسل دامنه یک گام افزایش می‌یابد و نسخه جدیدی از رکورد گره ارسال می‌شود تا همسایگان را از این تغییر مطلع سازد. نسل دامنه به دریافت‌کننده یک رکورد دامنه کمک می‌کند تا بداند آیا باید رکورد را نادیده بگیرد یا پردازش کند.
applied_node_status: وضعیت گره گزارش‌شده توسط گره همتا برای همتاهای بعدی در فهرست گره‌ها. فهرست گره‌ها یک فهرست حلقوی از نشانی‌های صعودی است که با گره محلی آغاز می‌شود. وضعیت‌های ممکن عبارتند از: U یا D. وضعیت U به معنای up و D به معنای down است.
[non_applied_node:status]: بیانگر گره‌ها و وضعیت آن‌ها است به صورتی که توسط گره همتا گزارش شده است. این گره‌ها بر روی فهرست پایش این گره همتا اعمال نشده‌اند. آن‌ها معمولاً گذرا هستند و در طول مرحله راه‌اندازی خوشه یا بازپیکربندی شبکه رخ می‌دهند. وضعیت‌های ممکن عبارتند از: U یا D. وضعیت U به معنای up و D به معنای down است.

ویژگی‌های پخش همگانی (Broadcast properties)

BROADCAST: صرف‌نظر از اندازه خوشه و تعداد مقصدها، تمام ترافیک چندپخشی (multicast) را وادار می‌کند که تنها از طریق پخش همگانی (broadcast) ارسال شود.
REPLICAST: صرف‌نظر از اندازه خوشه و تعداد مقصدها، تمام ترافیک چندپخشی را وادار می‌کند که تنها از طریق تکثیر پخشی (replicast) ارسال شود.
AUTOSELECT: سوئیچ خودکار بین broadcast یا replicast بسته به اندازه خوشه و تعداد گره‌های مقصد.
ratio SIZE: تنظیم معیار AUTOSELECT؛ درصد گره‌های مقصد نسبت به اندازه خوشه.

مثال‌ها (EXAMPLES)

tipc link monitor list

نمایش اطلاعات پایش پیوند برای اعضای خوشه بر روی دستگاه data0.

tipc link monitor summary

دستور monitor summary مشخصه‌های اساسی را نمایش می‌دهد.

وضعیت خروج (EXIT STATUS)

در صورت اجرای موفقیت‌آمیز دستور، وضعیت خروج 0 و در صورت بروز خطا، یک عدد صحیح مثبت است.

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

tipc(8), tipc-media(8), tipc-bearer(8), tipc-nametable(8), tipc-node(8), tipc-peer(8), tipc-socket(8)

گزارش باگ‌ها (REPORTING BUGS)

هرگونه باگ را به فهرست پستی توسعه‌دهندگان شبکه <netdev@vger.kernel.org> که توسعه و نگهداری اصلی در آنجا انجام می‌شود گزارش دهید. برای ارسال پیام به آنجا نیازی به عضویت در فهرست پستی ندارید.

نویسنده (AUTHOR)

Richard Alpe <richard.alpe@ericsson.com>