vendstat(8)                   Open IB Diagnostics                  vendstat(8)

نام (NAME)
       vendstat - پرس‌وجوی توابع خاص سازنده در InfiniBand

خلاصه دستور (SYNOPSIS)
       vendstat [گزینه‌ها] <lid|guid>

توضیحات (DESCRIPTION)
       دستور vendstat از بسته‌های داده مدیریتی (MAD) خاص سازنده برای دسترسی به
       قابلیت‌های ویژه سازنده فراتر از مشخصات استاندارد اینفینی‌بند (IB) استفاده
       می‌کند. در حال حاضر، از سوئیچ‌های InfiniSwitch-III (IS3) و
       InfiniSwitch-IV (IS4) شرکت Mellanox پشتیبانی می‌شود.

گزینه‌ها (OPTIONS)

       -N     نمایش اطلاعات عمومی IS3 یا IS4.

       -w     نمایش شمارنده‌های انتظار ارسال درگاه (xmit wait) در IS3.

       -i     نمایش اطلاعات گروه شمارنده در IS4.

       -c <num,num>
              پیکربندی گروه‌های شمارنده IS4.

              پیکربندی گروه‌های شمارنده ۰ و ۱ در IS4. این پیکربندی پس از
              راه‌اندازی مجدد IS4 پایدار نمی‌ماند. عدد اول برای گروه شمارنده ۰ و
              عدد دوم برای گروه شمارنده ۱ است.

              مقادیر پیکربندی شمارنده گروه ۰:

                  0 - PortXmitDataSL0-7
                  1 - PortXmitDataSL8-15
                  2 - PortRcvDataSL0-7

          مقادیر پیکربندی شمارنده گروه ۱:

          1 - PortXmitDataSL8-15
          2 - PortRcvDataSL0-7
          8 - PortRcvDataSL8-15

       -R, --Read <addr,mask>
              خواندن رکورد فضای پیکربندی در نشانی addr

       -W, --Write <addr,val,mask>
              نوشتن رکورد فضای پیکربندی در نشانی addr

   پرچم‌های آدرس‌دهی (Addressing Flags)
       -G, --Guid     نشانی مشخص‌شده یک 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.  بسته‌های SMP (مسیر هدایت‌شده SMI / مسیر LID)
              همیشه از شاخص ۰ در P_Key استفاده می‌کنند.

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

          1. نخستین درگاهی که فعال (ACTIVE) باشد.

          2. در صورت نیافتن، نخستین درگاهی که بالا (UP، پیوند فیزیکی برقرار)
             باشد.

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

          به عنوان مثال:

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

   پرچم‌های اشکال‌زدایی (Debugging Flags)

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

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

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

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

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

   پرچم‌های پیکربندی (Configuration Flags)
       -t, --timeout <timeout_ms> بازنویسی مهلت زمانی پیش‌فرض برای بسته‌های MAD
       درخواستی.

       --config, -z  <config_file> تعیین فایل پیکربندی جایگزین.
          پیش‌فرض: /etc/infiniband-diags/ibdiag.conf

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

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

مثال‌ها (EXAMPLES)

          vendstat -N 6           # خواندن اطلاعات عمومی IS3 یا IS4
          vendstat -w 6           # خواندن شمارنده‌های انتظار ارسال درگاه در IS3
          vendstat -i 6 12        # خواندن اطلاعات گروه شمارنده درگاه ۱۲ در IS4
          vendstat -c 0,1 6 12    # پیکربندی گروه‌های شمارنده درگاه ۱۲ در IS4 برای PortXmitDataSL
          vendstat -c 2,8 6 12    # پیکربندی گروه‌های شمارنده درگاه ۱۲ در IS4 برای PortRcvDataSL

نویسنده (AUTHOR)

       Hal Rosenstock
              < <hal.rosenstock@gmail.com> >

                                  2017-08-21                       vendstat(8)