|
Packit |
db064d |
.\" Man page generated from reStructuredText.
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.TH IBTRACERT 8 "" "" "Open IB Diagnostics"
|
|
Packit |
db064d |
.SH NAME
|
|
Packit |
db064d |
ibtracert \- trace InfiniBand path
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.nr rst2man-indent-level 0
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.de1 rstReportMargin
|
|
Packit |
db064d |
\\$1 \\n[an-margin]
|
|
Packit |
db064d |
level \\n[rst2man-indent-level]
|
|
Packit |
db064d |
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
Packit |
db064d |
-
|
|
Packit |
db064d |
\\n[rst2man-indent0]
|
|
Packit |
db064d |
\\n[rst2man-indent1]
|
|
Packit |
db064d |
\\n[rst2man-indent2]
|
|
Packit |
db064d |
..
|
|
Packit |
db064d |
.de1 INDENT
|
|
Packit |
db064d |
.\" .rstReportMargin pre:
|
|
Packit |
db064d |
. RS \\$1
|
|
Packit |
db064d |
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
Packit |
db064d |
. nr rst2man-indent-level +1
|
|
Packit |
db064d |
.\" .rstReportMargin post:
|
|
Packit |
db064d |
..
|
|
Packit |
db064d |
.de UNINDENT
|
|
Packit |
db064d |
. RE
|
|
Packit |
db064d |
.\" indent \\n[an-margin]
|
|
Packit |
db064d |
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
Packit |
db064d |
.nr rst2man-indent-level -1
|
|
Packit |
db064d |
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
Packit |
db064d |
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
Packit |
db064d |
..
|
|
Packit |
db064d |
.SH SYNOPSIS
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
ibtracert [options] [<lid|guid> [<startlid> [<endlid>]]]
|
|
Packit |
db064d |
.SH DESCRIPTION
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
ibtracert uses SMPs to trace the path from a source GID/LID to a
|
|
Packit |
db064d |
destination GID/LID. Each hop along the path is displayed until
|
|
Packit |
db064d |
the destination is reached or a hop does not respond. By using
|
|
Packit |
db064d |
the \-m option, multicast path tracing can be performed between source
|
|
Packit |
db064d |
and destination nodes.
|
|
Packit |
db064d |
.SH OPTIONS
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B \fB\-n, \-\-no_info\fP
|
|
Packit |
db064d |
simple format; don\(aqt show additional information
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B \fB\-m\fP
|
|
Packit |
db064d |
show the multicast trace of the specified mlid
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B \fB\-f, \-\-force\fP
|
|
Packit |
db064d |
force route to destination port
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.SS Addressing Flags
|
|
Packit |
db064d |
.\" Define the common option -G
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-G, \-\-Guid\fP The address specified is a Port GUID
|
|
Packit |
db064d |
.\" Define the common option -L
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-L, \-\-Lid\fP The address specified is a LID
|
|
Packit |
db064d |
.\" Define the common option -s
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-s, \-\-sm_port <smlid>\fP use \(aqsmlid\(aq as the target lid for SA queries.
|
|
Packit |
db064d |
.\" Define the common option --ports-file
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-\-ports\-file <ports\-file>\fP Specify a ports file.
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
This file contains multiple source and destination lid or guid pairs. See FILES section.
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.SS Port Selection flags
|
|
Packit |
db064d |
.\" Define the common option -C
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-C, \-\-Ca <ca_name>\fP use the specified ca_name.
|
|
Packit |
db064d |
.\" Define the common option -P
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-P, \-\-Port <ca_port>\fP use the specified ca_port.
|
|
Packit |
db064d |
.\" Explanation of local port selection
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.SS Local port Selection
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
Multiple port/Multiple CA support: when no IB device or port is specified
|
|
Packit |
db064d |
(see the "local umad parameters" below), the libibumad library
|
|
Packit |
db064d |
selects the port to use by the following criteria:
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.IP 1. 3
|
|
Packit |
db064d |
the first port that is ACTIVE.
|
|
Packit |
db064d |
.IP 2. 3
|
|
Packit |
db064d |
if not found, the first port that is UP (physical link up).
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
If a port and/or CA name is specified, the libibumad library attempts
|
|
Packit |
db064d |
to fulfill the user request, and will fail if it is not possible.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
For example:
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
.nf
|
|
Packit |
db064d |
.ft C
|
|
Packit |
db064d |
ibaddr # use the first port (criteria #1 above)
|
|
Packit |
db064d |
ibaddr \-C mthca1 # pick the best port from "mthca1" only.
|
|
Packit |
db064d |
ibaddr \-P 2 # use the second (active/up) port from the first available IB device.
|
|
Packit |
db064d |
ibaddr \-C mthca0 \-P 2 # use the specified port only.
|
|
Packit |
db064d |
.ft P
|
|
Packit |
db064d |
.fi
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.SS Debugging flags
|
|
Packit |
db064d |
.\" Define the common option -d
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B \-d
|
|
Packit |
db064d |
raise the IB debugging level.
|
|
Packit |
db064d |
May be used several times (\-ddd or \-d \-d \-d).
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.\" Define the common option -e
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B \-e
|
|
Packit |
db064d |
show send and receive errors (timeouts and others)
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.\" Define the common option -h
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-h, \-\-help\fP show the usage message
|
|
Packit |
db064d |
.\" Define the common option -v
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B \fB\-v, \-\-verbose\fP
|
|
Packit |
db064d |
increase the application verbosity level.
|
|
Packit |
db064d |
May be used several times (\-vv or \-v \-v \-v)
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.\" Define the common option -V
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-V, \-\-version\fP show the version info.
|
|
Packit |
db064d |
.SS Configuration flags
|
|
Packit |
db064d |
.\" Define the common option -t
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-t, \-\-timeout <timeout_ms>\fP override the default timeout for the solicited mads.
|
|
Packit |
db064d |
.\" Define the common option --node-name-map
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-\-node\-name\-map <node\-name\-map>\fP Specify a node name map.
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
This file maps GUIDs to more user friendly names. See FILES section.
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.\" Define the common option -y
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B \fB\-y, \-\-m_key <key>\fP
|
|
Packit |
db064d |
use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq)
|
|
Packit |
db064d |
is specified then a value will be prompted for.
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.\" Define the common option -z
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fB\-\-config, \-z <config_file>\fP Specify alternate config file.
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
Default: /usr/local/etc/infiniband-diags/ibdiag.conf
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.SH FILES
|
|
Packit |
db064d |
.\" Common text for the config file
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.SS CONFIG FILE
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
/usr/local/etc/infiniband-diags/ibdiag.conf
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
A global config file is provided to set some of the common options for all
|
|
Packit |
db064d |
tools. See supplied config file for details.
|
|
Packit |
db064d |
.\" Common text to describe the node name map file.
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.SS NODE NAME MAP FILE FORMAT
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
The node name map is used to specify user friendly names for nodes in the
|
|
Packit |
db064d |
output. GUIDs are used to perform the lookup.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP
|
|
Packit |
db064d |
for the file location for your installation.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fBGenerically:\fP
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
.nf
|
|
Packit |
db064d |
.ft C
|
|
Packit |
db064d |
# comment
|
|
Packit |
db064d |
<guid> "<name>"
|
|
Packit |
db064d |
.ft P
|
|
Packit |
db064d |
.fi
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fBExample:\fP
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
.nf
|
|
Packit |
db064d |
.ft C
|
|
Packit |
db064d |
# IB1
|
|
Packit |
db064d |
# Line cards
|
|
Packit |
db064d |
0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D"
|
|
Packit |
db064d |
0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D"
|
|
Packit |
db064d |
0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D"
|
|
Packit |
db064d |
0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D"
|
|
Packit |
db064d |
0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D"
|
|
Packit |
db064d |
|
|
Packit |
db064d |
# Spines
|
|
Packit |
db064d |
0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
|
|
Packit |
db064d |
0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
|
|
Packit |
db064d |
0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
|
|
Packit |
db064d |
0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D"
|
|
Packit |
db064d |
0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D"
|
|
Packit |
db064d |
|
|
Packit |
db064d |
# GUID Node Name
|
|
Packit |
db064d |
0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D"
|
|
Packit |
db064d |
0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D"
|
|
Packit |
db064d |
0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D"
|
|
Packit |
db064d |
0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D"
|
|
Packit |
db064d |
.ft P
|
|
Packit |
db064d |
.fi
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.\" Common text to describe the port file.
|
|
Packit |
db064d |
.
|
|
Packit |
db064d |
.SS PORTS FILE FORMAT
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
The ports file can be used to specify multiple source and destination pairs. They can be lids or guids. If guids, use the \-G option to indicate that.
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fBGenerically:\fP
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
.nf
|
|
Packit |
db064d |
.ft C
|
|
Packit |
db064d |
# comment
|
|
Packit |
db064d |
<src> <dst>
|
|
Packit |
db064d |
.ft P
|
|
Packit |
db064d |
.fi
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
\fBExample:\fP
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.INDENT 3.5
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
.nf
|
|
Packit |
db064d |
.ft C
|
|
Packit |
db064d |
73 207
|
|
Packit |
db064d |
203 657
|
|
Packit |
db064d |
531 101
|
|
Packit |
db064d |
|
|
Packit |
db064d |
> OR <
|
|
Packit |
db064d |
|
|
Packit |
db064d |
0x0008f104003f125c 0x0008f104003f133d
|
|
Packit |
db064d |
0x0008f1040011ab07 0x0008f104004265c0
|
|
Packit |
db064d |
0x0008f104007c5510 0x0008f1040099bb08
|
|
Packit |
db064d |
.ft P
|
|
Packit |
db064d |
.fi
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.SH EXAMPLES
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
Unicast examples
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B ::
|
|
Packit |
db064d |
ibtracert 4 16 # show path between lids 4 and 16
|
|
Packit |
db064d |
ibtracert \-n 4 16 # same, but using simple output format
|
|
Packit |
db064d |
ibtracert \-G 0x8f1040396522d 0x002c9000100d051 # use guid addresses
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
Multicast example
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B ::
|
|
Packit |
db064d |
ibtracert \-m 0xc000 4 16 # show multicast path of mlid 0xc000 between lids 4 and 16
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.SH SEE ALSO
|
|
Packit |
db064d |
.sp
|
|
Packit |
db064d |
ibroute (8)
|
|
Packit |
db064d |
.SH AUTHOR
|
|
Packit |
db064d |
.INDENT 0.0
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B Hal Rosenstock
|
|
Packit |
db064d |
<\fI\%hal.rosenstock@gmail.com\fP>
|
|
Packit |
db064d |
.TP
|
|
Packit |
db064d |
.B Ira Weiny
|
|
Packit |
db064d |
< \fI\%ira.weiny@intel.com\fP >
|
|
Packit |
db064d |
.UNINDENT
|
|
Packit |
db064d |
.\" Generated by docutils manpage writer.
|
|
Packit |
db064d |
.
|