." Man page generated from reStructuredText ." by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \ \n[an-margin] level \n[rst2man-indent-level] level margin: \n[rst2man-indent\n[rst2man-indent-level]] - \n[rst2man-indent0] \n[rst2man-indent1] \n[rst2man-indent2] .. .de1 INDENT ." .rstReportMargin pre: . RS \ . nr rst2man-indent\n[rst2man-indent-level] \n[an-margin] . nr rst2man-indent-level +1 ." .rstReportMargin post: .. .de UNINDENT . RE ." indent \n[an-margin] ." old: \n[rst2man-indent\n[rst2man-indent-level]] .nr rst2man-indent-level -1 ." new: \n[rst2man-indent\n[rst2man-indent-level]] .in \n[rst2man-indent\n[rst2man-indent-level]]u .. .TH "perfquery" "8" "2017-08-21" "" "Open IB Diagnostics" .SH "نام (NAME)" perfquery \- پرس‌وجوی شمارنده‌های درگاه InfiniBand روی یک درگاه منفرد .SH "خلاصه دستور (SYNOPSIS)" .sp perfquery [گزینه‌ها] [ [[درگاه(ها)] [reset_mask]]] .SH "توضیحات (DESCRIPTION)" .sp دستور perfquery از پیام‌های GMP مدیریت کارایی (PerfMgt GMPs) برای دریافت PortCounters (شمارنده‌های کارایی پایه و خطا)، PortExtendedCounters ،PortXmitDataSL ،PortRcvDataSL ،PortRcvErrorDetails ،PortXmitDiscardDetails ،PortExtendedSpeedsCounters یا PortSamplesControl از PMA در گره/درگاه مشخص‌شده استفاده می‌کند. به صورت اختیاری شمارنده‌های تجمیع‌شده را برای تمام درگاه‌های گره نمایش می‌دهد. در نهایت می‌تواند شمارنده‌ها را پس از خواندن بازنشانی کند، یا صرفاً بازنشانی شمارنده‌ها را انجام دهد. .sp نکته: در PortCounters ،PortCountersExtended ،PortXmitDataSL و PortRcvDataSL، مؤلفه‌هایی که نشان‌دهنده داده هستند (مانند PortXmitData و PortRcvData) به جای بایت‌های تنها، هشت‌تایی‌ها (اکتت‌ها) تقسیم بر ۴ را نشان می‌دهند. .sp نکته: وارد کردن درگاه ۲۵۵ نشان می‌دهد که عملیات روی همه درگاه‌ها انجام شود. .sp نکته: برای PortCounters ،ExtendedCounters و بازنشانی‌ها، چندین درگاه را می‌توان با فهرستی جداشده با کاما یا محدوده‌ای از درگاه‌ها مشخص کرد. مثال‌های زیر را ببینید. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \fB\-x, \-\-extended\fP نمایش شمارنده‌های گسترش‌یافته درگاه به جای شمارنده‌های (پایه) درگاه. توجه داشته باشید که مشخصه شمارنده‌های گسترش‌یافته درگاه اختیاری است. .TP .B \fB\-X, \-\-xmtsl\fP نمایش شمارنده داده‌های ارسالی SL. این یک شمارنده اختیاری برای QoS است. .TP .B \fB\-S, \-\-rcvsl\fP نمایش شمارنده داده‌های دریافتی SL. این یک شمارنده اختیاری برای QoS است. .TP .B \fB\-D, \-\-xmtdisc\fP نمایش جزئیات دور ریختن (discard) در ارسال. این یک شمارنده اختیاری است. .TP .B \fB\-E, \-\-rcverr\fP نمایش جزئیات خطای دریافت. این یک شمارنده اختیاری است. .TP .B \fB\-D, \-\-xmtdisc\fP نمایش جزئیات دور ریختن در ارسال. این یک شمارنده اختیاری است. .TP .B \fB\-T, \-\-extended_speeds\fP نمایش شمارنده‌های درگاه برای سرعت‌های گسترش‌یافته. این یک شمارنده اختیاری است. .TP .B \fB\-\-oprcvcounters\fP نمایش شمارنده‌های دریافتی به ازای هر Op code. این یک شمارنده اختیاری است. .TP .B \fB\-\-flowctlcounters\fP نمایش شمارنده‌های کنترل جریان. این یک شمارنده اختیاری است. .TP .B \fB\-\-vloppackets\fP نمایش بسته‌های دریافتی به ازای هر کد عملیات در هر VL. این یک شمارنده اختیاری است. .TP .B \fB\-\-vlopdata\fP نمایش داده‌های دریافتی به ازای هر کد عملیات در هر VL. این یک شمارنده اختیاری است. .TP .B \fB\-\-vlxmitflowctlerrors\fP نمایش خطاهای به‌روزرسانی کنترل جریان ارسال در هر VL. این یک شمارنده اختیاری است. .TP .B \fB\-\-vlxmitcounters\fP نمایش تیک‌های در انتظار ارسال برای شمارنده‌ها در هر VL. این یک شمارنده اختیاری است. .TP .B \fB\-\-swportvlcong\fP نمایش ازدحام درگاه سوئیچ VL. این یک شمارنده اختیاری است. .TP .B \fB\-\-rcvcc\fP نمایش شمارنده‌های کنترل ازدحام دریافت. این یک شمارنده اختیاری است. .TP .B \fB\-\-slrcvfecn\fP نمایش شمارنده‌های FECN دریافتی SL. این یک شمارنده اختیاری است. .TP .B \fB\-\-slrcvbecn\fP نمایش شمارنده‌های BECN دریافتی SL. این یک شمارنده اختیاری است. .TP .B \fB\-\-xmitcc\fP نمایش شمارنده‌های کنترل ازدحام ارسال. این یک شمارنده اختیاری است. .TP .B \fB\-\-vlxmittimecc\fP نمایش شمارنده‌های کنترل ازدحام زمان ارسال VL. این یک شمارنده اختیاری است. .TP .B \fB\-c, \-\-smplctl\fP نمایش کنترل نمونه‌های درگاه. .TP .B \fB\-a, \-\-all_ports\fP نمایش شمارنده‌های تجمیع‌شده برای تمام درگاه‌های lid مقصد، بازنشانی تمام شمارنده‌ها برای همه درگاه‌ها، یا در صورت تعیین چند درگاه، تجمیع شمارنده‌های درگاه‌های مشخص‌شده. اگر lid مقصد از فلگ AllPortSelect پشتیبانی نکند، تمام درگاه‌ها پیمایش می‌شوند تا رفتار AllPortSelect شبیه‌سازی شود. .TP .B \fB\-l, \-\-loop_ports\fP اگر تمام درگاه‌ها توسط کاربر انتخاب شده باشند (خواه از طریق گزینه \fB\-a\fP یا درگاه ۲۵۵) یا چند درگاه مشخص شده باشند، به جای انجام عملیات تجمیعی، روی تک‌تک درگاه‌ها پیمایش انجام می‌شود. .TP .B \fB\-r, \-\-reset_after_read\fP بازنشانی شمارنده‌ها پس از خواندن. .TP .B \fB\-R, \-\-Reset_only\fP تنها بازنشانی شمارنده‌ها. .UNINDENT .SS "فلگ‌های آدرس‌دهی (Addressing Flags)" ." Define the common option -G . .sp \fB\-G, \-\-Guid\fP آدرس مشخص‌شده یک Port GUID است. ." Define the common option -L . .sp \fB\-L, \-\-Lid\fP آدرس مشخص‌شده یک LID است. ." Define the common option -s . .sp \fB\-s, \-\-sm_port \fP استفاده از 'smlid' به عنوان lid مقصد برای پرس‌وجوهای SA. .SS "فلگ‌های انتخاب درگاه (Port Selection flags)" ." Define the common option -C . .sp \fB\-C, \-\-Ca \fP استفاده از ca_name مشخص‌شده. ." Define the common option -P . .sp \fB\-P, \-\-Port \fP استفاده از ca_port مشخص‌شده. ." Define the common option -Y . .INDENT 0.0 .TP .B \fB\-Y, \-\-pkey\-idx \fP نمایه جدول P_Key (از ۰ تا ۶۵۵۳۵، پیش‌فرض ۰) مورد استفاده برای MADهای SA/GMP خروجی. بسته‌های SMP MAD همواره از نمایه 0 در P_Key استفاده می‌کنند. .UNINDENT ." Explanation of local port selection . .SS "انتخاب درگاه محلی (Local port Selection)" .sp پشتیبانی از چندین درگاه / چندین CA: هنگامی که هیچ دستگاه IB یا درگاهی مشخص نشده باشد (به پارامترهای local umad در زیر مراجعه کنید)، کتابخانه libibumad درگاه مورد استفاده را بر اساس معیارهای زیر انتخاب می‌کند: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 نخستین درگاهی که در وضعیت ACTIVE باشد. .IP 2. 3 در صورت عدم یافتن، نخستین درگاهی که UP باشد (پیوند فیزیکی متصل باشد). .UNINDENT .sp اگر نام درگاه و/یا CA مشخص شده باشد، کتابخانه libibumad تلاش می‌کند تا درخواست کاربر را برآورده کند و در صورت عدم امکان با خطا مواجه خواهد شد. .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX ibaddr # استفاده از درگاه نخست (معیار شماره ۱ در بالا) ibaddr \-C mthca1 # انتخاب بهترین درگاه تنها از "mthca1" ibaddr \-P 2 # استفاده از درگاه دوم (active/up) از نخستین دستگاه در دسترس IB ibaddr \-C mthca0 \-P 2 # تنها استفاده از درگاه مشخص‌شده .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SS "فلگ‌های اشکال‌زدایی (Debugging flags)" ." Define the common option -d . .INDENT 0.0 .TP .B \-d افزایش سطح اشکال‌زدایی IB. می‌تواند چندین بار استفاده شود (\-ddd یا \-d \-d \-d). .UNINDENT ." Define the common option -e . .INDENT 0.0 .TP .B \-e نمایش خطاهای ارسال و دریافت (وقفه‌های زمانی و موارد دیگر). .UNINDENT ." Define the common option -h . .sp \fB\-h, \-\-help\fP نمایش پیام نحوه استفاده. ." Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP افزایش سطح جزئیات برنامه. می‌تواند چندین بار استفاده شود (\-vv یا \-v \-v \-v). .UNINDENT ." Define the common option -V . .sp \fB\-V, \-\-version\fP نمایش اطلاعات نسخه. .SS "فلگ‌های پیکربندی (Configuration flags)" ." Define the common option -t . .sp \fB\-t, \-\-timeout \fP بازنویسی زمان وقفه پیش‌فرض برای madهای درخواستی. ." Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP استفاده از M_key مشخص‌شده برای درخواست‌ها. در صورت تعیین مقدار غیرعددی (مانند 'x')، مقدار از کاربر پرسیده خواهد شد. .UNINDENT ." Define the common option -z . .sp \fB\-\-config, \-z \fP مشخص کردن فایل پیکربندی جایگزین. .INDENT 0.0 .INDENT 3.5 پیش‌فرض: /etc/infiniband\-diags/ibdiag.conf .UNINDENT .UNINDENT .SH "فایل‌ها (FILES)" ." Common text for the config file . .SS "فایل پیکربندی (CONFIG FILE)" .sp /etc/infiniband\-diags/ibdiag.conf .sp یک فایل پیکربندی سراسری برای تنظیم برخی از گزینه‌های مشترک برای همه ابزارها ارائه شده است. برای جزئیات به فایل پیکربندی ارائه‌شده مراجعه کنید. .SH "مثال‌ها (EXAMPLES)" .INDENT 0.0 .INDENT 3.5 .sp .EX 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، خروجی مجزا .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" .INDENT 0.0 .TP .B Hal Rosenstock < \% > .UNINDENT ." End of generated man page.