perfquery(8) Open IB Diagnostics perfquery(8) نام (NAME) perfquery - پرس‌وجوی شمارنده‌های درگاه InfiniBand روی یک درگاه منفرد خلاصه دستور (SYNOPSIS) perfquery [گزینه‌ها] [ [[درگاه(ها)] [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' به عنوان lid مقصد برای پرس‌وجوهای SA. فلگ‌های انتخاب درگاه (Port Selection flags) -C, --Ca استفاده از ca_name مشخص‌شده. -P, --Port استفاده از ca_port مشخص‌شده. -Y, --pkey-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 بازنویسی زمان وقفه پیش‌فرض برای madهای درخواستی. -y, --m_key استفاده از M_key مشخص‌شده برای درخواست‌ها. در صورت تعیین مقدار غیرعددی (مانند 'x')، مقدار از کاربر پرسیده خواهد شد. --config, -z مشخص کردن فایل پیکربندی جایگزین. پیش‌فرض: /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 < > 2017-08-21 perfquery(8)