.\" 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 "ibtracert" "8" "2018-04-02" "" "Open IB Diagnostics"
.SH "نام (NAME)"
ibtracert \- ردگیری مسیر اینفینی‌باند
.SH "خلاصه دستور (SYNOPSIS)"
.sp
ibtracert [options] [<lid|guid> [<startlid> [<endlid>]]]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور
.B ibtracert
از بسته‌های SMP برای ردگیری مسیر از یک GID/LID مبدا به یک GID/LID مقصد استفاده می‌کند.
هر گام (hop) در امتداد مسیر تا زمانی که به مقصد برسد یا پاسخی از یک گام دریافت نشود، نمایش داده می‌شود.
با استفاده از گزینه
\fB\-m\fP،
می‌توان ردگیری مسیر چندپخشی (multicast) را بین گره‌های مبدا و مقصد انجام داد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fB\-n, \-\-no_info\fP
قالب ساده؛ اطلاعات اضافی را نشان ندهد.
.TP
.B \fB\-m\fP
نمایش ردگیری چندپخشی مربوط به mlid مشخص‌شده.
.TP
.B \fB\-f, \-\-force\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 <smlid>\fP     استفاده از \(aqsmlid\(aq به عنوان lid هدف برای پرس‌وجوهای SA.
.\" Define the common option --ports-file
.
.sp
\fB\-\-ports\-file <ports\-file>\fP   مشخص کردن یک فایل درگاه‌ها.
.INDENT 0.0
.INDENT 3.5
این فایل شامل چندین جفت lid یا guid مبدا و مقصد است. بخش «فایل‌ها (FILES)» را ببینید.
.UNINDENT
.UNINDENT
.SS "فلگ‌های انتخاب درگاه (Port Selection flags)"
.\" Define the common option -C
.
.sp
\fB\-C, \-\-Ca <ca_name>\fP    استفاده از ca_name مشخص‌شده.
.\" Define the common option -P
.
.sp
\fB\-P, \-\-Port <ca_port>\fP    استفاده از ca_port مشخص‌شده.
.\" Define the common option -Y
.
.INDENT 0.0
.TP
.B \fB\-Y, \-\-pkey\-idx <idx>\fP
نمایه جدول P_Key (مقدار 0\-65535، پیش‌فرض 0) مورد استفاده برای بسته‌های خروجی SA/GMP MAD.
بسته‌های SMP (مسیر هدایت‌شده SMI یا هدایت‌شده با LID) همیشه از نمایه 0 جدول P_Key استفاده می‌کنند.
.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 "فلگ‌های اشکال‌زدایی (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 <timeout_ms>\fP بازنویسی مهلت زمانی پیش‌فرض برای madهای درخواست‌شده.
.\" Define the common option --node-name-map
.
.sp
\fB\-\-node\-name\-map <node\-name\-map>\fP یک نگاشت نام گره را مشخص می‌کند.
.INDENT 0.0
.INDENT 3.5
این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. بخش «فایل‌ها (FILES)» را ببینید.
.UNINDENT
.UNINDENT
.\" Define the common option -y
.
.INDENT 0.0
.TP
.B \fB\-y, \-\-m_key <key>\fP
استفاده از M_key مشخص‌شده برای درخواست‌ها. اگر یک مقدار غیرعددی (مانند \(aqx\(aq)
مشخص شود، مقدار از کاربر پرسیده خواهد شد.
.UNINDENT
.\" Define the common option -z
.
.sp
\fB\-\-config, \-z  <config_file>\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
یک فایل پیکربندی سراسری برای تنظیم برخی از گزینه‌های مشترک میان تمام ابزارها ارائه شده است. برای جزئیات بیشتر به فایل پیکربندی ارائه‌شده مراجعه کنید.
.\" 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
# comment
<guid> \(dq<name>\(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
.\" Common text to describe the port file.
.
.SS "قالب فایل درگاه‌ها (PORTS FILE FORMAT)"
.sp
فایل درگاه‌ها می‌تواند برای مشخص کردن چندین جفت مبدا و مقصد استفاده شود. آن‌ها می‌توانند lid یا guid باشند. در صورت استفاده از guid، برای مشخص کردن آن از گزینه \fB\-G\fP استفاده کنید.
.sp
\fBبه طور کلی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# comment
<src> <dst>
.EE
.UNINDENT
.UNINDENT
.sp
\fBمثال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
73 207
203 657
531 101

> یا <

0x0008f104003f125c 0x0008f104003f133d
0x0008f1040011ab07 0x0008f104004265c0
0x0008f104007c5510 0x0008f1040099bb08
.EE
.UNINDENT
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.sp
مثال‌های تک‌پخشی (Unicast)
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ibtracert 4 16                                  # نمایش مسیر بین lidهای 4 و 16
ibtracert \-n 4 16                               # همان مورد، اما با استفاده از قالب خروجی ساده
ibtracert \-G 0x8f1040396522d 0x002c9000100d051  # استفاده از نشانی‌های guid
.EE
.UNINDENT
.UNINDENT
.sp
مثال چندپخشی (Multicast)
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ibtracert \-m 0xc000 4 16    # نمایش مسیر چندپخشی mlid 0xc000 بین lidهای 4 و 16
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
.BR ibroute (8)
.SH "نویسندگان (AUTHORS)"
.INDENT 0.0
.TP
.B Hal Rosenstock
<\%<hal\:.rosenstock@\:gmail\:.com>>
.TP
.B Ira Weiny
< \%<ira\:.weiny@\:intel\:.com> >
.UNINDENT
.\" End of generated man page.