.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\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 \\$1 . 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 "IBQUERYERRORS" "8" "2016-09-26" "" "OpenIB Diagnostics" .SH "نام (NAME)" ibqueryerrors \- پرس‌وجو و گزارش شمارنده‌های خطای درگاه IB .SH "خلاصه دستور (SYNOPSIS)" .sp ibqueryerrors [\fIگزینه‌ها\fP] .SH "توضیحات (DESCRIPTION)" .sp رفتار پیش‌فرض، گزارش شمارنده‌های خطای درگاه است که برای هر درگاه در ساختار شبکه (fabric)، از یک مقدار آستانه معین فراتر می‌روند. مقدار آستانه پیش‌فرض صفر (0) است. فیلدهای خطا را می‌توان به‌طور کامل نیز نادیده گرفت (سرکوب کرد). .sp علاوه بر گزارش خطاها روی هر درگاه، دستور ibqueryerrors می‌تواند داده‌های ارسالی و دریافتی درگاه و همچنین اطلاعات کامل پیوند به درگاه راه دور را (در صورت در دسترس بودن) گزارش کند. .SH "گزینه‌ها (OPTIONS)" .sp \fB\-s, \-\-suppress \fP خطاهای مشخص‌شده در فهرست ارائه‌شده که با کاما از هم جدا شده‌اند را نادیده می‌گیرد (سرکوب می‌کند). .sp \fB\-c, \-\-suppress\-common\fP برخی از شمارنده‌های رایج «اثر جانبی» را نادیده می‌گیرد. این شمارنده‌ها معمولاً نشان‌دهنده وضعیت خطا نیستند و در اکثر مواقع می‌توان با اطمینان از آن‌ها چشم‌پوشی کرد. .sp \fB\-r, \-\-report\-port\fP اطلاعات درگاه را گزارش می‌دهد. این اطلاعات شامل LID، درگاه، درگاه خارجی (در صورت وجود)، تنظیمات سرعت پیوند، GUID راه دور، درگاه راه دور، درگاه خارجی راه دور (در صورت وجود) و اطلاعات شرح گره راه دور است. .sp \fB\-\-data\fP شمارنده‌های اختیاری داده‌های ارسالی و دریافتی را نیز شامل می‌شود. .sp \fB\-\-threshold\-file \fP یک فایل آستانه جایگزین را مشخص می‌کند. پیش‌فرض /etc/infiniband\-diags/error_thresholds است. .sp \fB\-\-switch\fP داده‌ها را فقط برای سوییچ‌ها چاپ می‌کند .sp \fB\-\-ca\fP داده‌ها را فقط برای CAها (تطبیق‌دهنده‌های کانال) چاپ می‌کند .sp \fB\-\-skip\-sl\fP از sl پیش‌فرض برای پرس‌وجوها استفاده می‌کند. هنگام استفاده از موتور مسیریابی آگاه از کیفیت خدمات (QoS)، استفاده از این گزینه توصیه نمی‌شود زیرا می‌تواند باعث بن‌بست اعتباری (credit deadlock) شود. .sp \fB\-\-router\fP داده‌ها را فقط برای مسیریاب‌ها چاپ می‌کند .sp \fB\-\-clear\-errors \-k\fP پس از خواندن، شمارنده‌های خطا را پاک می‌کند. .sp \fB\-\-clear\-counts \-K\fP پس از خواندن، شمارنده‌های داده را پاک می‌کند. .sp \fBهشدار:\fP پاک کردن شمارنده‌های داده یا خطا بدون در نظر گرفتن اینکه چاپ شوند یا خیر اتفاق می‌افتد. برای جزئیات مربوط به کنترل اینکه کدام شمارنده‌ها چاپ شوند، \fB\-\-counters\fP و \fB\-\-data\fP را ببینید. .sp \fB\-\-details\fP شامل جزئیات خطاهای دریافتی و بسته‌های دور ریخته‌شده ارسالی (transmit discard) می‌شود .sp \fB\-\-counters\fP فقط شمارنده‌های داده را چاپ می‌کند .SS "فلگ‌های پویش جزئی (Partial Scan flags)" .sp گره مورد نظر برای شروع پویش جزئی را می‌توان با آدرس‌های زیر مشخص کرد. .\" Define the common option -G . .sp \fB\-\-port\-guid, \-G \fP یک port_guid را مشخص می‌کند .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct \fP آدرس مشخص‌شده یک مسیر هدایت‌شده (directed route) است .INDENT 0.0 .INDENT 3.5 .sp .EX مثال‌ها: \-D \(dq0\(dq # درگاه خود گره (self port) \-D \(dq0,1,2,1,4\(dq # خروج از طریق درگاه ۱، سپس ۲، ... (توجه داشته باشید که عدد دوم در مسیر مشخص‌شده باید با درگاه مورد استفاده مطابقت داشته باشد. این مقدار را می‌توان با فلگ انتخاب درگاه \(aq\-P\(aq یا درگاه پیداشده از طریق فرآیند انتخاب خودکار مشخص کرد.) .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP برای سوییچ‌ها، نتایج برای همه درگاه‌ها چاپ می‌شوند، نه فقط درگاه ۰ سوییچ. .sp \fB\-S \fP همانند \(dq\-G\(dq عمل می‌کند (تنها برای سازگاری با نسخه‌های پیشین ارائه شده است). .SS "فلگ‌های فایل حافظه موقت (Cache File flags)" .\" Define the common option load-cache . .sp \fB\-\-load\-cache \fP داده‌های ذخیره‌شده کش ibnetdiscover در فایل مشخص‌شده را بارگذاری و استفاده می‌کند. این گزینه می‌تواند برای خروجی گرفتن و کسب اطلاعات درباره ساختارهای دیگر یا وضعیت پیشین یک ساختار شبکه مفید باشد. .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 (از 0\-65535، پیش‌فرض 0) که برای MADهای خروجی SA/GMP استفاده می‌شود. بسته‌های MAD از نوع SMP (شامل مسیر هدایت‌شده SMI / مسیریابی‌شده با LID) همواره از نمایه P_Key برابر با 0 استفاده می‌کنند. .UNINDENT .\" Explanation of local port selection . .SS "انتخاب درگاه محلی (Local port Selection)" .sp پشتیبانی از چند درگاه / چند CA: زمانی که هیچ دستگاه یا درگاه IB مشخص نشده باشد (بخش «پارامترهای محلی 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 # انتخاب بهترین درگاه فقط از \(dqmthca1\(dq ibaddr \-P 2 # استفاده از دومین درگاه (active/up) از نخستین دستگاه IB موجود ibaddr \-C mthca0 \-P 2 # استفاده انحصاری از درگاه مشخص‌شده .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SS "فلگ‌های پیکربندی (Configuration flags)" .\" Define the common option -z . .sp \fB\-\-config, \-z \fP فایل پیکربندی جایگزین را مشخص می‌کند. .INDENT 0.0 .INDENT 3.5 پیش‌فرض: /etc/infiniband\-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP تعداد SMPهای معوق (outstanding) که باید در طول پویش صادر شوند را مشخص می‌کند. .sp پیش‌فرض: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP یک نگاشت نام گره را مشخص می‌کند. .INDENT 0.0 .INDENT 3.5 این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. بخش «فایل‌ها (FILES)» را ببینید. .UNINDENT .UNINDENT .\" 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 مشخص‌شده برای درخواست‌ها استفاده می‌کند. اگر مقداری غیرعددی (مانند \(aqx\(aq) مشخص شود، مقدار مورد نظر از کاربر درخواست خواهد شد. .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 اطلاعات نگارش را نمایش می‌دهد. .sp \fB\-R\fP (این گزینه منسوخ شده است و هیچ کاری انجام نمی‌دهد) .SH "وضعیت خروج (EXIT STATUS)" .sp \fB\-1\fP در صورتی که پویش شکست بخورد. .sp \fB0\fP در صورتی که پویش بدون خطاهای فراتر از آستانه با موفقیت انجام شود. .sp \fB1\fP در صورتی که خطاهای فراتر از آستانه یافت شوند یا در حالت بررسی ناهماهنگی‌هایی پیدا شود. .SH "فایل‌ها (FILES)" .SS "آستانه خطا (ERROR THRESHOLD)" .sp /etc/infiniband\-diags/error_thresholds .sp مقادیر آستانه برای خطاها را تعریف می‌کند. قالب فایل به‌صورت ساده \(dqname=val\(dq است. توضیحات با \(aq#\(aq آغاز می‌شوند. .sp \fBمثال:\fP .INDENT 0.0 .INDENT 3.5 .sp .EX # تعیین آستانه‌ها برای شمارنده‌های خطا SymbolErrorCounter=10 LinkErrorRecoveryCounter=10 VL15Dropped=100 .EE .UNINDENT .UNINDENT .\" Common text for the config file . .SS "فایل پیکربندی (CONFIG FILE)" .sp /etc/infiniband\-diags/ibdiag.conf .sp یک فایل پیکربندی سراسری برای تنظیم برخی از گزینه‌های مشترک برای همه ابزارها ارائه شده است. برای جزئیات به فایل پیکربندی ارائه‌شده مراجعه کنید. .\" Common text to describe the node name map file. . .SS "قالب فایل نگاشت نام گره (NODE NAME MAP FILE FORMAT)" .sp فایل نگاشت نام گره برای مشخص کردن نام‌های کاربرپسند برای گره‌ها در خروجی استفاده می‌شود. برای انجام جستجو از GUIDها استفاده می‌شود. .sp این قابلیت توسط بسته opensm\-libs ارائه شده است. برای محل فایل در نصب خود به \fBopensm(8)\fP مراجعه کنید. .sp \fBبه‌طور کلی:\fP .INDENT 0.0 .INDENT 3.5 .sp .EX # توضیحات \(dq\(dq .EE .UNINDENT .UNINDENT .sp \fBمثال:\fP .INDENT 0.0 .INDENT 3.5 .sp .EX # IB1 # کارت‌های خط (Line cards) 0x0008f104003f125c \(dqIB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq 0x0008f104003f125d \(dqIB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq 0x0008f104003f10d2 \(dqIB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq 0x0008f104003f10d3 \(dqIB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq 0x0008f104003f10bf \(dqIB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq # ستون‌های اصلی (Spines) 0x0008f10400400e2d \(dqIB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D\(dq 0x0008f10400400e2e \(dqIB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D\(dq 0x0008f10400400e2f \(dqIB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D\(dq 0x0008f10400400e31 \(dqIB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D\(dq 0x0008f10400400e32 \(dqIB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D\(dq # GUID Node Name 0x0008f10400411a08 \(dqSW1 (Rack 3) ISR9024 Voltaire 9024D\(dq 0x0008f10400411a28 \(dqSW2 (Rack 3) ISR9024 Voltaire 9024D\(dq 0x0008f10400411a34 \(dqSW3 (Rack 3) ISR9024 Voltaire 9024D\(dq 0x0008f104004119d0 \(dqSW4 (Rack 3) ISR9024 Voltaire 9024D\(dq .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" .INDENT 0.0 .TP .B Ira Weiny < \% > .UNINDENT .\" End of generated man page.