نام (NAME)

ibccquery - پرس‌وجوی تنظیمات و اطلاعات کنترل ازدحام اینفینی‌باند

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

ibccquery [گزینه‌های_مشترک] [-c cckey] <عملیات> <lid|guid> [درگاه]

توضیحات (DESCRIPTION)

ابزار ibccquery از پرس‌وجوی تنظیمات و سایر اطلاعات مربوط به کنترل ازدحام (Congestion Control) در شبکه اینفینی‌باند پشتیبانی می‌کند.

گزینه‌ها (OPTIONS)

عملیات‌های پشتیبانی‌شده کنونی و پارامترهای آن‌ها:: CongestionInfo (CI) <addr> CongestionKeyInfo (CK) <addr> CongestionLog (CL) <addr> SwitchCongestionSetting (SS) <addr> SwitchPortCongestionSetting (SP) <addr> [<portnum>] CACongestionSetting (CS) <addr> CongestionControlTable (CT) <addr> Timestamp (TI) <addr>

--cckey, -c <cckey> تعیین کلید کنترل ازدحام (CC key). اگر هیچ کلیدی مشخص نشود، از کلید ۰ استفاده می‌شود.

فلگ‌های اشکال‌زدایی (Debugging flags)

-d: افزایش سطح اشکال‌زدایی IB. می‌تواند چندین بار استفاده شود (-ddd یا -d -d -d).

-e: نمایش خطاهای ارسال و دریافت (اتمام مهلت و سایر موارد)

-h, --help نمایش پیام راهنمای استفاده

-v, --verbose: افزایش سطح جزئیات برنامه. می‌تواند چندین بار استفاده شود (-vv یا -v -v -v)

-V, --version نمایش اطلاعات نسخه.

فلگ‌های آدرس‌دهی (Addressing Flags)

-G, --Guid نشانی مشخص‌شده GUID درگاه (Port GUID) است

-L, --Lid نشانی مشخص‌شده LID است

-s, --sm_port <smlid> استفاده از «smlid» به عنوان LID مقصد برای پرس‌وجوهای SA.

فلگ‌های انتخاب درگاه (Port Selection flags)

-C, --Ca <ca_name> استفاده از ca_name مشخص‌شده.

-P, --Port <ca_port> استفاده از ca_port مشخص‌شده.

-Y, --pkey-idx <idx>: نمایه جدول P_Key (۰ تا ۶۵۵۳۵، پیش‌فرض ۰) مورد استفاده برای MADهای خروجی SA/GMP. بسته‌های MAD مربوط به SMP (مسیردهی هدایت‌شده SMI یا با LID) همواره از نمایه ۰ کلید P_Key استفاده می‌کنند.

انتخاب درگاه محلی (Local port Selection)

پشتیبانی از چند درگاه/چند CA: در صورتی که هیچ دستگاه یا درگاه IB مشخص نشود (بخش «پارامترهای محلی umad» در زیر را ببینید)، کتابخانه libibumad درگاه مورد استفاده را بر اساس معیارهای زیر انتخاب می‌کند:

1.: اولین درگاهی که فعال (ACTIVE) باشد.
2.: در صورت نیافتن، اولین درگاهی که بالا باشد (پیوند فیزیکی UP).

اگر نام درگاه یا CA مشخص شده باشد، کتابخانه libibumad تلاش می‌کند درخواست کاربر را برآورده کند و در صورت عدم امکان، با خطا متوقف می‌شود.

برای نمونه:

ibaddr                 # استفاده از درگاه اول (معیار ۱ بالا)
ibaddr -C mthca1       # انتخاب بهترین درگاه تنها از mthca1
ibaddr -P 2            # استفاده از درگاه دوم (فعال/بالا) از اولین دستگاه IB موجود
ibaddr -C mthca0 -P 2  # استفاده منحصراً از درگاه مشخص‌شده

فلگ‌های پیکربندی (Configuration flags)

-y, --m_key <key>: استفاده از M_key مشخص‌شده برای درخواست‌ها. اگر مقداری غیرعددی (مانند 'x') مشخص شود، مقدار به صورت تعاملی درخواست خواهد شد.

--config, -z <config_file> تعیین فایل پیکربندی جایگزین.

پیش‌فرض: /etc/infiniband-diags/ibdiag.conf

فایل‌ها (FILES)

فایل پیکربندی (CONFIG FILE)

/etc/infiniband-diags/ibdiag.conf

یک فایل پیکربندی سراسری برای تنظیم برخی از گزینه‌های مشترک برای همه ابزارها ارائه شده است. برای جزئیات به فایل پیکربندی ارائه‌شده مراجعه کنید.

مثال‌ها (EXAMPLES)

ibccquery CongestionInfo 3              # اطلاعات ازدحام بر اساس lid
ibccquery SwitchPortCongestionSetting 3 # پرس‌وجوی تمامی تنظیمات ازدحام درگاه سوئیچ
ibccquery SwitchPortCongestionSetting 3 1 # پرس‌وجوی تنظیمات ازدحام برای درگاه ۱

نویسنده (AUTHOR)

Albert Chu: < <chu11@llnl.gov> >