.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "IBDIAGPATH 1" .TH IBDIAGPATH 1 "2018-12-14" "IBDIAG 1.0" "IB DIAGNOSTIC PACKAGE" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" ibdiagpath \- IB diagnostic path .SH "SYNOPSYS" .IX Header "SYNOPSYS" ibdiagpath {\-n <[src\-name,]dst\-name>|\-l <[src\-lid,]dst\-lid>|\-d } [\-c ] [\-v] [\-t ] [\-s ] [\-i ] [\-p ] [\-o ] [\-lw <1x|4x|12x>] [\-ls <2.5|5|10>] [\-pm] [\-pc] [\-P <<\s-1PM\s0 counter>=>] .SH "DESCRIPTION" .IX Header "DESCRIPTION" ibdiagpath traces a path between two end-points and provides information regarding the nodes and ports traversed along the path. It utilizes device specific health queries for the different devices along the traversed path. The way ibdiagpath operates depends on the addressing mode used on the command line. If directed route adressing is used, the local node is the source node and the route to the destination port is known apriori. On the other hand, if \s-1LID\s0 route (or by-name) addressing is imployed, then the source and destination ports of a route are specified by their LIDs (or by the names defined in the topology file). In this case, the actual path from the local port to the source port, and from the source port to the destination port, is defined by means of Subnet Management Linear Forwarding Table queries of the switch nodes along those paths. Therefore, the path cannot be predicted as it may change. The tool allows omitting the source node, in which case the local port on the machine running the tool is assumed to be the source. Note: When ibdiagpath queries for the performance counters along the path between the source and destination ports, it always traverses the \s-1LID\s0 route, even if a directed route is specified. If along the \s-1LID\s0 route one or more links are not in the \s-1ACTIVE\s0 state, ibdiagpath reports an error. Checks for path validity from partitions, IPoIB and QoS perspectives are also provided. .IP "\fIibdiagpath.log\fR \-" 4 .IX Item "ibdiagpath.log -" A dump of all the application reports generate according to the provided flags .IP "\fIibdiagnet.pm\fR \-" 4 .IX Item "ibdiagnet.pm -" A dump of the pm Counters values, of the fabric links .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-n <[src\-name,]dst\-name\fR> :" 4 .IX Item "-n <[src-name,]dst-name> :" .RS 4 .PD 0 .IP " Names of the source and destination ports (as defined in the topology file; source may be omitted \-> local port is assumed to be the source)" 4 .IX Item " Names of the source and destination ports (as defined in the topology file; source may be omitted -> local port is assumed to be the source)" .RE .RS 4 .RE .IP "\fB\-l <[src\-lid,]dst\-lid\fR> :" 4 .IX Item "-l <[src-lid,]dst-lid> :" .RS 4 .IP " Source and destination LIDs (source may be omitted \-> local port is assumed to be the source)" 4 .IX Item " Source and destination LIDs (source may be omitted -> local port is assumed to be the source)" .RE .RS 4 .RE .IP "\fB\-d :" 4 .IX Item "-d :" .RS 4 .IP " directed route from the local node (which is the source) and the destination node" 4 .IX Item " directed route from the local node (which is the source) and the destination node" .RE .RS 4 .RE .IP "\fB\-c :" 4 .IX Item "-c :" .RS 4 .IP " The minimal number of packets to be sent across each link (default = 100)" 4 .IX Item " The minimal number of packets to be sent across each link (default = 100)" .RE .RS 4 .RE .IP "\fB\-v\fR :" 4 .IX Item "-v :" .RS 4 .IP " Enable verbose mode" 4 .IX Item " Enable verbose mode" .RE .RS 4 .RE .IP "\fB\-t :" 4 .IX Item "-t :" .RS 4 .IP " Specifies the topology file name" 4 .IX Item " Specifies the topology file name" .RE .RS 4 .RE .IP "\fB\-s :" 4 .IX Item "-s :" .RS 4 .IP " Specifies the local system name. Meaningful only if a topology file is specified" 4 .IX Item " Specifies the local system name. Meaningful only if a topology file is specified" .RE .RS 4 .RE .IP "\fB\-i :" 4 .IX Item "-i :" .RS 4 .IP " Specifies the index of the device of the port used to connect to the \s-1IB\s0 fabric (in case of multiple devices on the local system)" 4 .IX Item " Specifies the index of the device of the port used to connect to the IB fabric (in case of multiple devices on the local system)" .RE .RS 4 .RE .IP "\fB\-p :" 4 .IX Item "-p :" .RS 4 .IP " Specifies the local device's port number used to connect to the \s-1IB\s0 fabric" 4 .IX Item " Specifies the local device's port number used to connect to the IB fabric" .RE .RS 4 .RE .IP "\fB\-o :" 4 .IX Item "-o :" .RS 4 .IP " Specifies the directory where the output files will be placed (default = /var/cache/ibutils)" 4 .IX Item " Specifies the directory where the output files will be placed (default = /var/cache/ibutils)" .RE .RS 4 .RE .IP "\fB\-lw <1x|4x|12x\fR> :" 4 .IX Item "-lw <1x|4x|12x> :" .RS 4 .IP " Specifies the expected link width" 4 .IX Item " Specifies the expected link width" .RE .RS 4 .RE .IP "\fB\-ls <2.5|5|10\fR> :" 4 .IX Item "-ls <2.5|5|10> :" .RS 4 .IP " Specifies the expected link speed" 4 .IX Item " Specifies the expected link speed" .RE .RS 4 .RE .IP "\fB\-pm\fR :" 4 .IX Item "-pm :" .RS 4 .IP " Dump all the fabric links, pm Counters into ibdiagnet.pm" 4 .IX Item " Dump all the fabric links, pm Counters into ibdiagnet.pm" .RE .RS 4 .RE .IP "\fB\-pc\fR :" 4 .IX Item "-pc :" .RS 4 .IP " Reset all the fabric links pmCounters" 4 .IX Item " Reset all the fabric links pmCounters" .RE .RS 4 .RE .IP "\fB\-P\fR > :" 4 .IX Item "-P > :" .RS 4 .IP " If any of the provided pm is greater then its provided value, print it to screen" 4 .IX Item " If any of the provided pm is greater then its provided value, print it to screen" .RE .RS 4 .RE .IP "\fB\-h|\-\-help\fR :" 4 .IX Item "-h|--help :" .RS 4 .IP " Prints the help page information" 4 .IX Item " Prints the help page information" .RE .RS 4 .RE .IP "\fB\-V|\-\-version\fR :" 4 .IX Item "-V|--version :" .RS 4 .IP " Prints the version of the tool" 4 .IX Item " Prints the version of the tool" .RE .RS 4 .RE .IP "\fB\-\-vars\fR :" 4 .IX Item "--vars :" .RS 4 .IP " Prints the tool's environment variables and their values" 4 .IX Item " Prints the tool's environment variables and their values" .RE .RS 4 .RE .PD .SH "ERROR CODES" .IX Header "ERROR CODES" .IP "1 \- The path traced is un-healthy" 4 .IX Item "1 - The path traced is un-healthy" .PD 0 .IP "2 \- Failed to parse command line options" 4 .IX Item "2 - Failed to parse command line options" .ie n .IP "3 \- More then 64 hops are required for traversing the local port to the ""Source"" port and then to the ""Destination"" port." 4 .el .IP "3 \- More then 64 hops are required for traversing the local port to the ``Source'' port and then to the \f(CWDestination\fR port." 4 .IX Item "3 - More then 64 hops are required for traversing the local port to the Source port and then to the Destination port." .IP "4 \- Unable to traverse the \s-1LFT\s0 data from source to destination" 4 .IX Item "4 - Unable to traverse the LFT data from source to destination" .IP "5 \- Failed to use Topology File" 4 .IX Item "5 - Failed to use Topology File" .IP "6 \- Failed to load required Package" 4 .IX Item "6 - Failed to load required Package"