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