IBCCQUERY(8)                  OpenIB Diagnostics                  IBCCQUERY(8)

نام (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> >

                                  2012-05-31                      IBCCQUERY(8)