IBCCCONFIG(8)                 OpenIB Diagnostics                 IBCCCONFIG(8)

نام (NAME)
       ibccconfig - پیکربندی تنظیمات کنترل ازدحام

خلاصه دستور (SYNOPSIS)
       ibccconfig [common_options] [-c cckey] <op> <lid|guid> [port]

توضیحات (DESCRIPTION)
       ibccconfig از پیکربندی تنظیمات کنترل ازدحام روی سوئیچ‌ها و HCAها
       پشتیبانی می‌کند.

       هشدار -- پیش از استفاده از این ابزار باید کاملاً بدانید چه کاری انجام
       می‌دهید. استفاده نادرست از این ابزار می‌تواند منجر به از کار افتادن یا
       خرابی بستر شبکه (فابریک) شود.

گزینه‌ها (OPTIONS)

       عملیات‌های پشتیبانی‌شده کنونی و پارامترهای آن‌ها:
              CongestionKeyInfo (CK) <lid|guid> <cckey> <cckeyprotectbit>
              <cckeyleaseperiod> <cckeyviolations> SwitchCongestionSetting
              (SS) <lid|guid> <controlmap> <victimmask> <creditmask>
              <threshold> <packetsize> <csthreshold> <csreturndelay>
              <markingrate> SwitchPortCongestionSetting (SP) <lid|guid>
              <portnum> <valid> <control_type> <threshold> <packet_size>
              <cong_parm_marking_rate> CACongestionSetting (CS) <lid|guid>
              <port_control> <control_map> <ccti_timer> <ccti_increase>
              <trigger_threshold> <ccti_min> CongestionControlTable (CT)
              <lid|guid> <cctilimit> <index> <cctentry> <cctentry> ...

       --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

مثال‌ها (EXAMPLES)

          ibccconfig SwitchCongestionSetting 2 0x1F 0x1FFFFFFFFF 0x0 0xF 8 0 0:0 1  # پیکربندی تنظیمات کنترل ازدحام سوئیچ
          ibccconfig CACongestionSetting 1 0 0x3 150 1 0 0                          # پیکربندی تنظیمات کنترل ازدحام CA برای SL 0 و SL 1
          ibccconfig CACongestionSetting 1 0 0x4 200 1 0 0                          # پیکربندی تنظیمات کنترل ازدحام CA برای SL 2
          ibccconfig CongestionControlTable 1 63 0 0:0 0:1 ...                      # پیکربندی بلوک اول جدول کنترل ازدحام
          ibccconfig CongestionControlTable 1 127 0 0:64 0:65 ...                   # پیکربندی بلوک دوم جدول کنترل ازدحام

فایل‌ها (FILES)
   فایل پیکربندی (CONFIG FILE)
       /etc/infiniband-diags/ibdiag.conf

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

نویسنده (AUTHOR)

       Albert Chu
              < <chu11@llnl.gov> >

                                  2012-05-31                     IBCCCONFIG(8)