.TH TIPC-LINK 8 "22 Mar 2019" "iproute2" "Linux" .\" For consistency, please keep padding right aligned. .\" For example '.B "foo " bar' and not '.B foo " bar"' .SH "نام (NAME)" tipc-link \- نمایش پیوندها یا تغییر ویژگی‌های پیوند .SH "خلاصه دستور (SYNOPSIS)" .ad l .in +8 .ti -8 .ti -8 .B tipc link set .br .RB "[ " "{ " "priority " .IR PRIORITY .RB "| " tolerance .IR TOLERANCE .RB "| " window .IR "WINDOW " } .BI "link " LINK " ]" .RB "|" .br .RB "[ " .RB "{ " broadcast " [ " .IR BROADCAST .RB " | " .IR REPLICAST .RB " | " .IR AUTOSELECT .RB "[ " ratio .IR SIZE .RB "] " ] " } " "]" .ti -8 .B tipc link get .br .RB "[ " "{ " "priority" " | " tolerance " | " window " } " link .IR LINK " ] " .RB "|" .br .RB "[ " { " broadcast " } " ]" .br .ti -8 .B tipc link statistics .RB "{ " "show " "[ " link .I LINK .RB "] | " "reset " .BI "link " "LINK " } .ti -8 .B tipc link list .br .ti -8 .B tipc link monitor set .RB "{ " "threshold" " } " .ti -8 .B tipc link monitor get .RB "{ " "threshold" " } " .ti -8 .B tipc link monitor summary .br .ti -8 .B tipc link monitor list .br .RB "[ " "media " " { " eth " | " ib " } " device .IR "DEVICE" " ]" .RB "|" .br .RB "[ " "media udp name" .IR NAME " ]" .br .SH "گزینه‌ها (OPTIONS)" گزینه‌ها (فلگ‌ها) که می‌توانند در هر جای زنجیره دستور مشخص شوند. .TP .BR "\-h" , " --help" نمایش راهنما دربارهٔ آخرین دستور معتبر. برای نمونه .B tipc link --help راهنمای پیوند را نشان می‌دهد و .B tipc --help راهنمای عمومی را نشان خواهد داد. موقعیت قرارگیری گزینه در رشته دستور تأثیری ندارد. .TP .BR "\-j", " \-json" نمایش خروجی نتایج در قالب نمادگذاری اشیاء جاوااسکریپت (JSON). .TP .BR "\-p", " \-pretty" قالب پیش‌فرض JSON فشرده بوده و پردازش خودکار آن کارآمدتر است اما خواندن آن برای بیشتر کاربران دشوار است. این فلگ برای خوانایی بهتر، فاصله‌گذاری و تورفتگی اضافه می‌کند. .SH "توضیحات (DESCRIPTION)" .SS "آمار پیوند (Link statistics)" .TP .BR "ACTIVE " "link state" .br یک پیوند .B ACTIVE (فعال) در حال تبادل ترافیک است. دو پیوند به یک گره یکسان در صورتی که دارای .B priority (اولویت) پیوند یکسانی باشند، می‌توانند به حالت .B ACTIVE درآیند. اگر بیش از دو پیوند با اولویت یکسان وجود داشته باشد، پیوندهای اضافی در وضعیت .B STANDBY (آماده‌به‌کار) قرار می‌گیرند. .TP .BR "STANDBY " "link state" .br یک پیوند .B STANDBY اولویت پیوند کمتری نسبت به یک پیوند .B ACTIVE دارد. در یک پیوند .B STANDBY ترافیک کنترلی در جریان است و پیوند آماده است تا در صورت از کار افتادن پیوند(های) .BR ACTIVE ، انتقال ترافیک را به دست بگیرد. .TP .B MTU .br حداکثر واحد انتقال (Maximum Transmission Unit). دو نقطه انتهایی، مقدار .B MTU پیش‌فرض یا پیکربندی‌شده خود را در هنگام راه‌اندازی اولیه پیوند اعلان می‌کنند و در صورت متفاوت بودن، بر سر استفاده از مقدار کمتر توافق خواهند کرد. .TP .B Packets .br تعداد کل بسته‌های TIPC ارسال‌شده یا دریافت‌شده بر روی یک پیوند؛ از جمله بسته‌های .BR "تکه‌تکه‌شده (fragmented) " "و " "بسته‌بندی‌شده (bundled)" . .TP .B Fragments .br به صورت .BR fragments / fragmented نشان داده می‌شود؛ که در آن .B fragmented تعداد پیام‌های داده‌ای است که به .B fragments (قطعات) شکسته شده‌اند. متعاقباً .B fragments تعداد کل بسته‌هایی است که پیام‌های .B fragmented به آن‌ها تقسیم شده‌اند. .TP .B Bundles .br به صورت .BR bundles / bundled نشان داده می‌شود. اگر پیوندی دچار ازدحام شود، سعی می‌کند پیش از ارسال، داده‌های بسته‌های کوچک .B bundled را در قالب .B bundles (دسته‌هایی) با اندازه کامل MTU تجمیع و بسته‌بندی کند. .TP .B Profile .br نمایش‌دهنده اندازه .B average (میانگین) بسته به بایت/اکتت برای یک .B sample (نمونه) از بسته‌ها است. همچنین توزیع اندازه بسته‌های نمونه‌برداری‌شده ( .BR sampled ) را در بازه‌های زیر نشان می‌دهد: 0-64 bytes .br 64-256 bytes .br 256-1024 bytes .br 1024-4096 bytes .br 4096-16384 bytes .br 16384-32768 bytes .br 32768-66000 bytes .TP .B Message counters .B states \- تعداد پیام‌های وضعیت پیوند .sp .B probes \- پیام‌های وضعیت پیوند با فلگ probe فعال؛ معمولاً هنگامی که پیوند بی‌کار (idle) است ارسال می‌شوند .sp .B nacks \- تعداد بسته‌های تصدیق منفی (NACK) ارسال‌شده و دریافت‌شده توسط پیوند .sp .B defs \- تعداد بسته‌های دریافت‌شده خارج از ترتیب (out of order) .sp .B dups \- تعداد بسته‌های تکراری دریافت‌شده .TP .B Congestion link تعداد دفعاتی که یک برنامه کاربردی در هنگام ازدحام پیوند TIPC تلاش کرده است داده ارسال کند. .TP .B Send queue .B Max حداکثر تعداد پیام‌هایی است که در طول دوره جمع‌آوری آمار یک پیوند در صف خروجی قرار داشته‌اند. .B Avg میانگین اندازه صف خروجی در طول مدت حیات یک پیوند است. .SS "ویژگی‌های پیوند (Link properties)" .TP .B priority .br اولویت میان پیوندهای منطقی TIPC به یک گره مشخص. اولویت پیوند می‌تواند از 0 (کمترین) تا 31 (بیشترین) باشد. .TP .B tolerance .br میزان تحمل پیوند (tolerance) حداکثر زمانی را بر حسب میلی‌ثانیه مشخص می‌کند که TIPC پیش از قطع کردن پیوند، اجازه می‌دهد یک مشکل ارتباطی پابرجا بماند. مقدار پیش‌فرض 1500 میلی‌ثانیه است. .TP .B window .br پنجره پیوند کنترل می‌کند که پیش از فعال شدن سازوکار کنترل ازدحام TIPC، یک نقطه انتهایی پیوند چه تعداد پیام تأییدنشده می‌تواند در صف ارسال خود داشته باشد. .SS "ویژگی‌های پایشگر (Monitor properties)" .TP .B threshold .br آستانه (threshold) اندازه خوشه‌ای را مشخص می‌کند که با فراتر رفتن از آن، الگوریتم پایش پیوند از «مش کامل» (full-mesh) به «حلقه همپوشان» (overlapping-ring) تغییر می‌کند. اگر روی 0 تنظیم شود، پایش حلقه همپوشان همواره فعال است و اگر روی مقداری بزرگتر از اندازه پیش‌بینی‌شده خوشه تنظیم شود، پایش حلقه همپوشان غیرفعال می‌شود. مقدار پیش‌فرض 32 است. .SS "اطلاعات پایشگر (Monitor information)" .TP .B table_generation .br بیانگر شمارش رویدادها در فهرست پایش محلی یک گره است. هر بار که چیزی در فهرست پایش محلی تغییر کند، از جمله تغییرات در دامنه محلی، مقدار آن یک گام افزایش می‌یابد. .TP .B cluster_size .br بیانگر تعداد اعضای فعلی خوشه است. .TP .B algorithm .br الگوریتم نظارت فعلی که برای پایش همسایه در حامل (bearer) استفاده می‌شود. مقادیر ممکن عبارتند از full-mesh یا overlapping-ring. .TP .B status .br وضعیت گره که توسط گره محلی تعیین شده است. وضعیت‌های ممکن up یا down هستند. .TP .B monitored .br بیانگر نوع پایش انتخاب‌شده توسط گره محلی است. مقادیر ممکن direct یا indirect هستند. .TP .B generation .br بیانگر نسل دامنه (domain generation) است که شمارش رویدادها در دامنه محلی یک گره می‌باشد. هر بار که تغییری رخ دهد (افزودن/حذف/up/down شدن همتا)، نسل دامنه یک گام افزایش می‌یابد و نسخه جدیدی از رکورد گره ارسال می‌شود تا همسایگان را از این تغییر مطلع سازد. نسل دامنه به دریافت‌کننده یک رکورد دامنه کمک می‌کند تا بداند آیا باید رکورد را نادیده بگیرد یا پردازش کند. .TP .B applied_node_status .br وضعیت گره گزارش‌شده توسط گره همتا برای همتاهای بعدی در فهرست گره‌ها. فهرست گره‌ها یک فهرست حلقوی از نشانی‌های صعودی است که با گره محلی آغاز می‌شود. وضعیت‌های ممکن عبارتند از: U یا D. وضعیت U به معنای up و D به معنای down است. .TP .B [non_applied_node:status] .br بیانگر گره‌ها و وضعیت آن‌ها است به صورتی که توسط گره همتا گزارش شده است. این گره‌ها بر روی فهرست پایش این گره همتا اعمال نشده‌اند. آن‌ها معمولاً گذرا هستند و در طول مرحله راه‌اندازی خوشه یا بازپیکربندی شبکه رخ می‌دهند. وضعیت‌های ممکن عبارتند از: U یا D. وضعیت U به معنای up و D به معنای down است. .SS "ویژگی‌های پخش همگانی (Broadcast properties)" .TP .B BROADCAST .br صرف‌نظر از اندازه خوشه و تعداد مقصدها، تمام ترافیک چندپخشی (multicast) را وادار می‌کند که تنها از طریق پخش همگانی (broadcast) ارسال شود. .TP .B REPLICAST .br صرف‌نظر از اندازه خوشه و تعداد مقصدها، تمام ترافیک چندپخشی را وادار می‌کند که تنها از طریق تکثیر پخشی (replicast) ارسال شود. .TP .B AUTOSELECT .br سوئیچ خودکار بین broadcast یا replicast بسته به اندازه خوشه و تعداد گره‌های مقصد. .TP .B ratio SIZE .br تنظیم معیار AUTOSELECT؛ درصد گره‌های مقصد نسبت به اندازه خوشه. .SH "مثال‌ها (EXAMPLES)" .PP tipc link monitor list .RS 4 نمایش اطلاعات پایش پیوند برای اعضای خوشه بر روی دستگاه data0. .RE .PP tipc link monitor summary .RS 4 دستور monitor summary مشخصه‌های اساسی را نمایش می‌دهد. .RE .SH "وضعیت خروج (EXIT STATUS)" در صورت اجرای موفقیت‌آمیز دستور، وضعیت خروج 0 و در صورت بروز خطا، یک عدد صحیح مثبت است. .SH "همچنین ببینید (SEE ALSO)" .BR tipc (8), .BR tipc-media (8), .BR tipc-bearer (8), .BR tipc-nametable (8), .BR tipc-node (8), .BR tipc-peer (8), .BR tipc-socket (8) .br .SH "گزارش باگ‌ها (REPORTING BUGS)" هرگونه باگ را به فهرست پستی توسعه‌دهندگان شبکه .B که توسعه و نگهداری اصلی در آنجا انجام می‌شود گزارش دهید. برای ارسال پیام به آنجا نیازی به عضویت در فهرست پستی ندارید. .SH "نویسنده (AUTHOR)" Richard Alpe