نام (NAME)

perfquery - پرس‌وجوی شمارنده‌های درگاه InfiniBand روی یک درگاه منفرد

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

perfquery [گزینه‌ها] [<lid|guid> [[درگاه(ها)] [reset_mask]]]

توضیحات (DESCRIPTION)

دستور perfquery از پیام‌های GMP مدیریت کارایی (PerfMgt GMPs) برای دریافت PortCounters (شمارنده‌های کارایی پایه و خطا)، PortExtendedCounters ،PortXmitDataSL ،PortRcvDataSL ،PortRcvErrorDetails ،PortXmitDiscardDetails ،PortExtendedSpeedsCounters یا PortSamplesControl از PMA در گره/درگاه مشخص‌شده استفاده می‌کند. به صورت اختیاری شمارنده‌های تجمیع‌شده را برای تمام درگاه‌های گره نمایش می‌دهد. در نهایت می‌تواند شمارنده‌ها را پس از خواندن بازنشانی کند، یا صرفاً بازنشانی شمارنده‌ها را انجام دهد.

نکته: در PortCounters ،PortCountersExtended ،PortXmitDataSL و PortRcvDataSL، مؤلفه‌هایی که نشان‌دهنده داده هستند (مانند PortXmitData و PortRcvData) به جای بایت‌های تنها، هشت‌تایی‌ها (اکتت‌ها) تقسیم بر ۴ را نشان می‌دهند.

نکته: وارد کردن درگاه ۲۵۵ نشان می‌دهد که عملیات روی همه درگاه‌ها انجام شود.

نکته: برای PortCounters ،ExtendedCounters و بازنشانی‌ها، چندین درگاه را می‌توان با فهرستی جداشده با کاما یا محدوده‌ای از درگاه‌ها مشخص کرد. مثال‌های زیر را ببینید.

گزینه‌ها (OPTIONS)

-x, --extended: نمایش شمارنده‌های گسترش‌یافته درگاه به جای شمارنده‌های (پایه) درگاه. توجه داشته باشید که مشخصه شمارنده‌های گسترش‌یافته درگاه اختیاری است.
-X, --xmtsl: نمایش شمارنده داده‌های ارسالی SL. این یک شمارنده اختیاری برای QoS است.
-S, --rcvsl: نمایش شمارنده داده‌های دریافتی SL. این یک شمارنده اختیاری برای QoS است.
-D, --xmtdisc: نمایش جزئیات دور ریختن (discard) در ارسال. این یک شمارنده اختیاری است.
-E, --rcverr: نمایش جزئیات خطای دریافت. این یک شمارنده اختیاری است.
-D, --xmtdisc: نمایش جزئیات دور ریختن در ارسال. این یک شمارنده اختیاری است.
-T, --extended_speeds: نمایش شمارنده‌های درگاه برای سرعت‌های گسترش‌یافته. این یک شمارنده اختیاری است.
--oprcvcounters: نمایش شمارنده‌های دریافتی به ازای هر Op code. این یک شمارنده اختیاری است.
--flowctlcounters: نمایش شمارنده‌های کنترل جریان. این یک شمارنده اختیاری است.
--vloppackets: نمایش بسته‌های دریافتی به ازای هر کد عملیات در هر VL. این یک شمارنده اختیاری است.
--vlopdata: نمایش داده‌های دریافتی به ازای هر کد عملیات در هر VL. این یک شمارنده اختیاری است.
--vlxmitflowctlerrors: نمایش خطاهای به‌روزرسانی کنترل جریان ارسال در هر VL. این یک شمارنده اختیاری است.
--vlxmitcounters: نمایش تیک‌های در انتظار ارسال برای شمارنده‌ها در هر VL. این یک شمارنده اختیاری است.
--swportvlcong: نمایش ازدحام درگاه سوئیچ VL. این یک شمارنده اختیاری است.
--rcvcc: نمایش شمارنده‌های کنترل ازدحام دریافت. این یک شمارنده اختیاری است.
--slrcvfecn: نمایش شمارنده‌های FECN دریافتی SL. این یک شمارنده اختیاری است.
--slrcvbecn: نمایش شمارنده‌های BECN دریافتی SL. این یک شمارنده اختیاری است.
--xmitcc: نمایش شمارنده‌های کنترل ازدحام ارسال. این یک شمارنده اختیاری است.
--vlxmittimecc: نمایش شمارنده‌های کنترل ازدحام زمان ارسال VL. این یک شمارنده اختیاری است.
-c, --smplctl: نمایش کنترل نمونه‌های درگاه.
-a, --all_ports: نمایش شمارنده‌های تجمیع‌شده برای تمام درگاه‌های lid مقصد، بازنشانی تمام شمارنده‌ها برای همه درگاه‌ها، یا در صورت تعیین چند درگاه، تجمیع شمارنده‌های درگاه‌های مشخص‌شده. اگر lid مقصد از فلگ AllPortSelect پشتیبانی نکند، تمام درگاه‌ها پیمایش می‌شوند تا رفتار AllPortSelect شبیه‌سازی شود.
-l, --loop_ports: اگر تمام درگاه‌ها توسط کاربر انتخاب شده باشند (خواه از طریق گزینه -a یا درگاه ۲۵۵) یا چند درگاه مشخص شده باشند، به جای انجام عملیات تجمیعی، روی تک‌تک درگاه‌ها پیمایش انجام می‌شود.
-r, --reset_after_read: بازنشانی شمارنده‌ها پس از خواندن.
-R, --Reset_only: تنها بازنشانی شمارنده‌ها.

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

-G, --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 خروجی. بسته‌های SMP MAD همواره از نمایه 0 در P_Key استفاده می‌کنند.

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

پشتیبانی از چندین درگاه / چندین CA: هنگامی که هیچ دستگاه IB یا درگاهی مشخص نشده باشد (به پارامترهای local umad در زیر مراجعه کنید)، کتابخانه 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های درخواستی.

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

perfquery                # خواندن شمارنده‌های کارایی درگاه محلی
perfquery 32 1           # خواندن شمارنده‌های کارایی از lid 32، درگاه 1
perfquery -x 32 1        # خواندن شمارنده‌های گسترش‌یافته از lid 32، درگاه 1
perfquery -a 32          # خواندن شمارنده‌های کارایی از lid 32، تمام درگاه‌ها
perfquery -r 32 1        # خواندن شمارنده‌های کارایی و بازنشانی
perfquery -x -r 32 1     # خواندن شمارنده‌های گسترش‌یافته کارایی و بازنشانی
perfquery -R 0x20 1      # بازنشانی شمارنده‌های کارایی تنها در درگاه 1
perfquery -x -R 0x20 1   # بازنشانی شمارنده‌های گسترش‌یافته تنها در درگاه 1
perfquery -R -a 32       # بازنشانی شمارنده‌های کارایی تمام درگاه‌ها
perfquery -R 32 2 0x0fff # بازنشانی تنها شمارنده‌های خطای درگاه 2
perfquery -R 32 2 0xf000 # بازنشانی تنها شمارنده‌های غیرخطای درگاه 2
perfquery -a 32 1-10     # خواندن شمارنده‌ها از lid 32، درگاه‌های 1 تا 10، خروجی تجمیعی
perfquery -l 32 1-10     # خواندن شمارنده‌ها از lid 32، درگاه‌های 1 تا 10، خروجی مجزا
perfquery -a 32 1,4,8    # خواندن شمارنده‌ها از lid 32، درگاه‌های 1، 4 و 8، خروجی تجمیعی
perfquery -l 32 1,4,8    # خواندن شمارنده‌ها از lid 32، درگاه‌های 1، 4 و 8، خروجی مجزا

نویسنده (AUTHOR)

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