infiniband-diags-1.6.1/0000755013161601316160000000000012005566566011733 500000000000000infiniband-diags-1.6.1/man/0000755013161601316160000000000012005566566012506 500000000000000infiniband-diags-1.6.1/man/ibchecknode.80000644013161601316160000000172611627544204014755 00000000000000.TH IBCHECKNODE 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibchecknode \- validate IB node and report errors .SH SYNOPSIS .B ibchecknode [\-h] [\-v] [\-N | \-nocolor] [\-G] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] .SH DESCRIPTION .PP Check connectivity and do some simple sanity checks for the specified node. Port address is a lid unless -G option is used to specify a GUID address. .SH OPTIONS .PP \-G use GUID address argument. In most cases, it is the Port GUID. Example: "0x08f1040023" .PP \-v increase the verbosity level .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH EXAMPLE .PP ibchecknode 2 # check node via lid 2 .SH SEE ALSO .BR smpquery(8), .BR ibaddr(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibprintrt.80000644013161601316160000000226311627544203014530 00000000000000.TH IBPRINTRT 8 "May 31, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibprintrt.pl \- print either only the router specified or a list of routers from the ibnetdiscover output .SH SYNOPSIS .B ibprintrt.pl [-R -l -C -P ] [] .SH DESCRIPTION .PP Faster than greping/viewing with an editor the output of ibnetdiscover, ibprintrt.pl will parse out and print either the router information for the specified IB router or a list of all IB routers in the subnet. Finally, ibprintrt.pl will also reuse the cached ibnetdiscover output from some of the other diag tools which makes it a bit faster than running ibnetdiscover from scratch. .SH OPTIONS .PP .TP \fB\-l\fR List the Rts (simply a wrapper for ibrouters). .TP \fB\-R\fR Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. .TP \fB\-C \fR use the specified ca_name for the search. .TP \fB\-P \fR use the specified ca_port for the search. .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibcheckerrors.80000644013161601316160000000173111627544203015337 00000000000000.TH IBCHECKERRORS 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibcheckerrors \- validate IB subnet and report errors .SH SYNOPSIS .B ibcheckerrors [\-h] [\-b] [\-v] [\-N | \-nocolor] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] .SH DESCRIPTION .PP ibcheckerrors is a script which uses a full topology file that was created by ibnetdiscover, scans the network to validate the connectivity and reports errors (from port counters). .SH OPTIONS .PP \-v increase the verbosity level .PP \-b brief mode. Reduce the output to show only if errors are present, not what they are. .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH SEE ALSO .BR ibnetdiscover(8), .BR ibchecknode(8), .BR ibcheckport(8), .BR ibcheckerrs(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibswportwatch.80000644013161601316160000000135511627544203015414 00000000000000.TH IBSWPORTWATCH 8 "September 27, 2006" "OpenIB" "OpenIB Diagnostics" .SH NAME ibswportwatch.pl \- poll the counters on the specified switch/port and report rate of change information. .SH SYNOPSIS .B ibswportwatch.pl [-p -v -n -G] .SH DESCRIPTION .PP ibswportwatch.pl polls the port counters of the specified port and calculates rate of change information. .SH OPTIONS .PP .TP \fB\-p \fR Specify a pause time (polling interval) other than the default. .TP \fB\-v\fR Be verbose. .TP \fB\-n \fR Run for a set number of poll intervals and stop. (Default == -1 == forever) .TP \fB\-G\fR The address provided is a GUID rather than LID. .SH AUTHOR .TP Ira Weiny .RI < weiny2@llnl.gov > infiniband-diags-1.6.1/man/ibdatacounters.80000644013161601316160000000170011627544202015514 00000000000000.TH IBDATACOUNTERS 8 "May 31, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibdatacounters \- query IB subnet for data counters .SH SYNOPSIS .B ibdatacounters [\-h] [\-b] [\-v] [\-N | \-nocolor] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] .SH DESCRIPTION .PP ibdatacounters is a script which uses a full topology file that was created by ibnetdiscover, scans the network to validate the connectivity and reports the data counters (from port counters). .SH OPTIONS .PP \-v increase the verbosity level .PP \-b brief mode. Reduce the output to show only if errors are present, not what they are. .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH SEE ALSO .BR ibnetdiscover(8), .BR ibdatacounts(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibcheckport.80000644013161601316160000000173411627544203015012 00000000000000.TH IBCHECKPORT 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibcheckport \- validate IB port and report errors .SH SYNOPSIS .B ibcheckport [\-h] [\-v] [\-N | \-nocolor] [\-G] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] .SH DESCRIPTION .PP Check connectivity and do some simple sanity checks for the specified port. Port address is a lid unless -G option is used to specify a GUID address. .SH OPTIONS .PP \-G use GUID address argument. In most cases, it is the Port GUID. Example: "0x08f1040023" .PP \-v increase the verbosity level .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH EXAMPLE .PP ibcheckport 2 3 # check lid 2 port 3 .SH SEE ALSO .BR smpquery(8), .BR ibaddr(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibcheckstate.80000644013161601316160000000165011627544203015143 00000000000000.TH IBCHECKSTATE 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibcheckstate \- find ports in IB subnet which are link up but not active .SH SYNOPSIS .B ibcheckstate [\-h] [\-v] [\-N | \-nocolor] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] .SH DESCRIPTION .PP ibcheckstat is a script which uses a full topology file that was created by ibnetdiscover, scans the network to validate the port state and port physical state, and reports any ports which have a port state other than Active or a port physical state other than LinkUp. .SH OPTIONS .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH SEE ALSO .BR ibnetdiscover(8), .BR ibchecknode(8), .BR ibcheckportstate(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibclearcounters.80000644013161601316160000000126511750621734015702 00000000000000.TH IBCLEARCOUNTERS 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibclearcounters \- clear port counters in IB subnet .SH SYNOPSIS .B ibclearcounters [\-h] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] .SH DESCRIPTION .PP ibclearcounters is a script that clears the PMA port counters by either walking the IB subnet topology or using an already saved topology file. .SH OPTIONS .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH SEE ALSO .BR ibnetdiscover(8), .BR perfquery(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibchecknet.80000644013161601316160000000150011627544204014604 00000000000000.TH IBCHECKNET 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibchecknet \- validate IB subnet and report errors .SH SYNOPSIS .B ibchecknet [\-h] [\-N | \-nocolor] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] .SH DESCRIPTION .PP ibchecknet is a script which uses a full topology file that was created by ibnetdiscover, and scans the network to validate the connectivity and reports errors (from port counters). .SH OPTIONS .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH SEE ALSO .BR ibnetdiscover(8), .BR ibchecknode(8), .BR ibcheckport(8), .BR ibcheckerrs(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibprintca.80000644013161601316160000000227611627544204014473 00000000000000.TH IBPRINTCA 8 "May 31, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibprintca.pl \- print either the ca specified or the list of cas from the ibnetdiscover output .SH SYNOPSIS .B ibprintca.pl [-R -l -C -P ] [] .SH DESCRIPTION .PP Faster than greping/viewing with an editor the output of ibnetdiscover, ibprintca.pl will parse out and print either the CA information for the specified CA or a list of all the CAs in the subnet. Finally, ibprintca.pl will also reuse the cached ibnetdiscover output from some of the other diag tools which makes it a bit faster than running ibnetdiscover from scratch. .SH OPTIONS .PP .TP \fB\-l\fR List the CAs (simply a wrapper for ibhosts). .TP \fB\-R\fR Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. .TP \fB\-C \fR use the specified ca_name for the search. .TP \fB\-P \fR use the specified ca_port for the search. .SH AUTHORS .TP Ira Weiny .RI < weiny2@llnl.gov > .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibclearerrors.80000644013161601316160000000140711627544204015351 00000000000000.TH IBCLEARERRORS 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibclearerrors \- clear error counters in IB subnet .SH SYNOPSIS .B ibclearerrors [\-h] [\-N | \-nocolor] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] .SH DESCRIPTION .PP ibclearerrors is a script which clears the PMA error counters in PortCounters by either walking the IB subnet topology or using an already saved topology file. .SH OPTIONS .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH SEE ALSO .BR ibnetdiscover(8), .BR perfquery(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibprintswitch.80000644013161601316160000000265411627544204015411 00000000000000.TH IBPRINTSWITCH 8 "May 31, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibprintswitch.pl \- print either the switch specified or a list of switches from the ibnetdiscover output .SH SYNOPSIS .B ibprintswitch.pl [-R -l -C -P ] [] .SH DESCRIPTION .PP Faster than greping/viewing with an editor the output of ibnetdiscover, ibprintswitch.pl will parse out and print either the switch information for the switch specified or a list of all the switches found in the subnet. In addition, it will crudely parse on the node description information and if found report all the information for an entire chasis if the description information is consistent. Finally, ibprintswitch.pl will also reuse the cached ibnetdiscover output from some of the other diag tools which makes it a bit faster than running ibnetdiscover from scratch. .SH OPTIONS .PP .TP \fB\-l\fR List the switches (simply a wrapper for ibswitches). .TP \fB\-R\fR Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. .TP \fB\-C \fR use the specified ca_name for the search. .TP \fB\-P \fR use the specified ca_port for the search. .SH AUTHORS .TP Ira Weiny .RI < weiny2@llnl.gov > .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibcheckportstate.80000644013161601316160000000204211627544203016044 00000000000000.TH IBCHECKPORTSTATE 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibcheckportstate \- validate IB port for LinkUp and not Active state .SH SYNOPSIS .B ibcheckportstate [\-h] [\-v] [\-N | \-nocolor] [\-G] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] .SH DESCRIPTION .PP Check connectivity and check the specified port for proper port state (Active) and port physical state (LinkUp). Port address is a lid unless -G option is used to specify a GUID address. .SH OPTIONS .PP \-G use GUID address argument. In most cases, it is the Port GUID. Example: "0x08f1040023" .PP \-v increase the verbosity level .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH EXAMPLE .PP ibcheckportstate 2 3 # check lid 2 port 3 .SH SEE ALSO .BR smpquery(8), .BR ibaddr(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibcheckerrs.80000644013161601316160000000311211627544203014771 00000000000000.TH IBCHECKERRS 8 "May 30, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibcheckerrs \- validate IB port (or node) and report errors in counters above threshold .SH SYNOPSIS .B ibcheckerrs [\-h] [\-b] [\-v] [\-G] [\-T ] [\-s(how_thresholds)] [\-N | \-nocolor] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] .SH DESCRIPTION .PP Check specified port (or node) and report errors that surpassed their predefined threshold. Port address is lid unless -G option is used to specify a GUID address. The predefined thresholds can be dumped using the -s option, and a user defined threshold_file (using the same format as the dump) can be specified using the -t option. .SH OPTIONS .PP \-G use GUID address argument. In most cases, it is the Port GUID. Example: "0x08f1040023" .PP \-s show predefined thresholds .PP \-T use specified threshold file .PP \-v increase the verbosity level .PP \-b brief mode. Reduce the output to show only if errors are present, not what they are. .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH EXAMPLE .PP ibcheckerrs 2 # check aggregated node counter for lid 2 .PP ibcheckerrs 2 4 # check port counters for lid 2 port 4 .PP ibcheckerrs -T xxx 2 # check node using xxx threshold file .SH SEE ALSO .BR perfquery(8), .BR ibaddr(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibdatacounts.80000644013161601316160000000205611627544203015173 00000000000000.TH IBDATACOUNTS 8 "May 30, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibdatacounts \- get IB port data counters .SH SYNOPSIS .B ibdatacounts [\-h] [\-b] [\-v] [\-G] [\-N | \-nocolor] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] [] .SH DESCRIPTION .PP Obtain PMA data counters from specified port (or node). Port address is lid unless -G option is used to specify a GUID address. .SH OPTIONS .PP \-G use GUID address argument. In most cases, it is the Port GUID. Example: "0x08f1040023" .PP \-v increase the verbosity level .PP \-b brief mode .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH EXAMPLE .PP ibdatacounts 2 # show data counters for lid 2 .PP ibdatacounts 2 4 # show data counters for lid 2 port 4 .SH SEE ALSO .BR perfquery(8), .BR ibaddr(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibdiscover.80000644013161601316160000000235011627544203014641 00000000000000.TH IBDISCOVER.PL 8 "September 21, 2006" "OpenIB" "OpenIB Diagnostics" .SH NAME ibdiscover.pl \- annotate and compare InfiniBand topology .SH SYNOPSIS .B ibdiscover.pl .SH DESCRIPTION .PP ibdiscover.pl uses a topology file create by ibnetdiscover and a discover.map file which the network administrator creates which indicates the nodes to be expected and a ibdiscover.topo file which is the expected connectivity and produces a new connectivity file (discover.topo.new) and outputs the changes to stdout. The network administrator can choose to replace the "old" topo file with the new one or certain changes in. The syntax of the ibdiscover.map file is: |port|"Text for node"| e.g. 8f10400410015|8|"ISR 6000"|# SW-6IB4 Voltaire port 0 lid 5 8f10403960558|2|"HCA 1"|# MT23108 InfiniHost Mellanox Technologies The syntax of the old and new topo files (ibdiscover.topo and ibdiscover.topo.new) are: ||| e.g. 10|5442ba00003080|1|8f10400410015 These topo files are produced by the ibdiscover.pl tool. .SH USAGE .PP ibnetdiscover | ibdiscover.pl .SH SEE ALSO .BR ibnetdiscover(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibcheckwidth.80000644013161601316160000000145211627544204015143 00000000000000.TH IBCHECKWIDTH 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibcheckwidth \- find 1x links in IB subnet .SH SYNOPSIS .B ibcheckwidth [\-h] [\-v] [\-N | \-nocolor] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] .SH DESCRIPTION .PP ibcheckwidth is a script which uses a full topology file that was created by ibnetdiscover, scans the network to validate the active link widths and reports any 1x links. .SH OPTIONS .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH SEE ALSO .BR ibnetdiscover(8), .BR ibchecknode(8), .BR ibcheckportwidth(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/man/ibcheckportwidth.80000644013161601316160000000174711627544202016055 00000000000000.TH IBCHECKPORTWIDTH 8 "May 21, 2007" "OpenIB" "OpenIB Diagnostics" .SH NAME ibcheckportwidth \- validate IB port for 1x link width .SH SYNOPSIS .B ibcheckportwidth [\-h] [\-v] [\-N | \-nocolor] [\-G] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] .SH DESCRIPTION .PP Check connectivity and check the specified port for 1x link width. Port address is a lid unless -G option is used to specify a GUID address. .SH OPTIONS .PP \-G use GUID address argument. In most cases, it is the Port GUID. Example: "0x08f1040023" .PP \-v increase the verbosity level .PP \-N | \-nocolor use mono rather than color mode .PP \-C use the specified ca_name. .PP \-P use the specified ca_port. .PP \-t override the default timeout for the solicited mads. .SH EXAMPLE .PP ibcheckportwidth 2 3 # check lid 2 port 3 .SH SEE ALSO .BR smpquery(8), .BR ibaddr(8) .SH AUTHOR .TP Hal Rosenstock .RI < halr@voltaire.com > infiniband-diags-1.6.1/infiniband-diags.spec0000644013161601316160000002346012005566563015717 00000000000000 %define RELEASE 1 %define rel %{?CUSTOM_RELEASE}%{!?CUSTOM_RELEASE:%RELEASE} Summary: OpenFabrics Alliance InfiniBand Diagnostic Tools Name: infiniband-diags Version: 1.6.1 Release: %rel%{?dist} License: GPLv2 or BSD Group: System Environment/Libraries BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n) Source: http://www.openfabrics.org/downloads/management/infiniband-diags-1.6.1.tar.gz Url: http://openfabrics.org/ BuildRequires: libibmad-devel, opensm-devel, libibumad-devel Requires: libibmad, opensm-libs, libibumad Provides: perl(IBswcountlimits) Obsoletes: openib-diags %description This package provides IB diagnostic programs and scripts needed to diagnose an IB subnet. %package compat Summary: OpenFabrics Alliance InfiniBand Diagnostic Tools Group: System Environment/Libraries BuildRequires: libibmad-devel, opensm-devel, libibumad-devel Requires: libibmad, opensm-libs, libibumad %description compat Deprecated scripts and utilities which provide duplicated functionality, most often at a reduced performance. These are maintained for the time being for compatibility reasons. %prep %setup -q %build %configure --enable-compat-utils make %install rm -rf $RPM_BUILD_ROOT make DESTDIR=${RPM_BUILD_ROOT} install # remove unpackaged files from the buildroot rm -f $RPM_BUILD_ROOT%{_libdir}/*.la %clean rm -rf $RPM_BUILD_ROOT %files compat %defattr(-,root,root) %{_sbindir}/ibcheckerrs %{_mandir}/man8/ibcheckerrs.8.gz %{_sbindir}/ibchecknet %{_mandir}/man8/ibchecknet.8.gz %{_sbindir}/ibchecknode %{_mandir}/man8/ibchecknode.8.gz %{_sbindir}/ibcheckport %{_mandir}/man8/ibcheckport.8.gz %{_sbindir}/ibcheckportwidth %{_mandir}/man8/ibcheckportwidth.8.gz %{_sbindir}/ibcheckportstate %{_mandir}/man8/ibcheckportstate.8.gz %{_sbindir}/ibcheckwidth %{_mandir}/man8/ibcheckwidth.8.gz %{_sbindir}/ibcheckstate %{_mandir}/man8/ibcheckstate.8.gz %{_sbindir}/ibcheckerrors %{_mandir}/man8/ibcheckerrors.8.gz %{_sbindir}/ibdatacounts %{_mandir}/man8/ibdatacounts.8.gz %{_sbindir}/ibdatacounters %{_mandir}/man8/ibdatacounters.8.gz %{_sbindir}/ibdiscover.pl %{_mandir}/man8/ibdiscover.8.gz %{_sbindir}/ibswportwatch.pl %{_mandir}/man8/ibswportwatch.8.gz %{_sbindir}/ibqueryerrors.pl %{_sbindir}/iblinkinfo.pl %{_sbindir}/ibprintca.pl %{_mandir}/man8/ibprintca.8.gz %{_sbindir}/ibprintswitch.pl %{_mandir}/man8/ibprintswitch.8.gz %{_sbindir}/ibprintrt.pl %{_mandir}/man8/ibprintrt.8.gz %{_sbindir}/set_nodedesc.sh %files %defattr(-,root,root) # C programs here %{_sbindir}/ibaddr %{_mandir}/man8/ibaddr.8.gz %{_sbindir}/ibnetdiscover %{_mandir}/man8/ibnetdiscover.8.gz %{_sbindir}/ibping %{_mandir}/man8/ibping.8.gz %{_sbindir}/ibportstate %{_mandir}/man8/ibportstate.8.gz %{_sbindir}/ibroute %{_mandir}/man8/ibroute.8.gz %{_sbindir}/ibstat %{_mandir}/man8/ibstat.8.gz %{_sbindir}/ibsysstat %{_mandir}/man8/ibsysstat.8.gz %{_sbindir}/ibtracert %{_mandir}/man8/ibtracert.8.gz %{_sbindir}/perfquery %{_mandir}/man8/perfquery.8.gz %{_sbindir}/sminfo %{_mandir}/man8/sminfo.8.gz %{_sbindir}/smpdump %{_mandir}/man8/smpdump.8.gz %{_sbindir}/smpquery %{_mandir}/man8/smpquery.8.gz %{_sbindir}/saquery %{_mandir}/man8/saquery.8.gz %{_sbindir}/vendstat %{_mandir}/man8/vendstat.8.gz %{_sbindir}/iblinkinfo %{_mandir}/man8/iblinkinfo.8.gz %{_sbindir}/ibqueryerrors %{_mandir}/man8/ibqueryerrors.8.gz %{_sbindir}/ibcacheedit %{_mandir}/man8/ibcacheedit.8.gz %{_sbindir}/ibccquery %{_mandir}/man8/ibccquery.8.gz %{_sbindir}/ibccconfig %{_mandir}/man8/ibccconfig.8.gz # scripts here %{_sbindir}/ibhosts %{_mandir}/man8/ibhosts.8.gz %{_sbindir}/ibswitches %{_mandir}/man8/ibswitches.8.gz %{_sbindir}/ibnodes %{_mandir}/man8/ibnodes.8.gz %{_sbindir}/ibrouters %{_mandir}/man8/ibrouters.8.gz %{_sbindir}/ibfindnodesusing.pl %{_mandir}/man8/ibfindnodesusing.8.gz %{_sbindir}/ibidsverify.pl %{_mandir}/man8/ibidsverify.8.gz %{_sbindir}/check_lft_balance.pl %{_mandir}/man8/check_lft_balance.8.gz %{_sbindir}/dump_lfts.sh %{_mandir}/man8/dump_lfts.8.gz %{_sbindir}/dump_mfts.sh %{_mandir}/man8/dump_mfts.8.gz %{_sbindir}/ibclearerrors %{_mandir}/man8/ibclearerrors.8.gz %{_sbindir}/ibclearcounters %{_mandir}/man8/ibclearcounters.8.gz %{_sbindir}/ibstatus %{_mandir}/man8/ibstatus.8.gz # and the rest %{_mandir}/man8/infiniband-diags.8.gz %{_libdir}/*.a %{_libdir}/*.so* %{_mandir}/man3/* %{_includedir}/infiniband/*.h %define _perldir %(perl -e 'use Config; $T=$Config{installvendorlib}; print $T;') %{_perldir}/* %{_sysconfdir}/* %doc README COPYING ChangeLog %changelog * Mon Mar 03 2008 Albert Chu - 1.3.5 - Add check_lft_balance script. * Wed Oct 31 2007 Ira Weiny - 1.3.2 - Change switch-map option to node-name-map * Thu Aug 9 2007 Ira Weiny - 1.3.1 - Change set_mthca_nodedesc.sh to set_nodedesc.sh * Tue Jul 10 2007 Hal Rosenstock - 1.3.1 - Add link width and speed to topology file output in ibnetdiscover - Add support for -R(outer_list) in ibnetdiscover - Add script and man page for ibidsverify - Moved diags from bin to sbin - Add scripts and man pages for display on IB routers - Add GUID to output line for ports in ibqueryerrors.pl - Add ibdatacounts and ibdatacounters scripts and man pages - Add peer port link width and speed validation in iblinkinfo.pl - Display remote LID with peer port info in IBswcountlimits.pm - Handle peer ports at 1x that should be wider and 2.5 Gbps links that should be faster in ibportstate - Add LinkSpeed/Width components to output of ibportstate - Add support for IB routers - Add grouping support for ISR2012 and ISR2004 in ibnetdiscover - Remove all uses of "/tmp" from perl scripts - Add switch map support for saquery -O and -U options - Add support for saquery -s (isSMdisabled) - Add name input checks to saquery (-O and -U) * Thu Mar 29 2007 Hal Rosenstock - 1.3.0 - Add some extra debug information to IBswcountlimits.pm - Send normal output to stdout in ibtracert - Don't truncate NodeDescriptions containing ctl characters in ibdiag_common - Fix ibnetdiscover grouping for Cisco SFS7000 - Add support to query the GUIDInfo table in smpquery - Allow user to specify a default switch map file * Fri Mar 9 2007 Hal Rosenstock - 1.2.5 - Find perl modules in perl sitearch directory - Fix non standard prefix install for diag scripts - Clean gcc-4.1 warnings in saquery and ibdiag_common * Fri Mar 2 2007 Hal Rosenstock - 1.2.4 - OpenFabrics 1.2.4 release - Fix diag rpmbuild from make dist - Include set_mthca_nodedesc.sh and dump_lfts.sh in the rpm * Thu Mar 1 2007 Hal Rosenstock - 1.2.3 - OpenFabrics 1.2.3 release - Fixed saquery timeout handling * Tue Feb 27 2007 Hal Rosenstock - 1.2.2 - OpenFabrics 1.2.2 release - Minor changes to ibswitches and ibhosts output * Thu Feb 14 2007 Hal Rosenstock - 1.2.1 - OpenFabrics 1.2.1 release - Initial release of vendstat tool * Fri Feb 2 2007 Hal Rosenstock - 1.2.0 - OpenFabrics 1.2.0 release - Added brief option to ibcheckerrors and ibcheckerrs - Updated man pages - Added build version to saquery and updated build version tags of other tools - Added -N | nocolor to usage display of scripts - Fixed -nocolor and -G options on scripts - Fixed error return status in ibchecknet - Added exit code to ibcheckerrors - Added nodename to output of ibcheckerrs - ibqueryerrors.pl fixes and improvements - Removed use of tmpfile for ibroute data in ibfindnodeusing.pl - Fixed undefined subroutine error in iblinkinfo.pl - Added switch-map option to ibtracert and ibnetdiscover - Cleaned up node descriptions before printing in saquery - Clarified --src-to-dst option in saquery - Added peer NodeDescription and LID to output of inbetdiscover - For grouping, ordered Spine and Line Nodes (for Voltaire chassis) in ibnetdiscover - Cleaned up node descriptions before printing in ibtracert and ibroute - Added additional sematics to -m option of saquery - Added dump_mfts.sh similar to dump_lfts.sh - ibnetdiscover improvements (memory leaks, ports moving, etc.) - Converted iblinkspeed.pl into iblinkinfo.pl and added additional capabilities - Added 0x in front of GUID printing of ibtracert - Fixed loopback handling in ibnetdiscover - Added support for querying Service Records to saquery - Added support for PerfMgt IsExtendedWidthSupported IBA 1.2 erratum in perfquery - For query operations, added peer port checking of linkwidth and speed active in ibportstate - Added support for DrSLID in smpquery - Added IB router support to ibnetdiscover and ibtracert - Added additional options to saquery - Added support to change LinkSpeedEnabled in ibportstate * Fri Sep 22 2006 Hal Rosenstock - 1.1.0 - OpenFabrics 1.1 release * Wed Sep 13 2006 Hal Rosenstock - 1.1.0-rc5 - OpenFabrics 1.1-rc5 release * Wed Sep 6 2006 Hal Rosenstock - 1.1.0-rc4 - OpenFabrics 1.1-rc4 release * Wed Aug 23 2006 Hal Rosenstock - 1.1.0-rc3 - OpenFabrics 1.1-rc3 release * Mon Aug 14 2006 Hal Rosenstock - 1.1.0-rc2 - OpenFabrics 1.1-rc2 release - Added ibsysstat man page * Wed Jul 26 2006 Hal Rosenstock - 1.1.0-rc1 - OpenFabrics 1.1-rc1 release - Added man pages - Made diag command/script options more consistent - saquery tool added - dump_lft.sh script added - Renamed discover.pl to ibdiscover.pl * Sun Jun 10 2006 Hal Rosenstock - 1.0-1 - OpenFabrics 1.0 release * Tue May 30 2006 Hal Rosenstock - 1.0.0-rc6 - Maintenance release * Fri May 12 2006 Hal Rosenstock - 1.0.0-rc5 - Maintenance release * Thu Apr 27 2006 Hal Rosenstock - 1.0.0-rc4 - Maintenance release - Note rc3 skipped to sync with OFED * Mon Apr 10 2006 Hal Rosenstock - 1.0.0-rc2 - Maintenance release * Mon Feb 27 2006 Hal Rosenstock - 1.0.0-rc1 - Initial spec file and release infiniband-diags-1.6.1/README0000644013161601316160000000115612005565531012525 00000000000000InfiniBand Diagnostic Tools infiniband-diags is a set of utilities designed to help configure, debug, and maintain infiniband fabrics. Many tools and utilities are provided. Some with similar functionality. In addition to the utilities provided a sub-library libibnetdisc is provided to scan an entire IB fabric and return data structures representing it. The interface to this library is _not_ guaranteed to be stable (though we try.) Dependencies: 1) libibmad >= 1.3.9 2) libibumad >= 1.3.7 3) opensm-libs >= 3.3.10 4) ib_umad kernel module Release notes v1.6.0 => 1.6.1 1) bug fixes and code clean up infiniband-diags-1.6.1/doc/0000755013161601316160000000000012003635256012467 500000000000000infiniband-diags-1.6.1/doc/man/0000755013161601316160000000000012005566564013251 500000000000000infiniband-diags-1.6.1/doc/man/ibstatus.80000644013161601316160000000316612005566564015126 00000000000000.\" Man page generated from reStructeredText. . .TH IBSTATUS 8 "" "" "Open IB Diagnostics" .SH NAME IBSTATUS \- . .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 .. .SH query basic status of InfiniBand device(s) .SS SYNOPSIS .sp ibstatus [\-h] [devname[:port]]... .SS DESCRIPTION .sp ibstatus is a script which displays basic information obtained from the local IB driver. Output includes LID, SMLID, port state, link width active, and port physical state. .SS OPTIONS .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .INDENT 0.0 .TP .B \fBdevname\fP .sp InfiniBand device name .TP .B \fBportnum\fP .sp port number of InfiniBand device .UNINDENT .SS EXAMPLES .INDENT 0.0 .TP .B :: . ibstatus # display status of all IB ports ibstatus mthca1 # status of mthca1 ports ibstatus mthca1:1 mthca0:2 # show status of specified ports .UNINDENT .SS SEE ALSO .sp \fBibstat (8)\fP .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibsysstat.8.in0000644013161601316160000001021112005566560015703 00000000000000.\" Man page generated from reStructeredText. . .TH IBSYSSTAT 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBSYSSTAT \- . .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 .. .SH system status on an InfiniBand address .SS SYNOPSIS .sp ibsysstat [options] [] .SS DESCRIPTION .sp ibsysstat uses vendor mads to validate connectivity between IB nodes and obtain other information about the IB node. ibsysstat is run as client/server. Default is to run as client. .SS OPTIONS .sp Current supported operations: .INDENT 0.0 .TP .B :: . ping \- verify connectivity to server (default) host \- obtain host information from server cpu \- obtain cpu information from server .TP .B \fB\-o, \-\-oui\fP .sp use specified OUI number to multiplex vendor mads .TP .B \fB\-S, \-\-Server\fP .sp start in server mode (do not return) .UNINDENT .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/dump_lfts.8.in0000644013161601316160000001122012005566554015657 00000000000000.\" Man page generated from reStructeredText. . .TH DUMP_LFTS.SH 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME DUMP_LFTS.SH \- dump InfiniBand unicast forwarding tables . .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 .. .SH SYNOPSIS .sp dump_lfts.sh [\-h] [\-D] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] [>/path/to/dump\-file] .SH DESCRIPTION .sp dump_lfts.sh is a script which dumps the InfiniBand unciast forwarding tables (MFTs) in the switch nodes in the subnet. .sp The dump file format is compatible with loading into OpenSM using the \-R file \-U /path/to/dump\-file syntax. .SH OPTIONS .sp \fB\-D\fP dump forwarding tables using direct routed rather than LID routed SMPs .sp \fB\-h\fP show help .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp \fBdump_mfts(8), ibroute(8), ibswitches(8), opensm(8)\fP .SH AUTHORS .INDENT 0.0 .TP .B Sasha Khapyorsky . < \fI\%sashak@voltaire.com\fP > .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibtracert.8.in0000644013161601316160000001476012005566560015652 00000000000000.\" Man page generated from reStructeredText. . .TH IBTRACERT 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBTRACERT \- . .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 .. .SH trace InfiniBand path .SS SYNOPSIS .sp ibtracert [options] [ [ []]] .SS DESCRIPTION .sp ibtracert uses SMPs to trace the path from a source GID/LID to a destination GID/LID. Each hop along the path is displayed until the destination is reached or a hop does not respond. By using the \-m option, multicast path tracing can be performed between source and destination nodes. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-n, \-\-no_info\fP .sp simple format; don\(aqt show additional information .TP .B \fB\-m\fP .sp show the multicast trace of the specified mlid .UNINDENT .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SS EXAMPLES .sp Unicast examples .INDENT 0.0 .TP .B :: . ibtracert 4 16 # show path between lids 4 and 16 ibtracert \-n 4 16 # same, but using simple output format ibtracert \-G 0x8f1040396522d 0x002c9000100d051 # use guid addresses .UNINDENT .sp Multicast example .INDENT 0.0 .TP .B :: . ibtracert \-m 0xc000 4 16 # show multicast path of mlid 0xc000 between lids 4 and 16 .UNINDENT .SS SEE ALSO .sp ibroute (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . <\fI\%hal.rosenstock@gmail.com\fP> .TP .B Ira Weiny . <\fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibccconfig.80000644013161601316160000001254012005566563015351 00000000000000.\" Man page generated from reStructeredText. . .TH IBCCCONFIG 8 "" "" "OpenIB Diagnostics" .SH NAME IBCCCONFIG \- configure congestion control settings . .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 .. .SH SYNOPSIS .sp ibccconfig [common_options] [\-c cckey] [port] .SH DESCRIPTION .sp \fBibccconfig\fP supports the configuration of congestion control settings on switches and HCAs. .sp \fBWARNING \-\- You should understand what you are doing before using this tool. Misuse of this tool could result in a broken fabric.\fP .SH OPTIONS .INDENT 0.0 .TP .B Current supported operations and their parameters: . CongestionKeyInfo (CK) SwitchCongestionSetting (SS) SwitchPortCongestionSetting (SP) CACongestionSetting (CS) CongestionControlTable (CT) ... .UNINDENT .sp \fB\-\-cckey, \-c, \fP Specify a congestion control (CC) key. If none is specified, a key of 0 is used. .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SH EXAMPLES .sp .nf .ft C ibccconfig SwitchCongestionSetting 2 0x1F 0x1FFFFFFFFF 0x0 0xF 8 0 0:0 1 # Configure Switch Congestion Settings ibccconfig CACongestionSetting 1 0 0x3 150 1 0 0 # Configure CA Congestion Settings to SL 0 and SL 1 ibccconfig CACongestionSetting 1 0 0x4 200 1 0 0 # Configure CA Congestion Settings to SL 2 ibccconfig CongestionControlTable 1 63 0 0:0 0:1 ... # Configure first block of Congestion Control Table ibccconfig CongestionControlTable 1 127 0 0:64 0:65 ... # Configure second block of Congestion Control Table .ft P .fi .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH AUTHOR .INDENT 0.0 .TP .B Albert Chu . < \fI\%chu11@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/dump_lfts.80000644013161601316160000001123212005566563015255 00000000000000.\" Man page generated from reStructeredText. . .TH DUMP_LFTS.SH 8 "" "" "OpenIB Diagnostics" .SH NAME DUMP_LFTS.SH \- dump InfiniBand unicast forwarding tables . .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 .. .SH SYNOPSIS .sp dump_lfts.sh [\-h] [\-D] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] [>/path/to/dump\-file] .SH DESCRIPTION .sp dump_lfts.sh is a script which dumps the InfiniBand unciast forwarding tables (MFTs) in the switch nodes in the subnet. .sp The dump file format is compatible with loading into OpenSM using the \-R file \-U /path/to/dump\-file syntax. .SH OPTIONS .sp \fB\-D\fP dump forwarding tables using direct routed rather than LID routed SMPs .sp \fB\-h\fP show help .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp \fBdump_mfts(8), ibroute(8), ibswitches(8), opensm(8)\fP .SH AUTHORS .INDENT 0.0 .TP .B Sasha Khapyorsky . < \fI\%sashak@voltaire.com\fP > .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibswitches.8.in0000644013161601316160000001057012005566560016032 00000000000000.\" Man page generated from reStructeredText. . .TH IBSWITCHES 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBSWITCHES \- show InfiniBand switch nodes in topology . .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 .. .SH SYNOPSIS .sp ibswitches [options] [] .SH DESCRIPTION .sp ibswitches is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the switch nodes. .SH OPTIONS .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp ibnetdiscover(8) .SH DEPENDENCIES .sp ibnetdiscover, ibnetdiscover format .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/sminfo.80000644013161601316160000001177312005566564014566 00000000000000.\" Man page generated from reStructeredText. . .TH SMINFO 8 "" "" "Open IB Diagnostics" .SH NAME SMINFO \- . .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 .. .SH query InfiniBand SMInfo attribute .SS SYNOPSIS .sp sminfo [options] sm_lid | sm_dr_path [modifier] .SS DESCRIPTION .sp Optionally set and display the output of a sminfo query in human readable format. The target SM is the one listed in the local port info, or the SM specified by the optional SM lid or by the SM direct routed path. .sp Note: using sminfo for any purposes other then simple query may be very dangerous, and may result in a malfunction of the target SM. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-s, \-\-state \fP set SM state .sp 0 not active .sp 1 discovering .sp 2 standby .sp 3 master .UNINDENT .sp \fB\-p, \-\-priority \fP set priority (0\-15) .sp \fB\-a, \-\-activity \fP set activity count .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .INDENT 0.0 .TP .B :: . sminfo # local port\(aqs sminfo sminfo 32 # show sminfo of lid 32 sminfo \-G 0x8f1040023 # same but using guid address .UNINDENT .SS SEE ALSO .sp smpdump (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/dump_mfts.80000644013161601316160000001075212005566563015264 00000000000000.\" Man page generated from reStructeredText. . .TH DUMP_MFTS.SH 8 "" "" "OpenIB Diagnostics" .SH NAME DUMP_MFTS.SH \- dump InfiniBand multicast forwarding tables . .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 .. .SH SYNOPSIS .sp dump_mfts.sh [\-h] [\-D] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] [>/path/to/file] .SH DESCRIPTION .sp dump_mfts.sh is a script which dumps the InfiniBand multicast forwarding tables (MFTs) in the switch nodes in the subnet. .SH OPTIONS .sp \fB\-D\fP dump forwarding tables using direct routed rather than LID routed SMPs .sp \fB\-h\fP show help .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp \fBdump_lfts(8), ibroute(8), ibswitches(8), opensm(8)\fP .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibclearcounters.8.in0000644013161601316160000000476412005566555017066 00000000000000.\" Man page generated from reStructeredText. . .TH IBCLEARCOUNTERS 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBCLEARCOUNTERS \- . .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 .. .SH clear port counters in IB subnet .SS SYNOPSIS .sp ibclearcounters [\-h] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] .SS DESCRIPTION .sp ibclearcounters is a script that clears the PMA port counters by either walking the IB subnet topology or using an already saved topology file. .SS OPTIONS .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .SS SEE ALSO .sp \fBibnetdiscover(8), perfquery(8)\fP .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/smpdump.80000644013161601316160000001120412005566564014745 00000000000000.\" Man page generated from reStructeredText. . .TH SMPDUMP 8 "" "" "Open IB Diagnostics" .SH NAME SMPDUMP \- . .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 .. .SH dump InfiniBand subnet management attributes .SS SYNOPSIS .sp smpdump [options] [attribute_modifier] .SS DESCRIPTION .sp smpdump is a general purpose SMP utility which gets SM attributes from a specified SMA. The result is dumped in hex by default. .SS OPTIONS .INDENT 0.0 .TP .B \fBdlid|drpath\fP .sp LID or DR path to SMA .TP .B \fBattribute\fP .sp IBA attribute ID for SM attribute .TP .B \fBattribute_modifier\fP .sp IBA modifier for SM attribute .TP .B \fB\-s, \-\-string\fP .sp Print strings in packet if possible .UNINDENT .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .sp Direct Routed Examples .INDENT 0.0 .TP .B :: . smpdump \-D 0,1,2,3,5 16 # NODE DESC smpdump \-D 0,1,2 0x15 2 # PORT INFO, port 2 .UNINDENT .sp LID Routed Examples .INDENT 0.0 .TP .B :: . smpdump 3 0x15 2 # PORT INFO, lid 3 port 2 smpdump 0xa0 0x11 # NODE INFO, lid 0xa0 .UNINDENT .SS SEE ALSO .sp smpquery (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibnodes.8.in0000644013161601316160000001056412005566556015321 00000000000000.\" Man page generated from reStructeredText. . .TH IBNODES 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBNODES \- show InfiniBand nodes in topology . .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 .. .SH SYNOPSIS .sp ibnodes [options] [] .SH DESCRIPTION .sp ibnodes is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the IB nodes (CAs and switches). .SH OPTIONS .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp ibnetdiscover(8) .SH DEPENDENCIES .sp ibnetdiscover, ibnetdiscover format .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibswitches.80000644013161601316160000001060212005566564015425 00000000000000.\" Man page generated from reStructeredText. . .TH IBSWITCHES 8 "" "" "OpenIB Diagnostics" .SH NAME IBSWITCHES \- show InfiniBand switch nodes in topology . .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 .. .SH SYNOPSIS .sp ibswitches [options] [] .SH DESCRIPTION .sp ibswitches is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the switch nodes. .SH OPTIONS .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp ibnetdiscover(8) .SH DEPENDENCIES .sp ibnetdiscover, ibnetdiscover format .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibsysstat.80000644013161601316160000001022312005566564015305 00000000000000.\" Man page generated from reStructeredText. . .TH IBSYSSTAT 8 "" "" "Open IB Diagnostics" .SH NAME IBSYSSTAT \- . .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 .. .SH system status on an InfiniBand address .SS SYNOPSIS .sp ibsysstat [options] [] .SS DESCRIPTION .sp ibsysstat uses vendor mads to validate connectivity between IB nodes and obtain other information about the IB node. ibsysstat is run as client/server. Default is to run as client. .SS OPTIONS .sp Current supported operations: .INDENT 0.0 .TP .B :: . ping \- verify connectivity to server (default) host \- obtain host information from server cpu \- obtain cpu information from server .TP .B \fB\-o, \-\-oui\fP .sp use specified OUI number to multiplex vendor mads .TP .B \fB\-S, \-\-Server\fP .sp start in server mode (do not return) .UNINDENT .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/infiniband-diags.80000644013161601316160000003240312005566564016452 00000000000000.\" Man page generated from reStructeredText. . .TH INFINIBAND-DIAGS 8 "" "" "Open IB Diagnostics" .SH NAME INFINIBAND-DIAGS \- . .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 .. .SH Diagnostics for InfiniBand Fabrics .SS DESCRIPTION .sp infiniband\-diags is a set of utilities designed to help configure, debug, and maintain infiniband fabrics. Many tools and utilities are provided. Some with similar functionality. .sp The base utilities use directed route MAD\(aqs to perform their operations. They may therefore work even in unconfigured subnets. Other, higher level utilities, require LID routed MAD\(aqs and to some extent SA/SM access. .SS THE USE OF SMPs (QP0) .sp Many of the tools in this package rely on the use of SMPs via QP0 to acquire data directly from the SMA. While this mode of operation is not technically in compliance with the InfiniBand specification, practical experience has found that this level of diagnostics is valuable when working with a fabric which is broken or only partially configured. For this reason many of these tools may require the use of an MKey or operation from Virtual Machines may be restricted for security reasons. .SS COMMON OPTIONS .sp Most OpenIB diagnostics take some of the following common flags. The exact list of supported flags per utility can be found in the documentation for those commands. .SS Addressing Flags .sp The \-D and \-G option have two forms: .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct \fP The address specified is a directed route .sp .nf .ft C Examples: \-D "0" # self port \-D "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -G . .sp \fB\-\-port\-guid, \-G \fP Specify a port_guid .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS COMMON FILES .sp The following config files are common amongst many of the utilities. .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .\" Common text to describe the Topology file. . .SS TOPOLOGY FILE FORMAT .sp The topology file format is human readable and largely intuitive. Most identifiers are given textual names like vendor ID (vendid), device ID (device ID), GUIDs of various types (sysimgguid, caguid, switchguid, etc.). PortGUIDs are shown in parentheses (). For switches, this is shown on the switchguid line. For CA and router ports, it is shown on the connectivity lines. The IB node is identified followed by the number of ports and a quoted the node GUID. On the right of this line is a comment (#) followed by the NodeDescription in quotes. If the node is a switch, this line also contains whether switch port 0 is base or enhanced, and the LID and LMC of port 0. Subsequent lines pertaining to this node show the connectivity. On the left is the port number of the current node. On the right is the peer node (node at other end of link). It is identified in quotes with nodetype followed by \- followed by NodeGUID with the port number in square brackets. Further on the right is a comment (#). What follows the comment is dependent on the node type. If it it a switch node, it is followed by the NodeDescription in quotes and the LID of the peer node. If it is a CA or router node, it is followed by the local LID and LMC and then followed by the NodeDescription in quotes and the LID of the peer node. The active link width and speed are then appended to the end of this output line. .sp An example of this is: .sp .nf .ft C # # Topology file: generated on Tue Jun 5 14:15:10 2007 # # Max of 3 hops discovered # Initiated from node 0008f10403960558 port 0008f10403960559 Non\-Chassis Nodes vendid=0x8f1 devid=0x5a06 sysimgguid=0x5442ba00003000 switchguid=0x5442ba00003080(5442ba00003080) Switch 24 "S\-005442ba00003080" # "ISR9024 Voltaire" base port 0 lid 6 lmc 0 [22] "H\-0008f10403961354"[1](8f10403961355) # "MT23108 InfiniHost Mellanox Technologies" lid 4 4xSDR [10] "S\-0008f10400410015"[1] # "SW\-6IB4 Voltaire" lid 3 4xSDR [8] "H\-0008f10403960558"[2](8f1040396055a) # "MT23108 InfiniHost Mellanox Technologies" lid 14 4xSDR [6] "S\-0008f10400410015"[3] # "SW\-6IB4 Voltaire" lid 3 4xSDR [12] "H\-0008f10403960558"[1](8f10403960559) # "MT23108 InfiniHost Mellanox Technologies" lid 10 4xSDR vendid=0x8f1 devid=0x5a05 switchguid=0x8f10400410015(8f10400410015) Switch 8 "S\-0008f10400410015" # "SW\-6IB4 Voltaire" base port 0 lid 3 lmc 0 [6] "H\-0008f10403960984"[1](8f10403960985) # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR [4] "H\-005442b100004900"[1](5442b100004901) # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR [1] "S\-005442ba00003080"[10] # "ISR9024 Voltaire" lid 6 1xSDR [3] "S\-005442ba00003080"[6] # "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960984 Ca 2 "H\-0008f10403960984" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403960985) "S\-0008f10400410015"[6] # lid 16 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x5442b100004900 Ca 2 "H\-005442b100004900" # "MT23108 InfiniHost Mellanox Technologies" [1](5442b100004901) "S\-0008f10400410015"[4] # lid 12 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403961354 Ca 2 "H\-0008f10403961354" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403961355) "S\-005442ba00003080"[22] # lid 4 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960558 Ca 2 "H\-0008f10403960558" # "MT23108 InfiniHost Mellanox Technologies" [2](8f1040396055a) "S\-005442ba00003080"[8] # lid 14 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR [1](8f10403960559) "S\-005442ba00003080"[12] # lid 10 lmc 1 "ISR9024 Voltaire" lid 6 1xSDR .ft P .fi .sp When grouping is used, IB nodes are organized into chassis which are numbered. Nodes which cannot be determined to be in a chassis are displayed as "Non\-Chassis Nodes". External ports are also shown on the connectivity lines. .SS Utilities list .SS Basic fabric conectivity .INDENT 0.0 .INDENT 3.5 .sp See: ibnetdiscover, iblinkinfo .UNINDENT .UNINDENT .SS Node information .INDENT 0.0 .INDENT 3.5 .sp See: ibnodes, ibswitches, ibhosts, ibrouters .UNINDENT .UNINDENT .SS Port information .INDENT 0.0 .INDENT 3.5 .sp See: ibportstate, ibaddr .UNINDENT .UNINDENT .SS Switch Forwarding Table info .INDENT 0.0 .INDENT 3.5 .sp See: ibtracert, ibroute, dump_lfts, dump_mfts, check_lft_balance, ibfindnodesusing .UNINDENT .UNINDENT .SS Peformance counters .INDENT 0.0 .INDENT 3.5 .sp See: ibqueryerrors, perfquery .UNINDENT .UNINDENT .SS Local HCA info .INDENT 0.0 .INDENT 3.5 .sp See: ibstat, ibstatus .UNINDENT .UNINDENT .SS Connectivity check .INDENT 0.0 .INDENT 3.5 .sp See: ibping, ibsysstat .UNINDENT .UNINDENT .SS Low level query tools .INDENT 0.0 .INDENT 3.5 .sp See: smpquery, smpdump, saquery, sminfo .UNINDENT .UNINDENT .SS Fabric verification tools .INDENT 0.0 .INDENT 3.5 .sp See: ibidsverify .UNINDENT .UNINDENT .SS Backwards compatibility scripts .sp The following scripts have been identified as redundant and/or lower performing as compared to the above scripts. They are provided as legacy scripts when \-\-enable\-compat\-utils is specified at build time. .sp ibcheckerrors, ibclearcounters, ibclearerrors, ibdatacounters ibchecknet, ibchecknode, ibcheckport, ibcheckportstate, ibcheckportwidth, ibcheckstate, ibcheckwidth, ibswportwatch, ibprintca, ibprintrt, ibprintswitch, set_nodedesc.sh .SS AUTHORS .INDENT 0.0 .TP .B Ira Weiny . <\fI\%weiny2@llnl.gov\fP> .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibfindnodesusing.8.in0000644013161601316160000000661112005566555017225 00000000000000.\" Man page generated from reStructeredText. . .TH IBFINDNODESUSING 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBFINDNODESUSING \- . .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 .. .SH find a list of end nodes which are routed through the specified switch and port .SS SYNOPSIS .sp ibfindnodesusing.pl [options] .SS DESCRIPTION .sp ibfindnodesusing.pl uses ibroute and detects the current nodes which are routed through both directions of the link specified. The link is specified by one switch port end; the script finds the remote end automatically. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-h\fP .sp show help .TP .B \fB\-R\fP .sp Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. .UNINDENT .sp \fB\-C \fP use the specified ca_name. .sp \fB\-P \fP use the specified ca_port. .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SS AUTHOR .INDENT 0.0 .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibfindnodesusing.80000644013161601316160000000661012005566563016616 00000000000000.\" Man page generated from reStructeredText. . .TH IBFINDNODESUSING 8 "" "" "Open IB Diagnostics" .SH NAME IBFINDNODESUSING \- . .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 .. .SH find a list of end nodes which are routed through the specified switch and port .SS SYNOPSIS .sp ibfindnodesusing.pl [options] .SS DESCRIPTION .sp ibfindnodesusing.pl uses ibroute and detects the current nodes which are routed through both directions of the link specified. The link is specified by one switch port end; the script finds the remote end automatically. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-h\fP .sp show help .TP .B \fB\-R\fP .sp Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. .UNINDENT .sp \fB\-C \fP use the specified ca_name. .sp \fB\-P \fP use the specified ca_port. .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SS AUTHOR .INDENT 0.0 .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/iblinkinfo.80000644013161601316160000002205112005566563015405 00000000000000.\" Man page generated from reStructeredText. . .TH IBLINKINFO 8 "" "" "OpenIB Diagnostics" .SH NAME IBLINKINFO \- report link info for all links in the fabric . .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 .. .SH SYNOPSIS .sp iblinkinfo .SH DESCRIPTION .sp iblinkinfo reports link info for each port in an IB fabric, node by node. Optionally, iblinkinfo can do partial scans and limit its output to parts of a fabric. .SH OPTIONS .sp \fB\-\-down, \-d\fP Print only nodes which have a port in the "Down" state. .sp \fB\-\-line, \-l\fP Print all information for each link on one line. Default is to print a header with the node information and then a list for each port (useful for grep\(aqing output). .sp \fB\-\-additional, \-p\fP Print additional port settings (,,) .sp \fB\-\-switches\-only\fP Show only switches in output. .sp \fB\-\-cas\-only\fP Show only CAs in output. .SS Partial Scan flags .sp The node to start a partial scan can be specified with the following addresses. .\" Define the common option -G . .sp \fB\-\-port\-guid, \-G \fP Specify a port_guid .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct \fP The address specified is a directed route .sp .nf .ft C Examples: \-D "0" # self port \-D "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .sp \fBNote:\fP For switches results are printed for all ports not just switch port 0. .sp \fB\-\-switch, \-S \fP same as "\-G". (provided only for backward compatibility) .sp How much of the scan to be printed can be controled with the following. .sp \fB\-\-all, \-a\fP Print all nodes found in a partial fabric scan. Normally a partial fabric scan will return only the node specified. This option will print the other nodes found as well. .sp \fB\-\-hops, \-n \fP Specify the number of hops away from a specified node to scan. This is useful to expand a partial fabric scan beyond the node specified. .SS Cache File flags .\" Define the common option load-cache . .sp \fB\-\-load\-cache \fP Load and use the cached ibnetdiscover data stored in the specified filename. May be useful for outputting and learning about other fabrics or a previous state of a fabric. .\" Define the common option diff . .sp \fB\-\-diff \fP Load cached ibnetdiscover data and do a diff comparison to the current network or another cache. A special diff output for ibnetdiscover output will be displayed showing differences between the old and current fabric. By default, the following are compared for differences: switches, channel adapters, routers, and port connections. .\" Define the common option diffcheck . .sp \fB\-\-diffcheck \fP Specify what diff checks should be done in the \fB\-\-diff\fP option above. Comma separate multiple diff check key(s). The available diff checks are: \fBsw = switches\fP, \fBca = channel adapters\fP, \fBrouter\fP = routers, \fBport\fP = port connections, \fBlid\fP = lids, \fBnodedesc\fP = node descriptions. Note that \fBport\fP, \fBlid\fP, and \fBnodedesc\fP are checked only for the node types that are specified (e.g. \fBsw\fP, \fBca\fP, \fBrouter\fP). If \fBport\fP is specified alongside \fBlid\fP or \fBnodedesc\fP, remote port lids and node descriptions will also be compared. .sp \fB\-\-filterdownports \fP Filter downports indicated in a ibnetdiscover cache. If a port was previously indicated as down in the specified cache, and is still down, do not output it in the resulting output. This option may be particularly useful for environments where switches are not fully populated, thus much of the default iblinkinfo info is considered unuseful. See \fBibnetdiscover\fP for information on caching ibnetdiscover output. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .SS Debugging flags .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .sp \fB\-R\fP (This option is obsolete and does nothing) .SH EXIT STATUS .sp 0 on success, \-1 on failure to scan the fabric, 1 if check mode is used and inconsistencies are found. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH AUTHOR .INDENT 0.0 .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibidsverify.80000644013161601316160000000415212005566563015602 00000000000000.\" Man page generated from reStructeredText. . .TH IBIDSVERIFY 8 "" "" "Open IB Diagnostics" .SH NAME IBIDSVERIFY \- . .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 .. .SH validate IB identifiers in subnet and report errors .SS SYNOPSIS .sp ibidsverify.pl [\-h] [\-R] .SS DESCRIPTION .sp ibidsverify.pl is a perl script which uses a full topology file that was created by ibnetdiscover, scans the network to validate the LIDs and GUIDs in the subnet. The validation consists of checking that there are no zero or duplicate identifiers. .sp Finally, ibidsverify.pl will also reuse the cached ibnetdiscover output from some of the other diag tools which makes it a bit faster than running ibnetdiscover from scratch. .SS OPTIONS .sp \fB\-R\fP Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe the fabric has changed. .sp \fB\-C \fP use the specified ca_name. .sp \fB\-P \fP use the specified ca_port. .SS EXIT STATUS .sp Exit status is 1 if errors are found, 0 otherwise. .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS SEE ALSO .sp \fBibnetdiscover(8)\fP .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibping.8.in0000644013161601316160000001011712005566556015140 00000000000000.\" Man page generated from reStructeredText. . .TH IBPING 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBPING \- ping an InfiniBand address . .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 .. .SH SYNOPSIS .sp ibping [options] .SH DESCRIPTION .sp ibping uses vendor mads to validate connectivity between IB nodes. On exit, (IP) ping like output is show. ibping is run as client/server. Default is to run as client. Note also that a default ping server is implemented within the kernel. .SH OPTIONS .sp \fB\-c, \-\-count\fP stop after count packets .sp \fB\-f, \-\-flood\fP flood destination: send packets back to back without delay .sp \fB\-o, \-\-oui\fP use specified OUI number to multiplex vendor mads .sp \fB\-S, \-\-Server\fP start in server mode (do not return) .SS Addressing Flags .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .SS Debugging flags .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibstat.80000644013161601316160000000516212005566563014553 00000000000000.\" Man page generated from reStructeredText. . .TH IBSTAT 8 "" "" "Open IB Diagnostics" .SH NAME IBSTAT \- . .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 .. .SH query basic status of InfiniBand device(s) .SS SYNOPSIS .sp ibstat [options] [portnum] .SS DESCRIPTION .sp ibstat is a binary which displays basic information obtained from the local IB driver. Output includes LID, SMLID, port state, link width active, and port physical state. .sp It is similar to the ibstatus utility but implemented as a binary rather than a script. It has options to list CAs and/or ports and displays more information than ibstatus. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-l, \-\-list_of_cas\fP .sp list all IB devices .TP .B \fB\-s, \-\-short\fP .sp short output .TP .B \fB\-p, \-\-port_list\fP .sp show port list .TP .B \fBca_name\fP .sp InfiniBand device name .TP .B \fBportnum\fP .sp port number of InfiniBand device .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS EXAMPLES .INDENT 0.0 .TP .B :: . ibstat # display status of all ports on all IB devices ibstat \-l # list all IB devices ibstat \-p # show port guids ibstat mthca0 2 # show status of port 2 of \(aqmthca0\(aq .UNINDENT .SS SEE ALSO .sp ibstatus (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibnetdiscover.8.in0000644013161601316160000003044712005566556016540 00000000000000.\" Man page generated from reStructeredText. . .TH IBNETDISCOVER 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBNETDISCOVER \- discover InfiniBand topology . .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 .. .SH SYNOPSIS .sp ibnetdiscover [options] [] .SH DESCRIPTION .sp ibnetdiscover performs IB subnet discovery and outputs a human readable topology file. GUIDs, node types, and port numbers are displayed as well as port LIDs and NodeDescriptions. All nodes (and links) are displayed (full topology). Optionally, this utility can be used to list the current connected nodes by nodetype. The output is printed to standard output unless a topology file is specified. .SH OPTIONS .sp \fB\-l, \-\-list\fP List of connected nodes .sp \fB\-g, \-\-grouping\fP Show grouping. Grouping correlates IB nodes by different vendor specific schemes. It may also show the switch external ports correspondence. .sp \fB\-H, \-\-Hca_list\fP List of connected CAs .sp \fB\-S, \-\-Switch_list\fP List of connected switches .sp \fB\-R, \-\-Router_list\fP List of connected routers .sp \fB\-s, \-\-show\fP Show progress information during discovery. .sp \fB\-p, \-\-ports\fP Obtain a ports report which is a list of connected ports with relevant information (like LID, portnum, GUID, width, speed, and NodeDescription). .sp \fB\-m, \-\-max_hops\fP Report max hops discovered. .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .SS Cache File flags .\" Define the common option cache . .sp \fB\-\-cache \fP Cache the ibnetdiscover network data in the specified filename. This cache may be used by other tools for later analysis. .\" Define the common option load-cache . .sp \fB\-\-load\-cache \fP Load and use the cached ibnetdiscover data stored in the specified filename. May be useful for outputting and learning about other fabrics or a previous state of a fabric. .\" Define the common option diff . .sp \fB\-\-diff \fP Load cached ibnetdiscover data and do a diff comparison to the current network or another cache. A special diff output for ibnetdiscover output will be displayed showing differences between the old and current fabric. By default, the following are compared for differences: switches, channel adapters, routers, and port connections. .\" Define the common option diffcheck . .sp \fB\-\-diffcheck \fP Specify what diff checks should be done in the \fB\-\-diff\fP option above. Comma separate multiple diff check key(s). The available diff checks are: \fBsw = switches\fP, \fBca = channel adapters\fP, \fBrouter\fP = routers, \fBport\fP = port connections, \fBlid\fP = lids, \fBnodedesc\fP = node descriptions. Note that \fBport\fP, \fBlid\fP, and \fBnodedesc\fP are checked only for the node types that are specified (e.g. \fBsw\fP, \fBca\fP, \fBrouter\fP). If \fBport\fP is specified alongside \fBlid\fP or \fBnodedesc\fP, remote port lids and node descriptions will also be compared. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .\" Common text to describe the Topology file. . .SS TOPOLOGY FILE FORMAT .sp The topology file format is human readable and largely intuitive. Most identifiers are given textual names like vendor ID (vendid), device ID (device ID), GUIDs of various types (sysimgguid, caguid, switchguid, etc.). PortGUIDs are shown in parentheses (). For switches, this is shown on the switchguid line. For CA and router ports, it is shown on the connectivity lines. The IB node is identified followed by the number of ports and a quoted the node GUID. On the right of this line is a comment (#) followed by the NodeDescription in quotes. If the node is a switch, this line also contains whether switch port 0 is base or enhanced, and the LID and LMC of port 0. Subsequent lines pertaining to this node show the connectivity. On the left is the port number of the current node. On the right is the peer node (node at other end of link). It is identified in quotes with nodetype followed by \- followed by NodeGUID with the port number in square brackets. Further on the right is a comment (#). What follows the comment is dependent on the node type. If it it a switch node, it is followed by the NodeDescription in quotes and the LID of the peer node. If it is a CA or router node, it is followed by the local LID and LMC and then followed by the NodeDescription in quotes and the LID of the peer node. The active link width and speed are then appended to the end of this output line. .sp An example of this is: .sp .nf .ft C # # Topology file: generated on Tue Jun 5 14:15:10 2007 # # Max of 3 hops discovered # Initiated from node 0008f10403960558 port 0008f10403960559 Non\-Chassis Nodes vendid=0x8f1 devid=0x5a06 sysimgguid=0x5442ba00003000 switchguid=0x5442ba00003080(5442ba00003080) Switch 24 "S\-005442ba00003080" # "ISR9024 Voltaire" base port 0 lid 6 lmc 0 [22] "H\-0008f10403961354"[1](8f10403961355) # "MT23108 InfiniHost Mellanox Technologies" lid 4 4xSDR [10] "S\-0008f10400410015"[1] # "SW\-6IB4 Voltaire" lid 3 4xSDR [8] "H\-0008f10403960558"[2](8f1040396055a) # "MT23108 InfiniHost Mellanox Technologies" lid 14 4xSDR [6] "S\-0008f10400410015"[3] # "SW\-6IB4 Voltaire" lid 3 4xSDR [12] "H\-0008f10403960558"[1](8f10403960559) # "MT23108 InfiniHost Mellanox Technologies" lid 10 4xSDR vendid=0x8f1 devid=0x5a05 switchguid=0x8f10400410015(8f10400410015) Switch 8 "S\-0008f10400410015" # "SW\-6IB4 Voltaire" base port 0 lid 3 lmc 0 [6] "H\-0008f10403960984"[1](8f10403960985) # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR [4] "H\-005442b100004900"[1](5442b100004901) # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR [1] "S\-005442ba00003080"[10] # "ISR9024 Voltaire" lid 6 1xSDR [3] "S\-005442ba00003080"[6] # "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960984 Ca 2 "H\-0008f10403960984" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403960985) "S\-0008f10400410015"[6] # lid 16 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x5442b100004900 Ca 2 "H\-005442b100004900" # "MT23108 InfiniHost Mellanox Technologies" [1](5442b100004901) "S\-0008f10400410015"[4] # lid 12 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403961354 Ca 2 "H\-0008f10403961354" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403961355) "S\-005442ba00003080"[22] # lid 4 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960558 Ca 2 "H\-0008f10403960558" # "MT23108 InfiniHost Mellanox Technologies" [2](8f1040396055a) "S\-005442ba00003080"[8] # lid 14 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR [1](8f10403960559) "S\-005442ba00003080"[12] # lid 10 lmc 1 "ISR9024 Voltaire" lid 6 1xSDR .ft P .fi .sp When grouping is used, IB nodes are organized into chassis which are numbered. Nodes which cannot be determined to be in a chassis are displayed as "Non\-Chassis Nodes". External ports are also shown on the connectivity lines. .SH AUTHORS .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibportstate.8.in0000644013161601316160000001616612005566556016242 00000000000000.\" Man page generated from reStructeredText. . .TH IBPORTSTATE 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBPORTSTATE \- handle port (physical) state and link speed of an InfiniBand port . .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 .. .SH SYNOPSIS .sp ibportstate [options] [] .SH DESCRIPTION .sp ibportstate allows the port state and port physical state of an IB port to be queried (in addition to link width and speed being validated relative to the peer port when the port queried is a switch port), or a switch port to be disabled, enabled, or reset. It also allows the link speed/width enabled on any IB port to be adjusted. .SH OPTIONS .INDENT 0.0 .TP .B \fB\fP .INDENT 7.0 .TP .B Supported ops: enable, disable, reset, speed, espeed, fdr10, width, query, . down, arm, active, vls, mtu, lid, smlid, lmc, mkey, mkeylease, mkeyprot (Default is query) .UNINDENT .sp \fBenable, disable, and reset\fP are only allowed on switch ports (An error is indicated if attempted on CA or router ports) .sp \fBspeed and width\fP are allowed on any port .sp \fBspeed\fP values are the legal values for PortInfo:LinkSpeedEnabled (An error is indicated if PortInfo:LinkSpeedSupported does not support this setting) .sp \fBespeed\fP is allowed on any port supporting extended link speeds .sp \fBfdr10\fP is allowed on any port supporting fdr10 (An error is indicated if port\(aqs capability mask indicates extended link speeds are not supported or if PortInfo:LinkSpeedExtSupported does not support this setting) .sp \fBwidth\fP values are legal values for PortInfo:LinkWidthEnabled (An error is indicated if PortInfo:LinkWidthSupported does not support this setting) (NOTE: Speed and width changes are not effected until the port goes through link renegotiation) .sp \fBquery\fP also validates port characteristics (link width, speed, espeed, and fdr10) based on the peer port. This checking is done when the port queried is a switch port as it relies on combined routing (an initial LID route with directed routing to the peer) which can only be done on a switch. This peer port validation feature of query op requires LID routing to be functioning in the subnet. .sp \fBmkey, mkeylease, and mkeyprot\fP are only allowed on CAs, routers, or switch port 0 (An error is generated if attempted on external switch ports). Hexadecimal and octal mkeys may be specified by prepending the key with \(aq0x\(aq or \(aq0\(aq, respectively. If a non\-numeric value (like \(aqx\(aq) is specified for the mkey, then ibportstate will prompt for a value. .UNINDENT .SS Addressing Flags .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .SS Debugging flags .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -K . .INDENT 0.0 .TP .B \fB\-K, \-\-show_keys\fP .sp show security keys (mkey, smkey, etc.) associated with the request. .UNINDENT .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH EXAMPLES .INDENT 0.0 .TP .B :: . ibportstate 3 1 disable # by lid ibportstate \-G 0x2C9000100D051 1 enable # by guid ibportstate \-D 0 1 # (query) by direct route ibportstate 3 1 reset # by lid ibportstate 3 1 speed 1 # by lid ibportstate 3 1 width 1 # by lid ibportstate \-D 0 1 lid 0x1234 arm # by direct route .UNINDENT .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%hal.rosenstock@gmail.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/dump_mfts.8.in0000644013161601316160000001074012005566554015666 00000000000000.\" Man page generated from reStructeredText. . .TH DUMP_MFTS.SH 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME DUMP_MFTS.SH \- dump InfiniBand multicast forwarding tables . .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 .. .SH SYNOPSIS .sp dump_mfts.sh [\-h] [\-D] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] [>/path/to/file] .SH DESCRIPTION .sp dump_mfts.sh is a script which dumps the InfiniBand multicast forwarding tables (MFTs) in the switch nodes in the subnet. .SH OPTIONS .sp \fB\-D\fP dump forwarding tables using direct routed rather than LID routed SMPs .sp \fB\-h\fP show help .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp \fBdump_lfts(8), ibroute(8), ibswitches(8), opensm(8)\fP .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibtracert.80000644013161601316160000001477212005566564015254 00000000000000.\" Man page generated from reStructeredText. . .TH IBTRACERT 8 "" "" "Open IB Diagnostics" .SH NAME IBTRACERT \- . .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 .. .SH trace InfiniBand path .SS SYNOPSIS .sp ibtracert [options] [ [ []]] .SS DESCRIPTION .sp ibtracert uses SMPs to trace the path from a source GID/LID to a destination GID/LID. Each hop along the path is displayed until the destination is reached or a hop does not respond. By using the \-m option, multicast path tracing can be performed between source and destination nodes. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-n, \-\-no_info\fP .sp simple format; don\(aqt show additional information .TP .B \fB\-m\fP .sp show the multicast trace of the specified mlid .UNINDENT .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SS EXAMPLES .sp Unicast examples .INDENT 0.0 .TP .B :: . ibtracert 4 16 # show path between lids 4 and 16 ibtracert \-n 4 16 # same, but using simple output format ibtracert \-G 0x8f1040396522d 0x002c9000100d051 # use guid addresses .UNINDENT .sp Multicast example .INDENT 0.0 .TP .B :: . ibtracert \-m 0xc000 4 16 # show multicast path of mlid 0xc000 between lids 4 and 16 .UNINDENT .SS SEE ALSO .sp ibroute (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . <\fI\%hal.rosenstock@gmail.com\fP> .TP .B Ira Weiny . <\fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibqueryerrors.8.in0000644013161601316160000002130212005566557016604 00000000000000.\" Man page generated from reStructeredText. . .TH IBQUERYERRORS 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBQUERYERRORS \- query and report IB port counters . .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 .. .SH SYNOPSIS .sp ibqueryerrors [options] .SH DESCRIPTION .sp The default behavior is to report the port error counters which exceed a threshold for each port in the fabric. The default threshold is zero (0). Error fields can also be suppressed entirely. .sp In addition to reporting errors on every port. ibqueryerrors can report the port transmit and receive data as well as report full link information to the remote port if available. .SH OPTIONS .sp \fB\-s, \-\-suppress \fP Suppress the errors listed in the comma separated list provided. .sp \fB\-c, \-\-suppress\-common\fP Suppress some of the common "side effect" counters. These counters usually do not indicate an error condition and can be usually be safely ignored. .sp \fB\-r, \-\-report\-port\fP Report the port information. This includes LID, port, external port (if applicable), link speed setting, remote GUID, remote port, remote external port (if applicable), and remote node description information. .sp \fB\-\-data\fP Include the optional transmit and receive data counters. .sp \fB\-\-threshold\-file \fP Specify an alternate threshold file. The default is @IBDIAG_CONFIG_PATH@/error_thresholds .sp \fB\-\-switch\fP print data for switch\(aqs only .sp \fB\-\-ca\fP print data for CA\(aqs only .sp \fB\-\-router\fP print data for routers only .sp \fB\-\-clear\-errors \-k\fP Clear error counters after read. .sp \fB\-\-clear\-counts \-K\fP Clear data counters after read. .sp \fBCAUTION\fP clearing data or error counters will occur regardless of if they are printed or not. See \fB\-\-counters\fP and \fB\-\-data\fP for details on controling which counters are printed. .sp \fB\-\-details\fP include receive error and transmit discard details .sp \fB\-\-counters\fP print data counters only .SS Partial Scan flags .sp The node to start a partial scan can be specified with the following addresses. .\" Define the common option -G . .sp \fB\-\-port\-guid, \-G \fP Specify a port_guid .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct \fP The address specified is a directed route .sp .nf .ft C Examples: \-D "0" # self port \-D "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .sp \fBNote:\fP For switches results are printed for all ports not just switch port 0. .sp \fB\-S \fP same as "\-G". (provided only for backward compatibility) .SS Cache File flags .\" Define the common option load-cache . .sp \fB\-\-load\-cache \fP Load and use the cached ibnetdiscover data stored in the specified filename. May be useful for outputting and learning about other fabrics or a previous state of a fabric. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .sp \fB\-R\fP (This option is obsolete and does nothing) .SH EXIT STATUS .sp \fB\-1\fP if scan fails. .sp \fB0\fP if scan succeeds without errors beyond thresholds .sp \fB1\fP if errors are found beyond thresholds or inconsistencies are found in check mode. .SH FILES .SS ERROR THRESHOLD .sp @IBDIAG_CONFIG_PATH@/error_thresholds .sp Define threshold values for errors. File format is simple "name=val". Comments begin with \(aq#\(aq .sp \fBExample:\fP .sp .nf .ft C # Define thresholds for error counters SymbolErrorCounter=10 LinkErrorRecoveryCounter=10 VL15Dropped=100 .ft P .fi .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH AUTHOR .INDENT 0.0 .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/saquery.8.in0000644013161601316160000002226012005566561015357 00000000000000.\" Man page generated from reStructeredText. . .TH SAQUERY 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME SAQUERY \- . .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 .. .SH query InfiniBand subnet administration attributes .SS SYNOPSIS .sp saquery [options] [ | | ] .SS DESCRIPTION .sp saquery issues the selected SA query. Node records are queried by default. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-p\fP .sp get PathRecord info .TP .B \fB\-N\fP .sp get NodeRecord info .TP .B \fB\-D, \-\-list\fP .sp get NodeDescriptions of CAs only .TP .B \fB\-S\fP .sp get ServiceRecord info .TP .B \fB\-I\fP .sp get InformInfoRecord (subscription) info .TP .B \fB\-L\fP .sp return the Lids of the name specified .TP .B \fB\-l\fP .sp return the unique Lid of the name specified .TP .B \fB\-G\fP .sp return the Guids of the name specified .TP .B \fB\-O\fP .sp return the name for the Lid specified .TP .B \fB\-U\fP .sp return the name for the Guid specified .TP .B \fB\-c\fP .sp get the SA\(aqs class port info .TP .B \fB\-s\fP .sp return the PortInfoRecords with isSM or isSMdisabled capability mask bit on .TP .B \fB\-g\fP .sp get multicast group info .TP .B \fB\-m\fP .sp get multicast member info. If a group is specified, limit the output to the group specified and print one line containing only the GUID and node description for each entry. Example: saquery \-m 0xc000 .TP .B \fB\-x\fP .sp get LinkRecord info .TP .B \fB\-\-src\-to\-dst \fP .sp get a PathRecord for where src and dst are either node names or LIDs .TP .B \fB\-\-sgid\-to\-dgid \fP .sp get a PathRecord for \fBsgid\fP to \fBdgid\fP where both GIDs are in an IPv6 format acceptable to \fBinet_pton (3)\fP .TP .B \fB\-\-smkey \fP .sp use SM_Key value for the query. Will be used only with "trusted" queries. If non\-numeric value (like \(aqx\(aq) is specified then saquery will prompt for a value. Default (when not specified here or in @IBDIAG_CONFIG_PATH@/ibdiag.conf) is to use SM_Key == 0 (or "untrusted") .UNINDENT .\" Define the common option -K . .INDENT 0.0 .TP .B \fB\-K, \-\-show_keys\fP .sp show security keys (mkey, smkey, etc.) associated with the request. .UNINDENT .sp \fB\-\-slid \fP Source LID (PathRecord) .sp \fB\-\-dlid \fP Destination LID (PathRecord) .sp \fB\-\-mlid \fP Multicast LID (MCMemberRecord) .sp \fB\-\-sgid \fP Source GID (IPv6 format) (PathRecord) .sp \fB\-\-dgid \fP Destination GID (IPv6 format) (PathRecord) .sp \fB\-\-gid \fP Port GID (MCMemberRecord) .sp \fB\-\-mgid \fP Multicast GID (MCMemberRecord) .sp \fB\-\-reversible\fP Reversible path (PathRecord) .sp \fB\-\-numb_path\fP Number of paths (PathRecord) .INDENT 0.0 .TP .B \fB\-\-pkey\fP P_Key (PathRecord, MCMemberRecord). If non\-numeric value (like \(aqx\(aq) .sp is specified then saquery will prompt for a value .UNINDENT .sp \fB\-\-qos_class\fP QoS Class (PathRecord) .sp \fB\-\-sl\fP Service level (PathRecord, MCMemberRecord) .sp \fB\-\-mtu\fP MTU and selector (PathRecord, MCMemberRecord) .sp \fB\-\-rate\fP Rate and selector (PathRecord, MCMemberRecord) .sp \fB\-\-pkt_lifetime\fP Packet lifetime and selector (PathRecord, MCMemberRecord) .INDENT 0.0 .TP .B \fB\-\-qkey\fP Q_Key (MCMemberRecord). If non\-numeric value (like \(aqx\(aq) is specified .sp then saquery will prompt for a value .UNINDENT .sp \fB\-\-tclass\fP Traffic Class (PathRecord, MCMemberRecord) .sp \fB\-\-flow_label\fP Flow Label (PathRecord, MCMemberRecord) .sp \fB\-\-hop_limit\fP Hop limit (PathRecord, MCMemberRecord) .sp \fB\-\-scope\fP Scope (MCMemberRecord) .sp \fB\-\-join_state\fP Join state (MCMemberRecord) .sp \fB\-\-proxy_join\fP Proxy join (MCMemberRecord) .sp Supported query names (and aliases): .INDENT 0.0 .TP .B :: . ClassPortInfo (CPI) NodeRecord (NR) [lid] PortInfoRecord (PIR) [[lid]/[port]/[options]] SL2VLTableRecord (SL2VL) [[lid]/[in_port]/[out_port]] PKeyTableRecord (PKTR) [[lid]/[port]/[block]] VLArbitrationTableRecord (VLAR) [[lid]/[port]/[block]] InformInfoRecord (IIR) LinkRecord (LR) [[from_lid]/[from_port]] [[to_lid]/[to_port]] ServiceRecord (SR) PathRecord (PR) MCMemberRecord (MCMR) LFTRecord (LFTR) [[lid]/[block]] MFTRecord (MFTR) [[mlid]/[position]/[block]] GUIDInfoRecord (GIR) [[lid]/[block]] .UNINDENT .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS COMMON FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SS DEPENDENCIES .sp OpenSM (or other running SM/SA), libosmcomp, libibumad, libibmad .SS AUTHORS .INDENT 0.0 .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibhosts.8.in0000644013161601316160000001054612005566555015350 00000000000000.\" Man page generated from reStructeredText. . .TH IBHOSTS 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBHOSTS \- show InfiniBand host nodes in topology . .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 .. .SH SYNOPSIS .sp ibhosts [options] [] .SH DESCRIPTION .sp ibhosts is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the CA nodes. .SH OPTIONS .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp ibnetdiscover(8) .SH DEPENDENCIES .sp ibnetdiscover, ibnetdiscover format .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibhosts.80000644013161601316160000001056012005566563014736 00000000000000.\" Man page generated from reStructeredText. . .TH IBHOSTS 8 "" "" "OpenIB Diagnostics" .SH NAME IBHOSTS \- show InfiniBand host nodes in topology . .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 .. .SH SYNOPSIS .sp ibhosts [options] [] .SH DESCRIPTION .sp ibhosts is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the CA nodes. .SH OPTIONS .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp ibnetdiscover(8) .SH DEPENDENCIES .sp ibnetdiscover, ibnetdiscover format .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibstatus.8.in0000644013161601316160000000320212005566557015524 00000000000000.\" Man page generated from reStructeredText. . .TH IBSTATUS 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBSTATUS \- . .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 .. .SH query basic status of InfiniBand device(s) .SS SYNOPSIS .sp ibstatus [\-h] [devname[:port]]... .SS DESCRIPTION .sp ibstatus is a script which displays basic information obtained from the local IB driver. Output includes LID, SMLID, port state, link width active, and port physical state. .SS OPTIONS .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .INDENT 0.0 .TP .B \fBdevname\fP .sp InfiniBand device name .TP .B \fBportnum\fP .sp port number of InfiniBand device .UNINDENT .SS EXAMPLES .INDENT 0.0 .TP .B :: . ibstatus # display status of all IB ports ibstatus mthca1 # status of mthca1 ports ibstatus mthca1:1 mthca0:2 # show status of specified ports .UNINDENT .SS SEE ALSO .sp \fBibstat (8)\fP .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibqueryerrors.80000644013161601316160000002134212005566563016200 00000000000000.\" Man page generated from reStructeredText. . .TH IBQUERYERRORS 8 "" "" "OpenIB Diagnostics" .SH NAME IBQUERYERRORS \- query and report IB port counters . .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 .. .SH SYNOPSIS .sp ibqueryerrors [options] .SH DESCRIPTION .sp The default behavior is to report the port error counters which exceed a threshold for each port in the fabric. The default threshold is zero (0). Error fields can also be suppressed entirely. .sp In addition to reporting errors on every port. ibqueryerrors can report the port transmit and receive data as well as report full link information to the remote port if available. .SH OPTIONS .sp \fB\-s, \-\-suppress \fP Suppress the errors listed in the comma separated list provided. .sp \fB\-c, \-\-suppress\-common\fP Suppress some of the common "side effect" counters. These counters usually do not indicate an error condition and can be usually be safely ignored. .sp \fB\-r, \-\-report\-port\fP Report the port information. This includes LID, port, external port (if applicable), link speed setting, remote GUID, remote port, remote external port (if applicable), and remote node description information. .sp \fB\-\-data\fP Include the optional transmit and receive data counters. .sp \fB\-\-threshold\-file \fP Specify an alternate threshold file. The default is /usr/local/etc/infiniband-diags/error_thresholds .sp \fB\-\-switch\fP print data for switch\(aqs only .sp \fB\-\-ca\fP print data for CA\(aqs only .sp \fB\-\-router\fP print data for routers only .sp \fB\-\-clear\-errors \-k\fP Clear error counters after read. .sp \fB\-\-clear\-counts \-K\fP Clear data counters after read. .sp \fBCAUTION\fP clearing data or error counters will occur regardless of if they are printed or not. See \fB\-\-counters\fP and \fB\-\-data\fP for details on controling which counters are printed. .sp \fB\-\-details\fP include receive error and transmit discard details .sp \fB\-\-counters\fP print data counters only .SS Partial Scan flags .sp The node to start a partial scan can be specified with the following addresses. .\" Define the common option -G . .sp \fB\-\-port\-guid, \-G \fP Specify a port_guid .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct \fP The address specified is a directed route .sp .nf .ft C Examples: \-D "0" # self port \-D "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .sp \fBNote:\fP For switches results are printed for all ports not just switch port 0. .sp \fB\-S \fP same as "\-G". (provided only for backward compatibility) .SS Cache File flags .\" Define the common option load-cache . .sp \fB\-\-load\-cache \fP Load and use the cached ibnetdiscover data stored in the specified filename. May be useful for outputting and learning about other fabrics or a previous state of a fabric. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .sp \fB\-R\fP (This option is obsolete and does nothing) .SH EXIT STATUS .sp \fB\-1\fP if scan fails. .sp \fB0\fP if scan succeeds without errors beyond thresholds .sp \fB1\fP if errors are found beyond thresholds or inconsistencies are found in check mode. .SH FILES .SS ERROR THRESHOLD .sp /usr/local/etc/infiniband-diags/error_thresholds .sp Define threshold values for errors. File format is simple "name=val". Comments begin with \(aq#\(aq .sp \fBExample:\fP .sp .nf .ft C # Define thresholds for error counters SymbolErrorCounter=10 LinkErrorRecoveryCounter=10 VL15Dropped=100 .ft P .fi .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH AUTHOR .INDENT 0.0 .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibccconfig.8.in0000644013161601316160000001252612005566554015762 00000000000000.\" Man page generated from reStructeredText. . .TH IBCCCONFIG 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBCCCONFIG \- configure congestion control settings . .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 .. .SH SYNOPSIS .sp ibccconfig [common_options] [\-c cckey] [port] .SH DESCRIPTION .sp \fBibccconfig\fP supports the configuration of congestion control settings on switches and HCAs. .sp \fBWARNING \-\- You should understand what you are doing before using this tool. Misuse of this tool could result in a broken fabric.\fP .SH OPTIONS .INDENT 0.0 .TP .B Current supported operations and their parameters: . CongestionKeyInfo (CK) SwitchCongestionSetting (SS) SwitchPortCongestionSetting (SP) CACongestionSetting (CS) CongestionControlTable (CT) ... .UNINDENT .sp \fB\-\-cckey, \-c, \fP Specify a congestion control (CC) key. If none is specified, a key of 0 is used. .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SH EXAMPLES .sp .nf .ft C ibccconfig SwitchCongestionSetting 2 0x1F 0x1FFFFFFFFF 0x0 0xF 8 0 0:0 1 # Configure Switch Congestion Settings ibccconfig CACongestionSetting 1 0 0x3 150 1 0 0 # Configure CA Congestion Settings to SL 0 and SL 1 ibccconfig CACongestionSetting 1 0 0x4 200 1 0 0 # Configure CA Congestion Settings to SL 2 ibccconfig CongestionControlTable 1 63 0 0:0 0:1 ... # Configure first block of Congestion Control Table ibccconfig CongestionControlTable 1 127 0 0:64 0:65 ... # Configure second block of Congestion Control Table .ft P .fi .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH AUTHOR .INDENT 0.0 .TP .B Albert Chu . < \fI\%chu11@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibccquery.8.in0000644013161601316160000001102212005566555015651 00000000000000.\" Man page generated from reStructeredText. . .TH IBCCQUERY 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBCCQUERY \- query congestion control settings/info . .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 .. .SH SYNOPSIS .sp ibccquery [common_options] [\-c cckey] [port] .SH DESCRIPTION .sp ibccquery support the querying of settings and other information related to congestion control. .SH OPTIONS .INDENT 0.0 .TP .B Current supported operations and their parameters: . CongestionInfo (CI) CongestionKeyInfo (CK) CongestionLog (CL) SwitchCongestionSetting (SS) SwitchPortCongestionSetting (SP) [] CACongestionSetting (CS) CongestionControlTable (CT) Timestamp (TI) .UNINDENT .sp \fB\-\-cckey, \-c \fP Specify a congestion control (CC) key. If none is specified, a key of 0 is used. .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH EXAMPLES .sp .nf .ft C ibccquery CongestionInfo 3 # Congestion Info by lid ibccquery SwitchPortCongestionSetting 3 # Query all Switch Port Congestion Settings ibccquery SwitchPortCongestionSetting 3 1 # Query Switch Port Congestion Setting for port 1 .ft P .fi .SH AUTHOR .INDENT 0.0 .TP .B Albert Chu . < \fI\%chu11@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/saquery.80000644013161601316160000002230512005566564014755 00000000000000.\" Man page generated from reStructeredText. . .TH SAQUERY 8 "" "" "Open IB Diagnostics" .SH NAME SAQUERY \- . .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 .. .SH query InfiniBand subnet administration attributes .SS SYNOPSIS .sp saquery [options] [ | | ] .SS DESCRIPTION .sp saquery issues the selected SA query. Node records are queried by default. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-p\fP .sp get PathRecord info .TP .B \fB\-N\fP .sp get NodeRecord info .TP .B \fB\-D, \-\-list\fP .sp get NodeDescriptions of CAs only .TP .B \fB\-S\fP .sp get ServiceRecord info .TP .B \fB\-I\fP .sp get InformInfoRecord (subscription) info .TP .B \fB\-L\fP .sp return the Lids of the name specified .TP .B \fB\-l\fP .sp return the unique Lid of the name specified .TP .B \fB\-G\fP .sp return the Guids of the name specified .TP .B \fB\-O\fP .sp return the name for the Lid specified .TP .B \fB\-U\fP .sp return the name for the Guid specified .TP .B \fB\-c\fP .sp get the SA\(aqs class port info .TP .B \fB\-s\fP .sp return the PortInfoRecords with isSM or isSMdisabled capability mask bit on .TP .B \fB\-g\fP .sp get multicast group info .TP .B \fB\-m\fP .sp get multicast member info. If a group is specified, limit the output to the group specified and print one line containing only the GUID and node description for each entry. Example: saquery \-m 0xc000 .TP .B \fB\-x\fP .sp get LinkRecord info .TP .B \fB\-\-src\-to\-dst \fP .sp get a PathRecord for where src and dst are either node names or LIDs .TP .B \fB\-\-sgid\-to\-dgid \fP .sp get a PathRecord for \fBsgid\fP to \fBdgid\fP where both GIDs are in an IPv6 format acceptable to \fBinet_pton (3)\fP .TP .B \fB\-\-smkey \fP .sp use SM_Key value for the query. Will be used only with "trusted" queries. If non\-numeric value (like \(aqx\(aq) is specified then saquery will prompt for a value. Default (when not specified here or in /usr/local/etc/infiniband-diags/ibdiag.conf) is to use SM_Key == 0 (or "untrusted") .UNINDENT .\" Define the common option -K . .INDENT 0.0 .TP .B \fB\-K, \-\-show_keys\fP .sp show security keys (mkey, smkey, etc.) associated with the request. .UNINDENT .sp \fB\-\-slid \fP Source LID (PathRecord) .sp \fB\-\-dlid \fP Destination LID (PathRecord) .sp \fB\-\-mlid \fP Multicast LID (MCMemberRecord) .sp \fB\-\-sgid \fP Source GID (IPv6 format) (PathRecord) .sp \fB\-\-dgid \fP Destination GID (IPv6 format) (PathRecord) .sp \fB\-\-gid \fP Port GID (MCMemberRecord) .sp \fB\-\-mgid \fP Multicast GID (MCMemberRecord) .sp \fB\-\-reversible\fP Reversible path (PathRecord) .sp \fB\-\-numb_path\fP Number of paths (PathRecord) .INDENT 0.0 .TP .B \fB\-\-pkey\fP P_Key (PathRecord, MCMemberRecord). If non\-numeric value (like \(aqx\(aq) .sp is specified then saquery will prompt for a value .UNINDENT .sp \fB\-\-qos_class\fP QoS Class (PathRecord) .sp \fB\-\-sl\fP Service level (PathRecord, MCMemberRecord) .sp \fB\-\-mtu\fP MTU and selector (PathRecord, MCMemberRecord) .sp \fB\-\-rate\fP Rate and selector (PathRecord, MCMemberRecord) .sp \fB\-\-pkt_lifetime\fP Packet lifetime and selector (PathRecord, MCMemberRecord) .INDENT 0.0 .TP .B \fB\-\-qkey\fP Q_Key (MCMemberRecord). If non\-numeric value (like \(aqx\(aq) is specified .sp then saquery will prompt for a value .UNINDENT .sp \fB\-\-tclass\fP Traffic Class (PathRecord, MCMemberRecord) .sp \fB\-\-flow_label\fP Flow Label (PathRecord, MCMemberRecord) .sp \fB\-\-hop_limit\fP Hop limit (PathRecord, MCMemberRecord) .sp \fB\-\-scope\fP Scope (MCMemberRecord) .sp \fB\-\-join_state\fP Join state (MCMemberRecord) .sp \fB\-\-proxy_join\fP Proxy join (MCMemberRecord) .sp Supported query names (and aliases): .INDENT 0.0 .TP .B :: . ClassPortInfo (CPI) NodeRecord (NR) [lid] PortInfoRecord (PIR) [[lid]/[port]/[options]] SL2VLTableRecord (SL2VL) [[lid]/[in_port]/[out_port]] PKeyTableRecord (PKTR) [[lid]/[port]/[block]] VLArbitrationTableRecord (VLAR) [[lid]/[port]/[block]] InformInfoRecord (IIR) LinkRecord (LR) [[from_lid]/[from_port]] [[to_lid]/[to_port]] ServiceRecord (SR) PathRecord (PR) MCMemberRecord (MCMR) LFTRecord (LFTR) [[lid]/[block]] MFTRecord (MFTR) [[mlid]/[position]/[block]] GUIDInfoRecord (GIR) [[lid]/[block]] .UNINDENT .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS COMMON FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SS DEPENDENCIES .sp OpenSM (or other running SM/SA), libosmcomp, libibumad, libibmad .SS AUTHORS .INDENT 0.0 .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/smpquery.8.in0000644013161601316160000001640212005566562015555 00000000000000.\" Man page generated from reStructeredText. . .TH SMPQUERY 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME SMPQUERY \- . .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 .. .SH query InfiniBand subnet management attributes .SS SYNOPSIS .sp smpquery [options] [op params] .SS DESCRIPTION .sp smpquery allows a basic subset of standard SMP queries including the following: node info, node description, switch info, port info. Fields are displayed in human readable format. .SS OPTIONS .sp Current supported operations and their parameters: .INDENT 0.0 .TP .B :: . nodeinfo nodedesc portinfo [] # default port is zero switchinfo pkeys [] sl2vl [] vlarb [] guids mlnxextportinfo [] # default port is zero .TP .B \fB\-c, \-\-combined\fP .sp Use Combined route address argument \fC \fP .TP .B \fB\-x, \-\-extended\fP .sp Set SMSupportsExtendedSpeeds bit 31 in AttributeModifier (only impacts PortInfo queries). .UNINDENT .\" Define the common option -K . .INDENT 0.0 .TP .B \fB\-K, \-\-show_keys\fP .sp show security keys (mkey, smkey, etc.) associated with the request. .UNINDENT .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SS EXAMPLES .INDENT 0.0 .TP .B :: . smpquery portinfo 3 1 # portinfo by lid, with port modifier smpquery \-G switchinfo 0x2C9000100D051 1 # switchinfo by guid smpquery \-D nodeinfo 0 # nodeinfo by direct route smpquery \-c nodeinfo 6 0,12 # nodeinfo by combined route .UNINDENT .SS SEE ALSO .sp smpdump (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%hal@mellanox.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibidsverify.8.in0000644013161601316160000000415312005566555016211 00000000000000.\" Man page generated from reStructeredText. . .TH IBIDSVERIFY 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBIDSVERIFY \- . .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 .. .SH validate IB identifiers in subnet and report errors .SS SYNOPSIS .sp ibidsverify.pl [\-h] [\-R] .SS DESCRIPTION .sp ibidsverify.pl is a perl script which uses a full topology file that was created by ibnetdiscover, scans the network to validate the LIDs and GUIDs in the subnet. The validation consists of checking that there are no zero or duplicate identifiers. .sp Finally, ibidsverify.pl will also reuse the cached ibnetdiscover output from some of the other diag tools which makes it a bit faster than running ibnetdiscover from scratch. .SS OPTIONS .sp \fB\-R\fP Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe the fabric has changed. .sp \fB\-C \fP use the specified ca_name. .sp \fB\-P \fP use the specified ca_port. .SS EXIT STATUS .sp Exit status is 1 if errors are found, 0 otherwise. .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS SEE ALSO .sp \fBibnetdiscover(8)\fP .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibrouters.8.in0000644013161601316160000001056412005566557015715 00000000000000.\" Man page generated from reStructeredText. . .TH IBROUTERS 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBROUTERS \- show InfiniBand router nodes in topology . .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 .. .SH SYNOPSIS .sp ibrouters [options] [] .SH DESCRIPTION .sp ibrouters is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the router nodes. .SH OPTIONS .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp ibnetdiscover(8) .SH DEPENDENCIES .sp ibnetdiscover, ibnetdiscover format .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibping.80000644013161601316160000001013112005566563014525 00000000000000.\" Man page generated from reStructeredText. . .TH IBPING 8 "" "" "Open IB Diagnostics" .SH NAME IBPING \- ping an InfiniBand address . .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 .. .SH SYNOPSIS .sp ibping [options] .SH DESCRIPTION .sp ibping uses vendor mads to validate connectivity between IB nodes. On exit, (IP) ping like output is show. ibping is run as client/server. Default is to run as client. Note also that a default ping server is implemented within the kernel. .SH OPTIONS .sp \fB\-c, \-\-count\fP stop after count packets .sp \fB\-f, \-\-flood\fP flood destination: send packets back to back without delay .sp \fB\-o, \-\-oui\fP use specified OUI number to multiplex vendor mads .sp \fB\-S, \-\-Server\fP start in server mode (do not return) .SS Addressing Flags .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .SS Debugging flags .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibrouters.80000644013161601316160000001057612005566563015310 00000000000000.\" Man page generated from reStructeredText. . .TH IBROUTERS 8 "" "" "OpenIB Diagnostics" .SH NAME IBROUTERS \- show InfiniBand router nodes in topology . .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 .. .SH SYNOPSIS .sp ibrouters [options] [] .SH DESCRIPTION .sp ibrouters is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the router nodes. .SH OPTIONS .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp ibnetdiscover(8) .SH DEPENDENCIES .sp ibnetdiscover, ibnetdiscover format .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/iblinkinfo.8.in0000644013161601316160000002203712005566555016017 00000000000000.\" Man page generated from reStructeredText. . .TH IBLINKINFO 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBLINKINFO \- report link info for all links in the fabric . .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 .. .SH SYNOPSIS .sp iblinkinfo .SH DESCRIPTION .sp iblinkinfo reports link info for each port in an IB fabric, node by node. Optionally, iblinkinfo can do partial scans and limit its output to parts of a fabric. .SH OPTIONS .sp \fB\-\-down, \-d\fP Print only nodes which have a port in the "Down" state. .sp \fB\-\-line, \-l\fP Print all information for each link on one line. Default is to print a header with the node information and then a list for each port (useful for grep\(aqing output). .sp \fB\-\-additional, \-p\fP Print additional port settings (,,) .sp \fB\-\-switches\-only\fP Show only switches in output. .sp \fB\-\-cas\-only\fP Show only CAs in output. .SS Partial Scan flags .sp The node to start a partial scan can be specified with the following addresses. .\" Define the common option -G . .sp \fB\-\-port\-guid, \-G \fP Specify a port_guid .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct \fP The address specified is a directed route .sp .nf .ft C Examples: \-D "0" # self port \-D "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .sp \fBNote:\fP For switches results are printed for all ports not just switch port 0. .sp \fB\-\-switch, \-S \fP same as "\-G". (provided only for backward compatibility) .sp How much of the scan to be printed can be controled with the following. .sp \fB\-\-all, \-a\fP Print all nodes found in a partial fabric scan. Normally a partial fabric scan will return only the node specified. This option will print the other nodes found as well. .sp \fB\-\-hops, \-n \fP Specify the number of hops away from a specified node to scan. This is useful to expand a partial fabric scan beyond the node specified. .SS Cache File flags .\" Define the common option load-cache . .sp \fB\-\-load\-cache \fP Load and use the cached ibnetdiscover data stored in the specified filename. May be useful for outputting and learning about other fabrics or a previous state of a fabric. .\" Define the common option diff . .sp \fB\-\-diff \fP Load cached ibnetdiscover data and do a diff comparison to the current network or another cache. A special diff output for ibnetdiscover output will be displayed showing differences between the old and current fabric. By default, the following are compared for differences: switches, channel adapters, routers, and port connections. .\" Define the common option diffcheck . .sp \fB\-\-diffcheck \fP Specify what diff checks should be done in the \fB\-\-diff\fP option above. Comma separate multiple diff check key(s). The available diff checks are: \fBsw = switches\fP, \fBca = channel adapters\fP, \fBrouter\fP = routers, \fBport\fP = port connections, \fBlid\fP = lids, \fBnodedesc\fP = node descriptions. Note that \fBport\fP, \fBlid\fP, and \fBnodedesc\fP are checked only for the node types that are specified (e.g. \fBsw\fP, \fBca\fP, \fBrouter\fP). If \fBport\fP is specified alongside \fBlid\fP or \fBnodedesc\fP, remote port lids and node descriptions will also be compared. .sp \fB\-\-filterdownports \fP Filter downports indicated in a ibnetdiscover cache. If a port was previously indicated as down in the specified cache, and is still down, do not output it in the resulting output. This option may be particularly useful for environments where switches are not fully populated, thus much of the default iblinkinfo info is considered unuseful. See \fBibnetdiscover\fP for information on caching ibnetdiscover output. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .SS Debugging flags .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .sp \fB\-R\fP (This option is obsolete and does nothing) .SH EXIT STATUS .sp 0 on success, \-1 on failure to scan the fabric, 1 if check mode is used and inconsistencies are found. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH AUTHOR .INDENT 0.0 .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/perfquery.8.in0000644013161601316160000001757212005566561015722 00000000000000.\" Man page generated from reStructeredText. . .TH PERFQUERY 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME PERFQUERY \- . .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 .. .SH query InfiniBand port counters on a single port .SS SYNOPSIS .sp perfquery [options] [ [[port] [reset_mask]]] .SS DESCRIPTION .sp perfquery uses PerfMgt GMPs to obtain the PortCounters (basic performance and error counters), PortExtendedCounters, PortXmitDataSL, PortRcvDataSL, PortRcvErrorDetails, PortXmitDiscardDetails, PortExtendedSpeedsCounters, or PortSamplesControl from the PMA at the node/port specified. Optionally shows aggregated counters for all ports of node. Finally it can, reset after read, or just reset the counters. .sp Note: In PortCounters, PortCountersExtended, PortXmitDataSL, and PortRcvDataSL, components that represent Data (e.g. PortXmitData and PortRcvData) indicate octets divided by 4 rather than just octets. .sp Note: Inputting a port of 255 indicates an operation be performed on all ports. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-x, \-\-extended\fP .sp show extended port counters rather than (basic) port counters. Note that extended port counters attribute is optional. .TP .B \fB\-X, \-\-xmtsl\fP .sp show transmit data SL counter. This is an optional counter for QoS. .TP .B \fB\-S, \-\-rcvsl\fP .sp show receive data SL counter. This is an optional counter for QoS. .TP .B \fB\-D, \-\-xmtdisc\fP .sp show transmit discard details. This is an optional counter. .TP .B \fB\-E, \-\-rcverr\fP .sp show receive error details. This is an optional counter. .TP .B \fB\-D, \-\-xmtdisc\fP .sp show transmit discard details. This is an optional counter. .TP .B \fB\-T, \-\-extended_speeds\fP .sp show extended speeds port counters. This is an optional counter. .TP .B \fB\-\-oprcvcounters\fP .sp show Rcv Counters per Op code. This is an optional counter. .TP .B \fB\-\-flowctlcounters\fP .sp show flow control counters. This is an optional counter. .TP .B \fB\-\-vloppackets\fP .sp show packets received per Op code per VL. This is an optional counter. .TP .B \fB\-\-vlopdata\fP .sp show data received per Op code per VL. This is an optional counter. .TP .B \fB\-\-vlxmitflowctlerrors\fP .sp show flow control update errors per VL. This is an optional counter. .TP .B \fB\-\-vlxmitcounters\fP .sp show ticks waiting to transmit counters per VL. This is an optional counter. .TP .B \fB\-\-swportvlcong\fP .sp show sw port VL congestion. This is an optional counter. .TP .B \fB\-\-rcvcc\fP .sp show Rcv congestion control counters. This is an optional counter. .TP .B \fB\-\-slrcvfecn\fP .sp show SL Rcv FECN counters. This is an optional counter. .TP .B \fB\-\-slrcvbecn\fP .sp show SL Rcv BECN counters. This is an optional counter. .TP .B \fB\-\-xmitcc\fP .sp show Xmit congestion control counters. This is an optional counter. .TP .B \fB\-\-vlxmittimecc\fP .sp show VL Xmit Time congestion control counters. This is an optional counter. .TP .B \fB\-c, \-\-smplctl\fP .sp show port samples control. .TP .B \fB\-a, \-\-all_ports\fP .sp show aggregated counters for all ports of the destination lid or reset all counters for all ports. If the destination lid does not support the AllPortSelect flag, all ports will be iterated through to emulate AllPortSelect behavior. .TP .B \fB\-l, \-\-loop_ports\fP .sp If all ports are selected by the user (either through the \fB\-a\fP option or port 255) iterate through each port rather than doing than aggregate operation. .TP .B \fB\-r, \-\-reset_after_read\fP .sp reset counters after read .TP .B \fB\-R, \-\-Reset_only\fP .sp only reset counters .UNINDENT .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .INDENT 0.0 .TP .B :: . perfquery # read local port performance counters perfquery 32 1 # read performance counters from lid 32, port 1 perfquery \-x 32 1 # read extended performance counters from lid 32, port 1 perfquery \-a 32 # read perf counters from lid 32, all ports perfquery \-r 32 1 # read performance counters and reset perfquery \-x \-r 32 1 # read extended performance counters and reset perfquery \-R 0x20 1 # reset performance counters of port 1 only perfquery \-x \-R 0x20 1 # reset extended performance counters of port 1 only perfquery \-R \-a 32 # reset performance counters of all ports perfquery \-R 32 2 0x0fff # reset only error counters of port 2 perfquery \-R 32 2 0xf000 # reset only non\-error counters of port 2 .UNINDENT .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%hal.rosenstock@gmail.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/vendstat.8.in0000644013161601316160000001211312005566562015513 00000000000000.\" Man page generated from reStructeredText. . .TH VENDSTAT 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME VENDSTAT \- . .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 .. .SH query InfiniBand vendor specific functions .SS SYNOPSIS .sp vendstat [options] .SS DESCRIPTION .sp vendstat uses vendor specific MADs to access beyond the IB spec vendor specific functionality. Currently, there is support for Mellanox InfiniSwitch\-III (IS3) and InfiniSwitch\-IV (IS4). .SS OPTIONS .INDENT 0.0 .TP .B \fB\-N\fP .sp show IS3 or IS4 general information. .TP .B \fB\-w\fP .sp show IS3 port xmit wait counters. .TP .B \fB\-i\fP .sp show IS4 counter group info. .TP .B \fB\-c \fP .sp configure IS4 counter groups. .sp Configure IS4 counter groups 0 and 1. Such configuration is not persistent across IS4 reboot. First number is for counter group 0 and second is for counter group 1. .sp Group 0 counter config values: .UNINDENT .INDENT 0.0 .TP .B :: .INDENT 7.0 .INDENT 3.5 .sp 0 \- PortXmitDataSL0\-7 1 \- PortXmitDataSL8\-15 2 \- PortRcvDataSL0\-7 .UNINDENT .UNINDENT .sp Group 1 counter config values: .UNINDENT .INDENT 0.0 .TP .B :: . 1 \- PortXmitDataSL8\-15 2 \- PortRcvDataSL0\-7 8 \- PortRcvDataSL8\-15 .TP .B \fB\-R, \-\-Read \fP .sp Read configuration space record at addr .TP .B \fB\-W, \-\-Write \fP .sp Write configuration space record at addr .UNINDENT .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .INDENT 0.0 .TP .B :: . vendstat \-N 6 # read IS3 or IS4 general information vendstat \-w 6 # read IS3 port xmit wait counters vendstat \-i 6 12 # read IS4 port 12 counter group info vendstat \-c 0,1 6 12 # configure IS4 port 12 counter groups for PortXmitDataSL vendstat \-c 2,8 6 12 # configure IS4 port 12 counter groups for PortRcvDataSL .UNINDENT .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%hal.rosenstock@gmail.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibroute.8.in0000644013161601316160000001324112005566557015343 00000000000000.\" Man page generated from reStructeredText. . .TH IBROUTE 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBROUTE \- . .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 .. .SH query InfiniBand switch forwarding tables .SS SYNOPSIS .sp ibroute [options] [ [ []]] .SS DESCRIPTION .sp ibroute uses SMPs to display the forwarding tables (unicast (LinearForwardingTable or LFT) or multicast (MulticastForwardingTable or MFT)) for the specified switch LID and the optional lid (mlid) range. The default range is all valid entries in the range 1...FDBTop. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-a, \-\-all\fP .sp show all lids in range, even invalid entries .TP .B \fB\-n, \-\-no_dests\fP .sp do not try to resolve destinations .TP .B \fB\-M, \-\-Multicast\fP .sp show multicast forwarding tables In this case, the range parameters are specifying the mlid range. .UNINDENT .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .sp Unicast examples .INDENT 0.0 .TP .B :: . ibroute 4 # dump all lids with valid out ports of switch with lid 4 ibroute \-a 4 # same, but dump all lids, even with invalid out ports ibroute \-n 4 # simple dump format \- no destination resolution ibroute 4 10 # dump lids starting from 10 (up to FDBTop) ibroute 4 0x10 0x20 # dump lid range ibroute \-G 0x08f1040023 # resolve switch by GUID ibroute \-D 0,1 # resolve switch by direct path .UNINDENT .sp Multicast examples .INDENT 0.0 .TP .B :: . ibroute \-M 4 # dump all non empty mlids of switch with lid 4 ibroute \-M 4 0xc010 0xc020 # same, but with range ibroute \-M \-n 4 # simple dump format .UNINDENT .SS SEE ALSO .sp ibtracert (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibnodes.80000644013161601316160000001057612005566563014715 00000000000000.\" Man page generated from reStructeredText. . .TH IBNODES 8 "" "" "OpenIB Diagnostics" .SH NAME IBNODES \- show InfiniBand nodes in topology . .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 .. .SH SYNOPSIS .sp ibnodes [options] [] .SH DESCRIPTION .sp ibnodes is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the IB nodes (CAs and switches). .SH OPTIONS .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SH SEE ALSO .sp ibnetdiscover(8) .SH DEPENDENCIES .sp ibnetdiscover, ibnetdiscover format .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibaddr.80000644013161601316160000001146412005566563014514 00000000000000.\" Man page generated from reStructeredText. . .TH IBADDR 8 "" "" "OpenIB Diagnostics" .SH NAME IBADDR \- query InfiniBand address(es) . .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 .. .SH SYNOPSIS .sp ibaddr [options] .SH DESCRIPTION .sp Display the lid (and range) as well as the GID address of the port specified (by DR path, lid, or GUID) or the local port by default. .sp Note: this utility can be used as simple address resolver. .SH OPTIONS .sp \fB\-\-gid_show, \-g\fP show gid address only .sp \fB\-\-lid_show, \-l\fP show lid range only .sp \fB\-\-Lid_show, \-L\fP show lid range (in decimal) only .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH EXAMPLES .sp .nf .ft C ibaddr # local port\e\(aqs address ibaddr 32 # show lid range and gid of lid 32 ibaddr \-G 0x8f1040023 # same but using guid address ibaddr \-l 32 # show lid range only ibaddr \-L 32 # show decimal lid range only ibaddr \-g 32 # show gid address only .ft P .fi .SH SEE ALSO .sp \fBibroute (8), ibtracert (8)\fP .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibportstate.80000644013161601316160000001620012005566563015620 00000000000000.\" Man page generated from reStructeredText. . .TH IBPORTSTATE 8 "" "" "Open IB Diagnostics" .SH NAME IBPORTSTATE \- handle port (physical) state and link speed of an InfiniBand port . .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 .. .SH SYNOPSIS .sp ibportstate [options] [] .SH DESCRIPTION .sp ibportstate allows the port state and port physical state of an IB port to be queried (in addition to link width and speed being validated relative to the peer port when the port queried is a switch port), or a switch port to be disabled, enabled, or reset. It also allows the link speed/width enabled on any IB port to be adjusted. .SH OPTIONS .INDENT 0.0 .TP .B \fB\fP .INDENT 7.0 .TP .B Supported ops: enable, disable, reset, speed, espeed, fdr10, width, query, . down, arm, active, vls, mtu, lid, smlid, lmc, mkey, mkeylease, mkeyprot (Default is query) .UNINDENT .sp \fBenable, disable, and reset\fP are only allowed on switch ports (An error is indicated if attempted on CA or router ports) .sp \fBspeed and width\fP are allowed on any port .sp \fBspeed\fP values are the legal values for PortInfo:LinkSpeedEnabled (An error is indicated if PortInfo:LinkSpeedSupported does not support this setting) .sp \fBespeed\fP is allowed on any port supporting extended link speeds .sp \fBfdr10\fP is allowed on any port supporting fdr10 (An error is indicated if port\(aqs capability mask indicates extended link speeds are not supported or if PortInfo:LinkSpeedExtSupported does not support this setting) .sp \fBwidth\fP values are legal values for PortInfo:LinkWidthEnabled (An error is indicated if PortInfo:LinkWidthSupported does not support this setting) (NOTE: Speed and width changes are not effected until the port goes through link renegotiation) .sp \fBquery\fP also validates port characteristics (link width, speed, espeed, and fdr10) based on the peer port. This checking is done when the port queried is a switch port as it relies on combined routing (an initial LID route with directed routing to the peer) which can only be done on a switch. This peer port validation feature of query op requires LID routing to be functioning in the subnet. .sp \fBmkey, mkeylease, and mkeyprot\fP are only allowed on CAs, routers, or switch port 0 (An error is generated if attempted on external switch ports). Hexadecimal and octal mkeys may be specified by prepending the key with \(aq0x\(aq or \(aq0\(aq, respectively. If a non\-numeric value (like \(aqx\(aq) is specified for the mkey, then ibportstate will prompt for a value. .UNINDENT .SS Addressing Flags .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .SS Debugging flags .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -K . .INDENT 0.0 .TP .B \fB\-K, \-\-show_keys\fP .sp show security keys (mkey, smkey, etc.) associated with the request. .UNINDENT .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH EXAMPLES .INDENT 0.0 .TP .B :: . ibportstate 3 1 disable # by lid ibportstate \-G 0x2C9000100D051 1 enable # by guid ibportstate \-D 0 1 # (query) by direct route ibportstate 3 1 reset # by lid ibportstate 3 1 speed 1 # by lid ibportstate 3 1 width 1 # by lid ibportstate \-D 0 1 lid 0x1234 arm # by direct route .UNINDENT .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%hal.rosenstock@gmail.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/check_lft_balance.80000644013161601316160000000307612005566563016656 00000000000000.\" Man page generated from reStructeredText. . .TH CHECK_LFT_BALANCE 8 "" "" "Open IB Diagnostics" .SH NAME CHECK_LFT_BALANCE \- . .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 .. .SH check InfiniBand unicast forwarding tables balance .SS SYNOPSIS .sp check_lft_balance.sh [\-hRv] .SS DESCRIPTION .sp check_lft_balance.sh is a script which checks for balancing in Infiniband unicast forwarding tables. It analyzes the output of \fBdump_lfts(8)\fP and \fBiblinkinfo(8)\fP .SS OPTIONS .INDENT 0.0 .TP .B \fB\-h\fP .sp show help .TP .B \fB\-R\fP .sp Recalculate dump_lfts information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. .TP .B \fB\-v\fP .sp verbose output .UNINDENT .SS SEE ALSO .sp \fBdump_lfts(8)\fP \fBiblinkinfo(8)\fP .SS AUTHORS .INDENT 0.0 .TP .B Albert Chu . < \fI\%chu11@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibcacheedit.8.in0000644013161601316160000000442012005566554016112 00000000000000.\" Man page generated from reStructeredText. . .TH IBCACHEEDIT 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBCACHEEDIT \- . .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 .. .SH edit an ibnetdiscover cache .SS SYNOPSIS .sp ibcacheedit [options] .SS DESCRIPTION .sp ibcacheedit allows users to edit an ibnetdiscover cache created through the \fB\-\-cache\fP option in \fBibnetdiscover(8)\fP . .SS OPTIONS .INDENT 0.0 .TP .B \fB\-\-switchguid BEFOREGUID:AFTERGUID\fP .sp Specify a switchguid that should be changed. The before and after guid should be separated by a colon. On switches, port guids are identical to the switch guid, so port guids will be adjusted as well on switches. .TP .B \fB\-\-caguid BEFOREGUID:AFTERGUID\fP .sp Specify a caguid that should be changed. The before and after guid should be separated by a colon. .TP .B \fB\-\-sysimgguid BEFOREGUID:AFTERGUID\fP .sp Specify a sysimgguid that should be changed. The before and after guid should be spearated by a colon. .TP .B \fB\-\-portguid NODEGUID:BEFOREGUID:AFTERGUID\fP .sp Specify a portguid that should be changed. The nodeguid of the port (e.g. switchguid or caguid) should be specified first, followed by a colon, the before port guid, another colon, then the after port guid. On switches, port guids are identical to the switch guid, so the switch guid will be adjusted as well on switches. .UNINDENT .SS Debugging flags .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS AUTHORS .INDENT 0.0 .TP .B Albert Chu . < \fI\%chu11@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/infiniband-diags.8.in0000644013161601316160000003237112005566560017057 00000000000000.\" Man page generated from reStructeredText. . .TH INFINIBAND-DIAGS 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME INFINIBAND-DIAGS \- . .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 .. .SH Diagnostics for InfiniBand Fabrics .SS DESCRIPTION .sp infiniband\-diags is a set of utilities designed to help configure, debug, and maintain infiniband fabrics. Many tools and utilities are provided. Some with similar functionality. .sp The base utilities use directed route MAD\(aqs to perform their operations. They may therefore work even in unconfigured subnets. Other, higher level utilities, require LID routed MAD\(aqs and to some extent SA/SM access. .SS THE USE OF SMPs (QP0) .sp Many of the tools in this package rely on the use of SMPs via QP0 to acquire data directly from the SMA. While this mode of operation is not technically in compliance with the InfiniBand specification, practical experience has found that this level of diagnostics is valuable when working with a fabric which is broken or only partially configured. For this reason many of these tools may require the use of an MKey or operation from Virtual Machines may be restricted for security reasons. .SS COMMON OPTIONS .sp Most OpenIB diagnostics take some of the following common flags. The exact list of supported flags per utility can be found in the documentation for those commands. .SS Addressing Flags .sp The \-D and \-G option have two forms: .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct \fP The address specified is a directed route .sp .nf .ft C Examples: \-D "0" # self port \-D "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -G . .sp \fB\-\-port\-guid, \-G \fP Specify a port_guid .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS COMMON FILES .sp The following config files are common amongst many of the utilities. .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .\" Common text to describe the Topology file. . .SS TOPOLOGY FILE FORMAT .sp The topology file format is human readable and largely intuitive. Most identifiers are given textual names like vendor ID (vendid), device ID (device ID), GUIDs of various types (sysimgguid, caguid, switchguid, etc.). PortGUIDs are shown in parentheses (). For switches, this is shown on the switchguid line. For CA and router ports, it is shown on the connectivity lines. The IB node is identified followed by the number of ports and a quoted the node GUID. On the right of this line is a comment (#) followed by the NodeDescription in quotes. If the node is a switch, this line also contains whether switch port 0 is base or enhanced, and the LID and LMC of port 0. Subsequent lines pertaining to this node show the connectivity. On the left is the port number of the current node. On the right is the peer node (node at other end of link). It is identified in quotes with nodetype followed by \- followed by NodeGUID with the port number in square brackets. Further on the right is a comment (#). What follows the comment is dependent on the node type. If it it a switch node, it is followed by the NodeDescription in quotes and the LID of the peer node. If it is a CA or router node, it is followed by the local LID and LMC and then followed by the NodeDescription in quotes and the LID of the peer node. The active link width and speed are then appended to the end of this output line. .sp An example of this is: .sp .nf .ft C # # Topology file: generated on Tue Jun 5 14:15:10 2007 # # Max of 3 hops discovered # Initiated from node 0008f10403960558 port 0008f10403960559 Non\-Chassis Nodes vendid=0x8f1 devid=0x5a06 sysimgguid=0x5442ba00003000 switchguid=0x5442ba00003080(5442ba00003080) Switch 24 "S\-005442ba00003080" # "ISR9024 Voltaire" base port 0 lid 6 lmc 0 [22] "H\-0008f10403961354"[1](8f10403961355) # "MT23108 InfiniHost Mellanox Technologies" lid 4 4xSDR [10] "S\-0008f10400410015"[1] # "SW\-6IB4 Voltaire" lid 3 4xSDR [8] "H\-0008f10403960558"[2](8f1040396055a) # "MT23108 InfiniHost Mellanox Technologies" lid 14 4xSDR [6] "S\-0008f10400410015"[3] # "SW\-6IB4 Voltaire" lid 3 4xSDR [12] "H\-0008f10403960558"[1](8f10403960559) # "MT23108 InfiniHost Mellanox Technologies" lid 10 4xSDR vendid=0x8f1 devid=0x5a05 switchguid=0x8f10400410015(8f10400410015) Switch 8 "S\-0008f10400410015" # "SW\-6IB4 Voltaire" base port 0 lid 3 lmc 0 [6] "H\-0008f10403960984"[1](8f10403960985) # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR [4] "H\-005442b100004900"[1](5442b100004901) # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR [1] "S\-005442ba00003080"[10] # "ISR9024 Voltaire" lid 6 1xSDR [3] "S\-005442ba00003080"[6] # "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960984 Ca 2 "H\-0008f10403960984" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403960985) "S\-0008f10400410015"[6] # lid 16 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x5442b100004900 Ca 2 "H\-005442b100004900" # "MT23108 InfiniHost Mellanox Technologies" [1](5442b100004901) "S\-0008f10400410015"[4] # lid 12 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403961354 Ca 2 "H\-0008f10403961354" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403961355) "S\-005442ba00003080"[22] # lid 4 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960558 Ca 2 "H\-0008f10403960558" # "MT23108 InfiniHost Mellanox Technologies" [2](8f1040396055a) "S\-005442ba00003080"[8] # lid 14 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR [1](8f10403960559) "S\-005442ba00003080"[12] # lid 10 lmc 1 "ISR9024 Voltaire" lid 6 1xSDR .ft P .fi .sp When grouping is used, IB nodes are organized into chassis which are numbered. Nodes which cannot be determined to be in a chassis are displayed as "Non\-Chassis Nodes". External ports are also shown on the connectivity lines. .SS Utilities list .SS Basic fabric conectivity .INDENT 0.0 .INDENT 3.5 .sp See: ibnetdiscover, iblinkinfo .UNINDENT .UNINDENT .SS Node information .INDENT 0.0 .INDENT 3.5 .sp See: ibnodes, ibswitches, ibhosts, ibrouters .UNINDENT .UNINDENT .SS Port information .INDENT 0.0 .INDENT 3.5 .sp See: ibportstate, ibaddr .UNINDENT .UNINDENT .SS Switch Forwarding Table info .INDENT 0.0 .INDENT 3.5 .sp See: ibtracert, ibroute, dump_lfts, dump_mfts, check_lft_balance, ibfindnodesusing .UNINDENT .UNINDENT .SS Peformance counters .INDENT 0.0 .INDENT 3.5 .sp See: ibqueryerrors, perfquery .UNINDENT .UNINDENT .SS Local HCA info .INDENT 0.0 .INDENT 3.5 .sp See: ibstat, ibstatus .UNINDENT .UNINDENT .SS Connectivity check .INDENT 0.0 .INDENT 3.5 .sp See: ibping, ibsysstat .UNINDENT .UNINDENT .SS Low level query tools .INDENT 0.0 .INDENT 3.5 .sp See: smpquery, smpdump, saquery, sminfo .UNINDENT .UNINDENT .SS Fabric verification tools .INDENT 0.0 .INDENT 3.5 .sp See: ibidsverify .UNINDENT .UNINDENT .SS Backwards compatibility scripts .sp The following scripts have been identified as redundant and/or lower performing as compared to the above scripts. They are provided as legacy scripts when \-\-enable\-compat\-utils is specified at build time. .sp ibcheckerrors, ibclearcounters, ibclearerrors, ibdatacounters ibchecknet, ibchecknode, ibcheckport, ibcheckportstate, ibcheckportwidth, ibcheckstate, ibcheckwidth, ibswportwatch, ibprintca, ibprintrt, ibprintswitch, set_nodedesc.sh .SS AUTHORS .INDENT 0.0 .TP .B Ira Weiny . <\fI\%weiny2@llnl.gov\fP> .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/smpdump.8.in0000644013161601316160000001117212005566561015353 00000000000000.\" Man page generated from reStructeredText. . .TH SMPDUMP 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME SMPDUMP \- . .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 .. .SH dump InfiniBand subnet management attributes .SS SYNOPSIS .sp smpdump [options] [attribute_modifier] .SS DESCRIPTION .sp smpdump is a general purpose SMP utility which gets SM attributes from a specified SMA. The result is dumped in hex by default. .SS OPTIONS .INDENT 0.0 .TP .B \fBdlid|drpath\fP .sp LID or DR path to SMA .TP .B \fBattribute\fP .sp IBA attribute ID for SM attribute .TP .B \fBattribute_modifier\fP .sp IBA modifier for SM attribute .TP .B \fB\-s, \-\-string\fP .sp Print strings in packet if possible .UNINDENT .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .sp Direct Routed Examples .INDENT 0.0 .TP .B :: . smpdump \-D 0,1,2,3,5 16 # NODE DESC smpdump \-D 0,1,2 0x15 2 # PORT INFO, port 2 .UNINDENT .sp LID Routed Examples .INDENT 0.0 .TP .B :: . smpdump 3 0x15 2 # PORT INFO, lid 3 port 2 smpdump 0xa0 0x11 # NODE INFO, lid 0xa0 .UNINDENT .SS SEE ALSO .sp smpquery (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/smpquery.80000644013161601316160000001641412005566564015155 00000000000000.\" Man page generated from reStructeredText. . .TH SMPQUERY 8 "" "" "Open IB Diagnostics" .SH NAME SMPQUERY \- . .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 .. .SH query InfiniBand subnet management attributes .SS SYNOPSIS .sp smpquery [options] [op params] .SS DESCRIPTION .sp smpquery allows a basic subset of standard SMP queries including the following: node info, node description, switch info, port info. Fields are displayed in human readable format. .SS OPTIONS .sp Current supported operations and their parameters: .INDENT 0.0 .TP .B :: . nodeinfo nodedesc portinfo [] # default port is zero switchinfo pkeys [] sl2vl [] vlarb [] guids mlnxextportinfo [] # default port is zero .TP .B \fB\-c, \-\-combined\fP .sp Use Combined route address argument \fC \fP .TP .B \fB\-x, \-\-extended\fP .sp Set SMSupportsExtendedSpeeds bit 31 in AttributeModifier (only impacts PortInfo queries). .UNINDENT .\" Define the common option -K . .INDENT 0.0 .TP .B \fB\-K, \-\-show_keys\fP .sp show security keys (mkey, smkey, etc.) associated with the request. .UNINDENT .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .SS EXAMPLES .INDENT 0.0 .TP .B :: . smpquery portinfo 3 1 # portinfo by lid, with port modifier smpquery \-G switchinfo 0x2C9000100D051 1 # switchinfo by guid smpquery \-D nodeinfo 0 # nodeinfo by direct route smpquery \-c nodeinfo 6 0,12 # nodeinfo by combined route .UNINDENT .SS SEE ALSO .sp smpdump (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%hal@mellanox.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/vendstat.80000644013161601316160000001212512005566564015113 00000000000000.\" Man page generated from reStructeredText. . .TH VENDSTAT 8 "" "" "Open IB Diagnostics" .SH NAME VENDSTAT \- . .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 .. .SH query InfiniBand vendor specific functions .SS SYNOPSIS .sp vendstat [options] .SS DESCRIPTION .sp vendstat uses vendor specific MADs to access beyond the IB spec vendor specific functionality. Currently, there is support for Mellanox InfiniSwitch\-III (IS3) and InfiniSwitch\-IV (IS4). .SS OPTIONS .INDENT 0.0 .TP .B \fB\-N\fP .sp show IS3 or IS4 general information. .TP .B \fB\-w\fP .sp show IS3 port xmit wait counters. .TP .B \fB\-i\fP .sp show IS4 counter group info. .TP .B \fB\-c \fP .sp configure IS4 counter groups. .sp Configure IS4 counter groups 0 and 1. Such configuration is not persistent across IS4 reboot. First number is for counter group 0 and second is for counter group 1. .sp Group 0 counter config values: .UNINDENT .INDENT 0.0 .TP .B :: .INDENT 7.0 .INDENT 3.5 .sp 0 \- PortXmitDataSL0\-7 1 \- PortXmitDataSL8\-15 2 \- PortRcvDataSL0\-7 .UNINDENT .UNINDENT .sp Group 1 counter config values: .UNINDENT .INDENT 0.0 .TP .B :: . 1 \- PortXmitDataSL8\-15 2 \- PortRcvDataSL0\-7 8 \- PortRcvDataSL8\-15 .TP .B \fB\-R, \-\-Read \fP .sp Read configuration space record at addr .TP .B \fB\-W, \-\-Write \fP .sp Write configuration space record at addr .UNINDENT .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .INDENT 0.0 .TP .B :: . vendstat \-N 6 # read IS3 or IS4 general information vendstat \-w 6 # read IS3 port xmit wait counters vendstat \-i 6 12 # read IS4 port 12 counter group info vendstat \-c 0,1 6 12 # configure IS4 port 12 counter groups for PortXmitDataSL vendstat \-c 2,8 6 12 # configure IS4 port 12 counter groups for PortRcvDataSL .UNINDENT .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%hal.rosenstock@gmail.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/check_lft_balance.8.in0000644013161601316160000000311212005566553017251 00000000000000.\" Man page generated from reStructeredText. . .TH CHECK_LFT_BALANCE 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME CHECK_LFT_BALANCE \- . .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 .. .SH check InfiniBand unicast forwarding tables balance .SS SYNOPSIS .sp check_lft_balance.sh [\-hRv] .SS DESCRIPTION .sp check_lft_balance.sh is a script which checks for balancing in Infiniband unicast forwarding tables. It analyzes the output of \fBdump_lfts(8)\fP and \fBiblinkinfo(8)\fP .SS OPTIONS .INDENT 0.0 .TP .B \fB\-h\fP .sp show help .TP .B \fB\-R\fP .sp Recalculate dump_lfts information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. .TP .B \fB\-v\fP .sp verbose output .UNINDENT .SS SEE ALSO .sp \fBdump_lfts(8)\fP \fBiblinkinfo(8)\fP .SS AUTHORS .INDENT 0.0 .TP .B Albert Chu . < \fI\%chu11@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibroute.80000644013161601316160000001325312005566563014736 00000000000000.\" Man page generated from reStructeredText. . .TH IBROUTE 8 "" "" "Open IB Diagnostics" .SH NAME IBROUTE \- . .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 .. .SH query InfiniBand switch forwarding tables .SS SYNOPSIS .sp ibroute [options] [ [ []]] .SS DESCRIPTION .sp ibroute uses SMPs to display the forwarding tables (unicast (LinearForwardingTable or LFT) or multicast (MulticastForwardingTable or MFT)) for the specified switch LID and the optional lid (mlid) range. The default range is all valid entries in the range 1...FDBTop. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-a, \-\-all\fP .sp show all lids in range, even invalid entries .TP .B \fB\-n, \-\-no_dests\fP .sp do not try to resolve destinations .TP .B \fB\-M, \-\-Multicast\fP .sp show multicast forwarding tables In this case, the range parameters are specifying the mlid range. .UNINDENT .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .sp Unicast examples .INDENT 0.0 .TP .B :: . ibroute 4 # dump all lids with valid out ports of switch with lid 4 ibroute \-a 4 # same, but dump all lids, even with invalid out ports ibroute \-n 4 # simple dump format \- no destination resolution ibroute 4 10 # dump lids starting from 10 (up to FDBTop) ibroute 4 0x10 0x20 # dump lid range ibroute \-G 0x08f1040023 # resolve switch by GUID ibroute \-D 0,1 # resolve switch by direct path .UNINDENT .sp Multicast examples .INDENT 0.0 .TP .B :: . ibroute \-M 4 # dump all non empty mlids of switch with lid 4 ibroute \-M 4 0xc010 0xc020 # same, but with range ibroute \-M \-n 4 # simple dump format .UNINDENT .SS SEE ALSO .sp ibtracert (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/sminfo.8.in0000644013161601316160000001176112005566561015165 00000000000000.\" Man page generated from reStructeredText. . .TH SMINFO 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME SMINFO \- . .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 .. .SH query InfiniBand SMInfo attribute .SS SYNOPSIS .sp sminfo [options] sm_lid | sm_dr_path [modifier] .SS DESCRIPTION .sp Optionally set and display the output of a sminfo query in human readable format. The target SM is the one listed in the local port info, or the SM specified by the optional SM lid or by the SM direct routed path. .sp Note: using sminfo for any purposes other then simple query may be very dangerous, and may result in a malfunction of the target SM. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-s, \-\-state \fP set SM state .sp 0 not active .sp 1 discovering .sp 2 standby .sp 3 master .UNINDENT .sp \fB\-p, \-\-priority \fP set priority (0\-15) .sp \fB\-a, \-\-activity \fP set activity count .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .INDENT 0.0 .TP .B :: . sminfo # local port\(aqs sminfo sminfo 32 # show sminfo of lid 32 sminfo \-G 0x8f1040023 # same but using guid address .UNINDENT .SS SEE ALSO .sp smpdump (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibccquery.80000644013161601316160000001103412005566563015246 00000000000000.\" Man page generated from reStructeredText. . .TH IBCCQUERY 8 "" "" "OpenIB Diagnostics" .SH NAME IBCCQUERY \- query congestion control settings/info . .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 .. .SH SYNOPSIS .sp ibccquery [common_options] [\-c cckey] [port] .SH DESCRIPTION .sp ibccquery support the querying of settings and other information related to congestion control. .SH OPTIONS .INDENT 0.0 .TP .B Current supported operations and their parameters: . CongestionInfo (CI) CongestionKeyInfo (CK) CongestionLog (CL) SwitchCongestionSetting (SS) SwitchPortCongestionSetting (SP) [] CACongestionSetting (CS) CongestionControlTable (CT) Timestamp (TI) .UNINDENT .sp \fB\-\-cckey, \-c \fP Specify a congestion control (CC) key. If none is specified, a key of 0 is used. .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH EXAMPLES .sp .nf .ft C ibccquery CongestionInfo 3 # Congestion Info by lid ibccquery SwitchPortCongestionSetting 3 # Query all Switch Port Congestion Settings ibccquery SwitchPortCongestionSetting 3 1 # Query Switch Port Congestion Setting for port 1 .ft P .fi .SH AUTHOR .INDENT 0.0 .TP .B Albert Chu . < \fI\%chu11@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibnetdiscover.80000644013161601316160000003046112005566563016125 00000000000000.\" Man page generated from reStructeredText. . .TH IBNETDISCOVER 8 "" "" "Open IB Diagnostics" .SH NAME IBNETDISCOVER \- discover InfiniBand topology . .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 .. .SH SYNOPSIS .sp ibnetdiscover [options] [] .SH DESCRIPTION .sp ibnetdiscover performs IB subnet discovery and outputs a human readable topology file. GUIDs, node types, and port numbers are displayed as well as port LIDs and NodeDescriptions. All nodes (and links) are displayed (full topology). Optionally, this utility can be used to list the current connected nodes by nodetype. The output is printed to standard output unless a topology file is specified. .SH OPTIONS .sp \fB\-l, \-\-list\fP List of connected nodes .sp \fB\-g, \-\-grouping\fP Show grouping. Grouping correlates IB nodes by different vendor specific schemes. It may also show the switch external ports correspondence. .sp \fB\-H, \-\-Hca_list\fP List of connected CAs .sp \fB\-S, \-\-Switch_list\fP List of connected switches .sp \fB\-R, \-\-Router_list\fP List of connected routers .sp \fB\-s, \-\-show\fP Show progress information during discovery. .sp \fB\-p, \-\-ports\fP Obtain a ports report which is a list of connected ports with relevant information (like LID, portnum, GUID, width, speed, and NodeDescription). .sp \fB\-m, \-\-max_hops\fP Report max hops discovered. .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .SS Cache File flags .\" Define the common option cache . .sp \fB\-\-cache \fP Cache the ibnetdiscover network data in the specified filename. This cache may be used by other tools for later analysis. .\" Define the common option load-cache . .sp \fB\-\-load\-cache \fP Load and use the cached ibnetdiscover data stored in the specified filename. May be useful for outputting and learning about other fabrics or a previous state of a fabric. .\" Define the common option diff . .sp \fB\-\-diff \fP Load cached ibnetdiscover data and do a diff comparison to the current network or another cache. A special diff output for ibnetdiscover output will be displayed showing differences between the old and current fabric. By default, the following are compared for differences: switches, channel adapters, routers, and port connections. .\" Define the common option diffcheck . .sp \fB\-\-diffcheck \fP Specify what diff checks should be done in the \fB\-\-diff\fP option above. Comma separate multiple diff check key(s). The available diff checks are: \fBsw = switches\fP, \fBca = channel adapters\fP, \fBrouter\fP = routers, \fBport\fP = port connections, \fBlid\fP = lids, \fBnodedesc\fP = node descriptions. Note that \fBport\fP, \fBlid\fP, and \fBnodedesc\fP are checked only for the node types that are specified (e.g. \fBsw\fP, \fBca\fP, \fBrouter\fP). If \fBport\fP is specified alongside \fBlid\fP or \fBnodedesc\fP, remote port lids and node descriptions will also be compared. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP .sp Specify the number of outstanding SMP\(aqs which should be issued during the scan .sp Default: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP Specify a node name map. .INDENT 0.0 .INDENT 3.5 .sp This file maps GUIDs to more user friendly names. See FILES section. .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .\" Common text to describe the node name map file. . .SS NODE NAME MAP FILE FORMAT .sp The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. .sp This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP for the file location for your installation. .sp \fBGenerically:\fP .sp .nf .ft C # comment "" .ft P .fi .sp \fBExample:\fP .sp .nf .ft C # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .ft P .fi .\" Common text to describe the Topology file. . .SS TOPOLOGY FILE FORMAT .sp The topology file format is human readable and largely intuitive. Most identifiers are given textual names like vendor ID (vendid), device ID (device ID), GUIDs of various types (sysimgguid, caguid, switchguid, etc.). PortGUIDs are shown in parentheses (). For switches, this is shown on the switchguid line. For CA and router ports, it is shown on the connectivity lines. The IB node is identified followed by the number of ports and a quoted the node GUID. On the right of this line is a comment (#) followed by the NodeDescription in quotes. If the node is a switch, this line also contains whether switch port 0 is base or enhanced, and the LID and LMC of port 0. Subsequent lines pertaining to this node show the connectivity. On the left is the port number of the current node. On the right is the peer node (node at other end of link). It is identified in quotes with nodetype followed by \- followed by NodeGUID with the port number in square brackets. Further on the right is a comment (#). What follows the comment is dependent on the node type. If it it a switch node, it is followed by the NodeDescription in quotes and the LID of the peer node. If it is a CA or router node, it is followed by the local LID and LMC and then followed by the NodeDescription in quotes and the LID of the peer node. The active link width and speed are then appended to the end of this output line. .sp An example of this is: .sp .nf .ft C # # Topology file: generated on Tue Jun 5 14:15:10 2007 # # Max of 3 hops discovered # Initiated from node 0008f10403960558 port 0008f10403960559 Non\-Chassis Nodes vendid=0x8f1 devid=0x5a06 sysimgguid=0x5442ba00003000 switchguid=0x5442ba00003080(5442ba00003080) Switch 24 "S\-005442ba00003080" # "ISR9024 Voltaire" base port 0 lid 6 lmc 0 [22] "H\-0008f10403961354"[1](8f10403961355) # "MT23108 InfiniHost Mellanox Technologies" lid 4 4xSDR [10] "S\-0008f10400410015"[1] # "SW\-6IB4 Voltaire" lid 3 4xSDR [8] "H\-0008f10403960558"[2](8f1040396055a) # "MT23108 InfiniHost Mellanox Technologies" lid 14 4xSDR [6] "S\-0008f10400410015"[3] # "SW\-6IB4 Voltaire" lid 3 4xSDR [12] "H\-0008f10403960558"[1](8f10403960559) # "MT23108 InfiniHost Mellanox Technologies" lid 10 4xSDR vendid=0x8f1 devid=0x5a05 switchguid=0x8f10400410015(8f10400410015) Switch 8 "S\-0008f10400410015" # "SW\-6IB4 Voltaire" base port 0 lid 3 lmc 0 [6] "H\-0008f10403960984"[1](8f10403960985) # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR [4] "H\-005442b100004900"[1](5442b100004901) # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR [1] "S\-005442ba00003080"[10] # "ISR9024 Voltaire" lid 6 1xSDR [3] "S\-005442ba00003080"[6] # "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960984 Ca 2 "H\-0008f10403960984" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403960985) "S\-0008f10400410015"[6] # lid 16 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x5442b100004900 Ca 2 "H\-005442b100004900" # "MT23108 InfiniHost Mellanox Technologies" [1](5442b100004901) "S\-0008f10400410015"[4] # lid 12 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403961354 Ca 2 "H\-0008f10403961354" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403961355) "S\-005442ba00003080"[22] # lid 4 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960558 Ca 2 "H\-0008f10403960558" # "MT23108 InfiniHost Mellanox Technologies" [2](8f1040396055a) "S\-005442ba00003080"[8] # lid 14 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR [1](8f10403960559) "S\-005442ba00003080"[12] # lid 10 lmc 1 "ISR9024 Voltaire" lid 6 1xSDR .ft P .fi .sp When grouping is used, IB nodes are organized into chassis which are numbered. Nodes which cannot be determined to be in a chassis are displayed as "Non\-Chassis Nodes". External ports are also shown on the connectivity lines. .SH AUTHORS .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .TP .B Ira Weiny . < \fI\%weiny2@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/perfquery.80000644013161601316160000001760412005566564015314 00000000000000.\" Man page generated from reStructeredText. . .TH PERFQUERY 8 "" "" "Open IB Diagnostics" .SH NAME PERFQUERY \- . .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 .. .SH query InfiniBand port counters on a single port .SS SYNOPSIS .sp perfquery [options] [ [[port] [reset_mask]]] .SS DESCRIPTION .sp perfquery uses PerfMgt GMPs to obtain the PortCounters (basic performance and error counters), PortExtendedCounters, PortXmitDataSL, PortRcvDataSL, PortRcvErrorDetails, PortXmitDiscardDetails, PortExtendedSpeedsCounters, or PortSamplesControl from the PMA at the node/port specified. Optionally shows aggregated counters for all ports of node. Finally it can, reset after read, or just reset the counters. .sp Note: In PortCounters, PortCountersExtended, PortXmitDataSL, and PortRcvDataSL, components that represent Data (e.g. PortXmitData and PortRcvData) indicate octets divided by 4 rather than just octets. .sp Note: Inputting a port of 255 indicates an operation be performed on all ports. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-x, \-\-extended\fP .sp show extended port counters rather than (basic) port counters. Note that extended port counters attribute is optional. .TP .B \fB\-X, \-\-xmtsl\fP .sp show transmit data SL counter. This is an optional counter for QoS. .TP .B \fB\-S, \-\-rcvsl\fP .sp show receive data SL counter. This is an optional counter for QoS. .TP .B \fB\-D, \-\-xmtdisc\fP .sp show transmit discard details. This is an optional counter. .TP .B \fB\-E, \-\-rcverr\fP .sp show receive error details. This is an optional counter. .TP .B \fB\-D, \-\-xmtdisc\fP .sp show transmit discard details. This is an optional counter. .TP .B \fB\-T, \-\-extended_speeds\fP .sp show extended speeds port counters. This is an optional counter. .TP .B \fB\-\-oprcvcounters\fP .sp show Rcv Counters per Op code. This is an optional counter. .TP .B \fB\-\-flowctlcounters\fP .sp show flow control counters. This is an optional counter. .TP .B \fB\-\-vloppackets\fP .sp show packets received per Op code per VL. This is an optional counter. .TP .B \fB\-\-vlopdata\fP .sp show data received per Op code per VL. This is an optional counter. .TP .B \fB\-\-vlxmitflowctlerrors\fP .sp show flow control update errors per VL. This is an optional counter. .TP .B \fB\-\-vlxmitcounters\fP .sp show ticks waiting to transmit counters per VL. This is an optional counter. .TP .B \fB\-\-swportvlcong\fP .sp show sw port VL congestion. This is an optional counter. .TP .B \fB\-\-rcvcc\fP .sp show Rcv congestion control counters. This is an optional counter. .TP .B \fB\-\-slrcvfecn\fP .sp show SL Rcv FECN counters. This is an optional counter. .TP .B \fB\-\-slrcvbecn\fP .sp show SL Rcv BECN counters. This is an optional counter. .TP .B \fB\-\-xmitcc\fP .sp show Xmit congestion control counters. This is an optional counter. .TP .B \fB\-\-vlxmittimecc\fP .sp show VL Xmit Time congestion control counters. This is an optional counter. .TP .B \fB\-c, \-\-smplctl\fP .sp show port samples control. .TP .B \fB\-a, \-\-all_ports\fP .sp show aggregated counters for all ports of the destination lid or reset all counters for all ports. If the destination lid does not support the AllPortSelect flag, all ports will be iterated through to emulate AllPortSelect behavior. .TP .B \fB\-l, \-\-loop_ports\fP .sp If all ports are selected by the user (either through the \fB\-a\fP option or port 255) iterate through each port rather than doing than aggregate operation. .TP .B \fB\-r, \-\-reset_after_read\fP .sp reset counters after read .TP .B \fB\-R, \-\-Reset_only\fP .sp only reset counters .UNINDENT .SS Addressing Flags .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP The address specified is a LID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP override the default timeout for the solicited mads. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: /usr/local/etc/infiniband-diags/ibdiag.conf .UNINDENT .UNINDENT .SS FILES .\" Common text for the config file . .SS CONFIG FILE .sp /usr/local/etc/infiniband-diags/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SS EXAMPLES .INDENT 0.0 .TP .B :: . perfquery # read local port performance counters perfquery 32 1 # read performance counters from lid 32, port 1 perfquery \-x 32 1 # read extended performance counters from lid 32, port 1 perfquery \-a 32 # read perf counters from lid 32, all ports perfquery \-r 32 1 # read performance counters and reset perfquery \-x \-r 32 1 # read extended performance counters and reset perfquery \-R 0x20 1 # reset performance counters of port 1 only perfquery \-x \-R 0x20 1 # reset extended performance counters of port 1 only perfquery \-R \-a 32 # reset performance counters of all ports perfquery \-R 32 2 0x0fff # reset only error counters of port 2 perfquery \-R 32 2 0xf000 # reset only non\-error counters of port 2 .UNINDENT .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%hal.rosenstock@gmail.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibaddr.8.in0000644013161601316160000001145212005566554015116 00000000000000.\" Man page generated from reStructeredText. . .TH IBADDR 8 "@BUILD_DATE@" "" "OpenIB Diagnostics" .SH NAME IBADDR \- query InfiniBand address(es) . .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 .. .SH SYNOPSIS .sp ibaddr [options] .SH DESCRIPTION .sp Display the lid (and range) as well as the GID address of the port specified (by DR path, lid, or GUID) or the local port by default. .sp Note: this utility can be used as simple address resolver. .SH OPTIONS .sp \fB\-\-gid_show, \-g\fP show gid address only .sp \fB\-\-lid_show, \-l\fP show lid range only .sp \fB\-\-Lid_show, \-L\fP show lid range (in decimal) only .SS Addressing Flags .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP The address specified is a directed route .sp .nf .ft C Examples: [options] \-D [options] "0" # self port [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag \(aq\-P\(aq or the port found through the automatic selection process.) .ft P .fi .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP The address specified is a Port GUID .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP use \(aqsmlid\(aq as the target lid for SA queries. .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e . show send and receive errors (timeouts and others) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Port Selection flags .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP use the specified ca_name. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP use the specified ca_port. .\" Explanation of local port selection . .SS Local port Selection .sp Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 . the first port that is ACTIVE. .IP 2. 3 . if not found, the first port that is UP (physical link up). .UNINDENT .sp If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. .sp For example: .sp .nf .ft C ibaddr # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from "mthca1" only. ibaddr \-P 2 # use the second (active/up) port from the first available IB device. ibaddr \-C mthca0 \-P 2 # use the specified port only. .ft P .fi .UNINDENT .UNINDENT .SS Configuration flags .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP .sp use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq) is specified then a value will be prompted for. .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SH FILES .\" Common text for the config file . .SS CONFIG FILE .sp @IBDIAG_CONFIG_PATH@/ibdiag.conf .sp A global config file is provided to set some of the common options for all tools. See supplied config file for details. .SH EXAMPLES .sp .nf .ft C ibaddr # local port\e\(aqs address ibaddr 32 # show lid range and gid of lid 32 ibaddr \-G 0x8f1040023 # same but using guid address ibaddr \-l 32 # show lid range only ibaddr \-L 32 # show decimal lid range only ibaddr \-g 32 # show gid address only .ft P .fi .SH SEE ALSO .sp \fBibroute (8), ibtracert (8)\fP .SH AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibstat.8.in0000644013161601316160000000516312005566557015164 00000000000000.\" Man page generated from reStructeredText. . .TH IBSTAT 8 "@BUILD_DATE@" "" "Open IB Diagnostics" .SH NAME IBSTAT \- . .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 .. .SH query basic status of InfiniBand device(s) .SS SYNOPSIS .sp ibstat [options] [portnum] .SS DESCRIPTION .sp ibstat is a binary which displays basic information obtained from the local IB driver. Output includes LID, SMLID, port state, link width active, and port physical state. .sp It is similar to the ibstatus utility but implemented as a binary rather than a script. It has options to list CAs and/or ports and displays more information than ibstatus. .SS OPTIONS .INDENT 0.0 .TP .B \fB\-l, \-\-list_of_cas\fP .sp list all IB devices .TP .B \fB\-s, \-\-short\fP .sp short output .TP .B \fB\-p, \-\-port_list\fP .sp show port list .TP .B \fBca_name\fP .sp InfiniBand device name .TP .B \fBportnum\fP .sp port number of InfiniBand device .UNINDENT .SS Debugging flags .\" Define the common option -d . .INDENT 0.0 .TP .B \-d . raise the IB debugging level. May be used several times (\-ddd or \-d \-d \-d). .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP .sp increase the application verbosity level. May be used several times (\-vv or \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS Configuration flags .\" Define the common option -z . .sp \fB\-\-config, \-z \fP Specify alternate config file. .INDENT 0.0 .INDENT 3.5 .sp Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf .UNINDENT .UNINDENT .SS EXAMPLES .INDENT 0.0 .TP .B :: . ibstat # display status of all ports on all IB devices ibstat \-l # list all IB devices ibstat \-p # show port guids ibstat mthca0 2 # show status of port 2 of \(aqmthca0\(aq .UNINDENT .SS SEE ALSO .sp ibstatus (8) .SS AUTHOR .INDENT 0.0 .TP .B Hal Rosenstock . < \fI\%halr@voltaire.com\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/man/ibcacheedit.80000644013161601316160000000440412005566563015507 00000000000000.\" Man page generated from reStructeredText. . .TH IBCACHEEDIT 8 "" "" "Open IB Diagnostics" .SH NAME IBCACHEEDIT \- . .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 .. .SH edit an ibnetdiscover cache .SS SYNOPSIS .sp ibcacheedit [options] .SS DESCRIPTION .sp ibcacheedit allows users to edit an ibnetdiscover cache created through the \fB\-\-cache\fP option in \fBibnetdiscover(8)\fP . .SS OPTIONS .INDENT 0.0 .TP .B \fB\-\-switchguid BEFOREGUID:AFTERGUID\fP .sp Specify a switchguid that should be changed. The before and after guid should be separated by a colon. On switches, port guids are identical to the switch guid, so port guids will be adjusted as well on switches. .TP .B \fB\-\-caguid BEFOREGUID:AFTERGUID\fP .sp Specify a caguid that should be changed. The before and after guid should be separated by a colon. .TP .B \fB\-\-sysimgguid BEFOREGUID:AFTERGUID\fP .sp Specify a sysimgguid that should be changed. The before and after guid should be spearated by a colon. .TP .B \fB\-\-portguid NODEGUID:BEFOREGUID:AFTERGUID\fP .sp Specify a portguid that should be changed. The nodeguid of the port (e.g. switchguid or caguid) should be specified first, followed by a colon, the before port guid, another colon, then the after port guid. On switches, port guids are identical to the switch guid, so the switch guid will be adjusted as well on switches. .UNINDENT .SS Debugging flags .\" Define the common option -h . .sp \fB\-h, \-\-help\fP show the usage message .\" Define the common option -V . .sp \fB\-V, \-\-version\fP show the version info. .SS AUTHORS .INDENT 0.0 .TP .B Albert Chu . < \fI\%chu11@llnl.gov\fP > .UNINDENT .\" Generated by docutils manpage writer. .\" . infiniband-diags-1.6.1/doc/rst/0000755013161601316160000000000012005565227013301 500000000000000infiniband-diags-1.6.1/doc/rst/dump_mfts.8.in.rst0000644013161601316160000000213112003563134016512 00000000000000============ DUMP_MFTS.SH ============ ------------------------------------------- dump InfiniBand multicast forwarding tables ------------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== dump_mfts.sh [\-h] [\-D] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] [>/path/to/file] DESCRIPTION =========== dump_mfts.sh is a script which dumps the InfiniBand multicast forwarding tables (MFTs) in the switch nodes in the subnet. OPTIONS ======= **-D** dump forwarding tables using direct routed rather than LID routed SMPs **-h** show help Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst .. include:: common/opt_t.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst SEE ALSO ======== **dump_lfts(8), ibroute(8), ibswitches(8), opensm(8)** AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/smpquery.8.in.rst0000644013161601316160000000447712003563134016420 00000000000000======== SMPQUERY ======== :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics --------------------------------------------- query InfiniBand subnet management attributes --------------------------------------------- SYNOPSIS ======== smpquery [options] [op params] DESCRIPTION =========== smpquery allows a basic subset of standard SMP queries including the following: node info, node description, switch info, port info. Fields are displayed in human readable format. OPTIONS ======= Current supported operations and their parameters: :: nodeinfo nodedesc portinfo [] # default port is zero switchinfo pkeys [] sl2vl [] vlarb [] guids mlnxextportinfo [] # default port is zero **-c, --combined** Use Combined route address argument `` `` **-x, --extended** Set SMSupportsExtendedSpeeds bit 31 in AttributeModifier (only impacts PortInfo queries). .. include:: common/opt_K.rst Addressing Flags ---------------- .. include:: common/opt_D.rst .. include:: common/opt_G.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_node_name_map.rst .. include:: common/opt_y.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst EXAMPLES ======== :: smpquery portinfo 3 1 # portinfo by lid, with port modifier smpquery -G switchinfo 0x2C9000100D051 1 # switchinfo by guid smpquery -D nodeinfo 0 # nodeinfo by direct route smpquery -c nodeinfo 6 0,12 # nodeinfo by combined route SEE ALSO ======== smpdump (8) AUTHOR ====== Hal Rosenstock < hal@mellanox.com > infiniband-diags-1.6.1/doc/rst/check_lft_balance.8.in.rst0000644013161601316160000000173312003563134020112 00000000000000================= CHECK_LFT_BALANCE ================= :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics -------------------------------------------------- check InfiniBand unicast forwarding tables balance -------------------------------------------------- SYNOPSIS ======== check_lft_balance.sh [-hRv] DESCRIPTION =========== check_lft_balance.sh is a script which checks for balancing in Infiniband unicast forwarding tables. It analyzes the output of **dump_lfts(8)** and **iblinkinfo(8)** OPTIONS ======= **-h** show help **-R** Recalculate dump_lfts information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. **-v** verbose output SEE ALSO ======== **dump_lfts(8)** **iblinkinfo(8)** AUTHORS ======= Albert Chu < chu11@llnl.gov > infiniband-diags-1.6.1/doc/rst/ibqueryerrors.8.in.rst0000644013161601316160000000703112005565227017444 00000000000000============= IBQUERYERRORS ============= --------------------------------- query and report IB port counters --------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibqueryerrors [options] DESCRIPTION =========== The default behavior is to report the port error counters which exceed a threshold for each port in the fabric. The default threshold is zero (0). Error fields can also be suppressed entirely. In addition to reporting errors on every port. ibqueryerrors can report the port transmit and receive data as well as report full link information to the remote port if available. OPTIONS ======= **-s, --suppress ** Suppress the errors listed in the comma separated list provided. **-c, --suppress-common** Suppress some of the common "side effect" counters. These counters usually do not indicate an error condition and can be usually be safely ignored. **-r, --report-port** Report the port information. This includes LID, port, external port (if applicable), link speed setting, remote GUID, remote port, remote external port (if applicable), and remote node description information. **--data** Include the optional transmit and receive data counters. **--threshold-file ** Specify an alternate threshold file. The default is @IBDIAG_CONFIG_PATH@/error_thresholds **--switch** print data for switch's only **--ca** print data for CA's only **--router** print data for routers only **--clear-errors -k** Clear error counters after read. **--clear-counts -K** Clear data counters after read. **CAUTION** clearing data or error counters will occur regardless of if they are printed or not. See **--counters** and **--data** for details on controling which counters are printed. **--details** include receive error and transmit discard details **--counters** print data counters only Partial Scan flags ------------------ The node to start a partial scan can be specified with the following addresses. .. include:: common/opt_G_with_param.rst .. include:: common/opt_D_with_param.rst **Note:** For switches results are printed for all ports not just switch port 0. **-S ** same as "-G". (provided only for backward compatibility) Cache File flags ---------------- .. include:: common/opt_load-cache.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst .. include:: common/opt_o-outstanding_smps.rst .. include:: common/opt_node_name_map.rst .. include:: common/opt_t.rst .. include:: common/opt_y.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst **-R** (This option is obsolete and does nothing) EXIT STATUS =========== **-1** if scan fails. **0** if scan succeeds without errors beyond thresholds **1** if errors are found beyond thresholds or inconsistencies are found in check mode. FILES ===== ERROR THRESHOLD --------------- @IBDIAG_CONFIG_PATH@/error_thresholds Define threshold values for errors. File format is simple "name=val". Comments begin with '#' **Example:** :: # Define thresholds for error counters SymbolErrorCounter=10 LinkErrorRecoveryCounter=10 VL15Dropped=100 .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst AUTHOR ====== Ira Weiny < weiny2@llnl.gov > infiniband-diags-1.6.1/doc/rst/ibcacheedit.8.in.rst0000644013161601316160000000305012003563134016741 00000000000000=========== IBCACHEEDIT =========== :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics --------------------------- edit an ibnetdiscover cache --------------------------- SYNOPSIS ======== ibcacheedit [options] DESCRIPTION =========== ibcacheedit allows users to edit an ibnetdiscover cache created through the **--cache** option in **ibnetdiscover(8)** . OPTIONS ======= **--switchguid BEFOREGUID:AFTERGUID** Specify a switchguid that should be changed. The before and after guid should be separated by a colon. On switches, port guids are identical to the switch guid, so port guids will be adjusted as well on switches. **--caguid BEFOREGUID:AFTERGUID** Specify a caguid that should be changed. The before and after guid should be separated by a colon. **--sysimgguid BEFOREGUID:AFTERGUID** Specify a sysimgguid that should be changed. The before and after guid should be spearated by a colon. **--portguid NODEGUID:BEFOREGUID:AFTERGUID** Specify a portguid that should be changed. The nodeguid of the port (e.g. switchguid or caguid) should be specified first, followed by a colon, the before port guid, another colon, then the after port guid. On switches, port guids are identical to the switch guid, so the switch guid will be adjusted as well on switches. Debugging flags --------------- .. include:: common/opt_h.rst .. include:: common/opt_V.rst AUTHORS ======= Albert Chu < chu11@llnl.gov > infiniband-diags-1.6.1/doc/rst/ibnetdiscover.8.in.rst0000644013161601316160000000446612003563134017371 00000000000000============= IBNETDISCOVER ============= ---------------------------- discover InfiniBand topology ---------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics SYNOPSIS ======== ibnetdiscover [options] [] DESCRIPTION =========== ibnetdiscover performs IB subnet discovery and outputs a human readable topology file. GUIDs, node types, and port numbers are displayed as well as port LIDs and NodeDescriptions. All nodes (and links) are displayed (full topology). Optionally, this utility can be used to list the current connected nodes by nodetype. The output is printed to standard output unless a topology file is specified. OPTIONS ======= **-l, --list** List of connected nodes **-g, --grouping** Show grouping. Grouping correlates IB nodes by different vendor specific schemes. It may also show the switch external ports correspondence. **-H, --Hca_list** List of connected CAs **-S, --Switch_list** List of connected switches **-R, --Router_list** List of connected routers **-s, --show** Show progress information during discovery. **-p, --ports** Obtain a ports report which is a list of connected ports with relevant information (like LID, portnum, GUID, width, speed, and NodeDescription). **-m, --max_hops** Report max hops discovered. .. include:: common/opt_o-outstanding_smps.rst Cache File flags ---------------- .. include:: common/opt_cache.rst .. include:: common/opt_load-cache.rst .. include:: common/opt_diff.rst .. include:: common/opt_diffcheck.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst .. include:: common/opt_o-outstanding_smps.rst .. include:: common/opt_node_name_map.rst .. include:: common/opt_t.rst .. include:: common/opt_y.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst .. include:: common/sec_topology-file.rst AUTHORS ======= Hal Rosenstock < halr@voltaire.com > Ira Weiny < weiny2@llnl.gov > infiniband-diags-1.6.1/doc/rst/common/0000755013161601316160000000000012005565227014571 500000000000000infiniband-diags-1.6.1/doc/rst/common/opt_y.rst0000644013161601316160000000027512003563134016372 00000000000000.. Define the common option -y **-y, --m_key ** use the specified M_key for requests. If non-numeric value (like 'x') is specified then a value will be prompted for. infiniband-diags-1.6.1/doc/rst/common/opt_G_with_param.rst0000644013161601316160000000012612003563134020516 00000000000000.. Define the common option -G **--port-guid, -G ** Specify a port_guid infiniband-diags-1.6.1/doc/rst/common/sec_topology-file.rst0000644013161601316160000001036012003563134020657 00000000000000.. Common text to describe the Topology file. TOPOLOGY FILE FORMAT -------------------- The topology file format is human readable and largely intuitive. Most identifiers are given textual names like vendor ID (vendid), device ID (device ID), GUIDs of various types (sysimgguid, caguid, switchguid, etc.). PortGUIDs are shown in parentheses (). For switches, this is shown on the switchguid line. For CA and router ports, it is shown on the connectivity lines. The IB node is identified followed by the number of ports and a quoted the node GUID. On the right of this line is a comment (#) followed by the NodeDescription in quotes. If the node is a switch, this line also contains whether switch port 0 is base or enhanced, and the LID and LMC of port 0. Subsequent lines pertaining to this node show the connectivity. On the left is the port number of the current node. On the right is the peer node (node at other end of link). It is identified in quotes with nodetype followed by - followed by NodeGUID with the port number in square brackets. Further on the right is a comment (#). What follows the comment is dependent on the node type. If it it a switch node, it is followed by the NodeDescription in quotes and the LID of the peer node. If it is a CA or router node, it is followed by the local LID and LMC and then followed by the NodeDescription in quotes and the LID of the peer node. The active link width and speed are then appended to the end of this output line. An example of this is: :: # # Topology file: generated on Tue Jun 5 14:15:10 2007 # # Max of 3 hops discovered # Initiated from node 0008f10403960558 port 0008f10403960559 Non-Chassis Nodes vendid=0x8f1 devid=0x5a06 sysimgguid=0x5442ba00003000 switchguid=0x5442ba00003080(5442ba00003080) Switch 24 "S-005442ba00003080" # "ISR9024 Voltaire" base port 0 lid 6 lmc 0 [22] "H-0008f10403961354"[1](8f10403961355) # "MT23108 InfiniHost Mellanox Technologies" lid 4 4xSDR [10] "S-0008f10400410015"[1] # "SW-6IB4 Voltaire" lid 3 4xSDR [8] "H-0008f10403960558"[2](8f1040396055a) # "MT23108 InfiniHost Mellanox Technologies" lid 14 4xSDR [6] "S-0008f10400410015"[3] # "SW-6IB4 Voltaire" lid 3 4xSDR [12] "H-0008f10403960558"[1](8f10403960559) # "MT23108 InfiniHost Mellanox Technologies" lid 10 4xSDR vendid=0x8f1 devid=0x5a05 switchguid=0x8f10400410015(8f10400410015) Switch 8 "S-0008f10400410015" # "SW-6IB4 Voltaire" base port 0 lid 3 lmc 0 [6] "H-0008f10403960984"[1](8f10403960985) # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR [4] "H-005442b100004900"[1](5442b100004901) # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR [1] "S-005442ba00003080"[10] # "ISR9024 Voltaire" lid 6 1xSDR [3] "S-005442ba00003080"[6] # "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960984 Ca 2 "H-0008f10403960984" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403960985) "S-0008f10400410015"[6] # lid 16 lmc 1 "SW-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x5442b100004900 Ca 2 "H-005442b100004900" # "MT23108 InfiniHost Mellanox Technologies" [1](5442b100004901) "S-0008f10400410015"[4] # lid 12 lmc 1 "SW-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403961354 Ca 2 "H-0008f10403961354" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403961355) "S-005442ba00003080"[22] # lid 4 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960558 Ca 2 "H-0008f10403960558" # "MT23108 InfiniHost Mellanox Technologies" [2](8f1040396055a) "S-005442ba00003080"[8] # lid 14 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR [1](8f10403960559) "S-005442ba00003080"[12] # lid 10 lmc 1 "ISR9024 Voltaire" lid 6 1xSDR When grouping is used, IB nodes are organized into chassis which are numbered. Nodes which cannot be determined to be in a chassis are displayed as "Non-Chassis Nodes". External ports are also shown on the connectivity lines. infiniband-diags-1.6.1/doc/rst/common/opt_load-cache.rst0000644013161601316160000000036312003563134020100 00000000000000.. Define the common option load-cache **--load-cache ** Load and use the cached ibnetdiscover data stored in the specified filename. May be useful for outputting and learning about other fabrics or a previous state of a fabric. infiniband-diags-1.6.1/doc/rst/common/opt_e.rst0000644013161601316160000000013312003563134016337 00000000000000.. Define the common option -e -e show send and receive errors (timeouts and others) infiniband-diags-1.6.1/doc/rst/common/opt_cache.rst0000644013161601316160000000026712003563134017166 00000000000000.. Define the common option cache **--cache ** Cache the ibnetdiscover network data in the specified filename. This cache may be used by other tools for later analysis. infiniband-diags-1.6.1/doc/rst/common/opt_z-config.rst0000644013161601316160000000022312003563134017627 00000000000000.. Define the common option -z **--config, -z ** Specify alternate config file. Default: @IBDIAG_CONFIG_PATH@/ibdiag.conf infiniband-diags-1.6.1/doc/rst/common/opt_d.rst0000644013161601316160000000020012003563134016331 00000000000000.. Define the common option -d -d raise the IB debugging level. May be used several times (-ddd or -d -d -d). infiniband-diags-1.6.1/doc/rst/common/opt_v.rst0000644013161601316160000000023112003563134016357 00000000000000.. Define the common option -v **-v, --verbose** increase the application verbosity level. May be used several times (-vv or -v -v -v) infiniband-diags-1.6.1/doc/rst/common/opt_G.rst0000644013161601316160000000013112003563134016277 00000000000000.. Define the common option -G **-G, --Guid** The address specified is a Port GUID infiniband-diags-1.6.1/doc/rst/common/opt_C.rst0000644013161601316160000000012612003563134016277 00000000000000.. Define the common option -C **-C, --Ca ** use the specified ca_name. infiniband-diags-1.6.1/doc/rst/common/opt_diff.rst0000644013161601316160000000061012003563134017023 00000000000000.. Define the common option diff **--diff ** Load cached ibnetdiscover data and do a diff comparison to the current network or another cache. A special diff output for ibnetdiscover output will be displayed showing differences between the old and current fabric. By default, the following are compared for differences: switches, channel adapters, routers, and port connections. infiniband-diags-1.6.1/doc/rst/common/opt_D.rst0000644013161601316160000000074112003563134016303 00000000000000.. Define the common option -D for Directed routes **-D, --Direct** The address specified is a directed route :: Examples: [options] -D [options] "0" # self port [options] -D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag '-P' or the port found through the automatic selection process.) infiniband-diags-1.6.1/doc/rst/common/opt_V.rst0000644013161601316160000000011612003563134016321 00000000000000.. Define the common option -V **-V, --version** show the version info. infiniband-diags-1.6.1/doc/rst/common/sec_node-name-map.rst0000644013161601316160000000275312003563134020513 00000000000000.. Common text to describe the node name map file. NODE NAME MAP FILE FORMAT ------------------------- The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup. This functionality is provided by the opensm-libs package. See **opensm(8)** for the file location for your installation. **Generically:** :: # comment "" **Example:** :: # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" infiniband-diags-1.6.1/doc/rst/common/sec_config-file.rst0000644013161601316160000000033112003563134020245 00000000000000.. Common text for the config file CONFIG FILE ----------- @IBDIAG_CONFIG_PATH@/ibdiag.conf A global config file is provided to set some of the common options for all tools. See supplied config file for details. infiniband-diags-1.6.1/doc/rst/common/opt_D_with_param.rst0000644013161601316160000000070312003563134020514 00000000000000.. Define the common option -D for Directed routes **-D, --Direct ** The address specified is a directed route :: Examples: -D "0" # self port -D "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag '-P' or the port found through the automatic selection process.) infiniband-diags-1.6.1/doc/rst/common/opt_P.rst0000644013161601316160000000013012003563134016307 00000000000000.. Define the common option -P **-P, --Port ** use the specified ca_port. infiniband-diags-1.6.1/doc/rst/common/opt_o-outstanding_smps.rst0000644013161601316160000000025512003563134021755 00000000000000.. Define the common option -z **--outstanding_smps, -o ** Specify the number of outstanding SMP's which should be issued during the scan Default: 2 infiniband-diags-1.6.1/doc/rst/common/opt_L.rst0000644013161601316160000000012012003563134016302 00000000000000.. Define the common option -L **-L, --Lid** The address specified is a LID infiniband-diags-1.6.1/doc/rst/common/opt_node_name_map.rst0000644013161601316160000000027212003563134020701 00000000000000.. Define the common option --node-name-map **--node-name-map ** Specify a node name map. This file maps GUIDs to more user friendly names. See FILES section. infiniband-diags-1.6.1/doc/rst/common/sec_portselection.rst0000644013161601316160000000150212003563134020756 00000000000000.. Explanation of local port selection Local port Selection -------------------- Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria: 1. the first port that is ACTIVE. 2. if not found, the first port that is UP (physical link up). If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. For example: :: ibaddr # use the first port (criteria #1 above) ibaddr -C mthca1 # pick the best port from "mthca1" only. ibaddr -P 2 # use the second (active/up) port from the first available IB device. ibaddr -C mthca0 -P 2 # use the specified port only. infiniband-diags-1.6.1/doc/rst/common/opt_K.rst0000644013161601316160000000017212003563134016310 00000000000000.. Define the common option -K **-K, --show_keys** show security keys (mkey, smkey, etc.) associated with the request. infiniband-diags-1.6.1/doc/rst/common/opt_diffcheck.rst0000644013161601316160000000115412003563134020025 00000000000000.. Define the common option diffcheck **--diffcheck ** Specify what diff checks should be done in the **--diff** option above. Comma separate multiple diff check key(s). The available diff checks are: **sw = switches**, **ca = channel adapters**, **router** = routers, **port** = port connections, **lid** = lids, **nodedesc** = node descriptions. Note that **port**, **lid**, and **nodedesc** are checked only for the node types that are specified (e.g. **sw**, **ca**, **router**). If **port** is specified alongside **lid** or **nodedesc**, remote port lids and node descriptions will also be compared. infiniband-diags-1.6.1/doc/rst/common/opt_t.rst0000644013161601316160000000016512003563134016363 00000000000000.. Define the common option -t **-t, --timeout ** override the default timeout for the solicited mads. infiniband-diags-1.6.1/doc/rst/common/opt_s.rst0000644013161601316160000000015512003563134016361 00000000000000.. Define the common option -s **-s, --sm_port ** use 'smlid' as the target lid for SA queries. infiniband-diags-1.6.1/doc/rst/common/opt_h.rst0000644013161601316160000000011412003563134016341 00000000000000.. Define the common option -h **-h, --help** show the usage message infiniband-diags-1.6.1/doc/rst/infiniband-diags.8.in.rst0000644013161601316160000000725312005565227017723 00000000000000================ INFINIBAND-DIAGS ================ :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics ---------------------------------- Diagnostics for InfiniBand Fabrics ---------------------------------- DESCRIPTION =========== infiniband-diags is a set of utilities designed to help configure, debug, and maintain infiniband fabrics. Many tools and utilities are provided. Some with similar functionality. The base utilities use directed route MAD's to perform their operations. They may therefore work even in unconfigured subnets. Other, higher level utilities, require LID routed MAD's and to some extent SA/SM access. THE USE OF SMPs (QP0) ===================== Many of the tools in this package rely on the use of SMPs via QP0 to acquire data directly from the SMA. While this mode of operation is not technically in compliance with the InfiniBand specification, practical experience has found that this level of diagnostics is valuable when working with a fabric which is broken or only partially configured. For this reason many of these tools may require the use of an MKey or operation from Virtual Machines may be restricted for security reasons. COMMON OPTIONS ============== Most OpenIB diagnostics take some of the following common flags. The exact list of supported flags per utility can be found in the documentation for those commands. Addressing Flags ---------------- The -D and -G option have two forms: .. include:: common/opt_D.rst .. include:: common/opt_D_with_param.rst .. include:: common/opt_G.rst .. include:: common/opt_G_with_param.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_o-outstanding_smps.rst .. include:: common/opt_node_name_map.rst .. include:: common/opt_z-config.rst COMMON FILES ============ The following config files are common amongst many of the utilities. .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst .. include:: common/sec_topology-file.rst Utilities list ============== Basic fabric conectivity ------------------------ See: ibnetdiscover, iblinkinfo Node information ---------------- See: ibnodes, ibswitches, ibhosts, ibrouters Port information ---------------- See: ibportstate, ibaddr Switch Forwarding Table info ---------------------------- See: ibtracert, ibroute, dump_lfts, dump_mfts, check_lft_balance, ibfindnodesusing Peformance counters ------------------- See: ibqueryerrors, perfquery Local HCA info -------------- See: ibstat, ibstatus Connectivity check ------------------ See: ibping, ibsysstat Low level query tools --------------------- See: smpquery, smpdump, saquery, sminfo Fabric verification tools ------------------------- See: ibidsverify Backwards compatibility scripts =============================== The following scripts have been identified as redundant and/or lower performing as compared to the above scripts. They are provided as legacy scripts when --enable-compat-utils is specified at build time. ibcheckerrors, ibclearcounters, ibclearerrors, ibdatacounters ibchecknet, ibchecknode, ibcheckport, ibcheckportstate, ibcheckportwidth, ibcheckstate, ibcheckwidth, ibswportwatch, ibprintca, ibprintrt, ibprintswitch, set_nodedesc.sh AUTHORS ======= Ira Weiny infiniband-diags-1.6.1/doc/rst/ibswitches.8.in.rst0000644013161601316160000000163712003563134016672 00000000000000========== IBSWITCHES ========== ---------------------------------------- show InfiniBand switch nodes in topology ---------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibswitches [options] [] DESCRIPTION =========== ibswitches is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the switch nodes. OPTIONS ======= .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/opt_t.rst .. include:: common/opt_h.rst .. include:: common/opt_z-config.rst .. include:: common/sec_portselection.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst SEE ALSO ======== ibnetdiscover(8) DEPENDENCIES ============ ibnetdiscover, ibnetdiscover format AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/perfquery.8.in.rst0000644013161601316160000001133012003563134016537 00000000000000========= PERFQUERY ========= :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics ----------------------------------------------- query InfiniBand port counters on a single port ----------------------------------------------- SYNOPSIS ======== perfquery [options] [ [[port] [reset_mask]]] DESCRIPTION =========== perfquery uses PerfMgt GMPs to obtain the PortCounters (basic performance and error counters), PortExtendedCounters, PortXmitDataSL, PortRcvDataSL, PortRcvErrorDetails, PortXmitDiscardDetails, PortExtendedSpeedsCounters, or PortSamplesControl from the PMA at the node/port specified. Optionally shows aggregated counters for all ports of node. Finally it can, reset after read, or just reset the counters. Note: In PortCounters, PortCountersExtended, PortXmitDataSL, and PortRcvDataSL, components that represent Data (e.g. PortXmitData and PortRcvData) indicate octets divided by 4 rather than just octets. Note: Inputting a port of 255 indicates an operation be performed on all ports. OPTIONS ======= **-x, --extended** show extended port counters rather than (basic) port counters. Note that extended port counters attribute is optional. **-X, --xmtsl** show transmit data SL counter. This is an optional counter for QoS. **-S, --rcvsl** show receive data SL counter. This is an optional counter for QoS. **-D, --xmtdisc** show transmit discard details. This is an optional counter. **-E, --rcverr** show receive error details. This is an optional counter. **-D, --xmtdisc** show transmit discard details. This is an optional counter. **-T, --extended_speeds** show extended speeds port counters. This is an optional counter. **--oprcvcounters** show Rcv Counters per Op code. This is an optional counter. **--flowctlcounters** show flow control counters. This is an optional counter. **--vloppackets** show packets received per Op code per VL. This is an optional counter. **--vlopdata** show data received per Op code per VL. This is an optional counter. **--vlxmitflowctlerrors** show flow control update errors per VL. This is an optional counter. **--vlxmitcounters** show ticks waiting to transmit counters per VL. This is an optional counter. **--swportvlcong** show sw port VL congestion. This is an optional counter. **--rcvcc** show Rcv congestion control counters. This is an optional counter. **--slrcvfecn** show SL Rcv FECN counters. This is an optional counter. **--slrcvbecn** show SL Rcv BECN counters. This is an optional counter. **--xmitcc** show Xmit congestion control counters. This is an optional counter. **--vlxmittimecc** show VL Xmit Time congestion control counters. This is an optional counter. **-c, --smplctl** show port samples control. **-a, --all_ports** show aggregated counters for all ports of the destination lid or reset all counters for all ports. If the destination lid does not support the AllPortSelect flag, all ports will be iterated through to emulate AllPortSelect behavior. **-l, --loop_ports** If all ports are selected by the user (either through the **-a** option or port 255) iterate through each port rather than doing than aggregate operation. **-r, --reset_after_read** reset counters after read **-R, --Reset_only** only reset counters Addressing Flags ---------------- .. include:: common/opt_G.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_y.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst EXAMPLES ======== :: perfquery # read local port performance counters perfquery 32 1 # read performance counters from lid 32, port 1 perfquery -x 32 1 # read extended performance counters from lid 32, port 1 perfquery -a 32 # read perf counters from lid 32, all ports perfquery -r 32 1 # read performance counters and reset perfquery -x -r 32 1 # read extended performance counters and reset perfquery -R 0x20 1 # reset performance counters of port 1 only perfquery -x -R 0x20 1 # reset extended performance counters of port 1 only perfquery -R -a 32 # reset performance counters of all ports perfquery -R 32 2 0x0fff # reset only error counters of port 2 perfquery -R 32 2 0xf000 # reset only non-error counters of port 2 AUTHOR ====== Hal Rosenstock < hal.rosenstock@gmail.com > infiniband-diags-1.6.1/doc/rst/ibidsverify.8.in.rst0000644013161601316160000000250612003563134017041 00000000000000=========== IBIDSVERIFY =========== :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics --------------------------------------------------- validate IB identifiers in subnet and report errors --------------------------------------------------- SYNOPSIS ======== ibidsverify.pl [-h] [-R] DESCRIPTION =========== ibidsverify.pl is a perl script which uses a full topology file that was created by ibnetdiscover, scans the network to validate the LIDs and GUIDs in the subnet. The validation consists of checking that there are no zero or duplicate identifiers. Finally, ibidsverify.pl will also reuse the cached ibnetdiscover output from some of the other diag tools which makes it a bit faster than running ibnetdiscover from scratch. OPTIONS ======= **-R** Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe the fabric has changed. **-C ** use the specified ca_name. **-P ** use the specified ca_port. EXIT STATUS =========== Exit status is 1 if errors are found, 0 otherwise. FILES ===== .. include:: common/sec_config-file.rst SEE ALSO ======== **ibnetdiscover(8)** AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibaddr.8.in.rst0000644013161601316160000000326012003563134015745 00000000000000====== IBADDR ====== ---------------------------- query InfiniBand address(es) ---------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibaddr [options] DESCRIPTION =========== Display the lid (and range) as well as the GID address of the port specified (by DR path, lid, or GUID) or the local port by default. Note: this utility can be used as simple address resolver. OPTIONS ======= **--gid_show, -g** show gid address only **--lid_show, -l** show lid range only **--Lid_show, -L** show lid range (in decimal) only Addressing Flags ---------------- .. include:: common/opt_D.rst .. include:: common/opt_G.rst .. include:: common/opt_s.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_y.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst EXAMPLES ======== :: ibaddr # local port\'s address ibaddr 32 # show lid range and gid of lid 32 ibaddr -G 0x8f1040023 # same but using guid address ibaddr -l 32 # show lid range only ibaddr -L 32 # show decimal lid range only ibaddr -g 32 # show gid address only SEE ALSO ======== **ibroute (8), ibtracert (8)** AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibportstate.8.in.rst0000644013161601316160000000772212003563134017067 00000000000000=========== IBPORTSTATE =========== ----------------------------------------------------------------- handle port (physical) state and link speed of an InfiniBand port ----------------------------------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics SYNOPSIS ======== ibportstate [options] [] DESCRIPTION =========== ibportstate allows the port state and port physical state of an IB port to be queried (in addition to link width and speed being validated relative to the peer port when the port queried is a switch port), or a switch port to be disabled, enabled, or reset. It also allows the link speed/width enabled on any IB port to be adjusted. OPTIONS ======= **** Supported ops: enable, disable, reset, speed, espeed, fdr10, width, query, down, arm, active, vls, mtu, lid, smlid, lmc, mkey, mkeylease, mkeyprot (Default is query) **enable, disable, and reset** are only allowed on switch ports (An error is indicated if attempted on CA or router ports) **speed and width** are allowed on any port **speed** values are the legal values for PortInfo:LinkSpeedEnabled (An error is indicated if PortInfo:LinkSpeedSupported does not support this setting) **espeed** is allowed on any port supporting extended link speeds **fdr10** is allowed on any port supporting fdr10 (An error is indicated if port's capability mask indicates extended link speeds are not supported or if PortInfo:LinkSpeedExtSupported does not support this setting) **width** values are legal values for PortInfo:LinkWidthEnabled (An error is indicated if PortInfo:LinkWidthSupported does not support this setting) (NOTE: Speed and width changes are not effected until the port goes through link renegotiation) **query** also validates port characteristics (link width, speed, espeed, and fdr10) based on the peer port. This checking is done when the port queried is a switch port as it relies on combined routing (an initial LID route with directed routing to the peer) which can only be done on a switch. This peer port validation feature of query op requires LID routing to be functioning in the subnet. **mkey, mkeylease, and mkeyprot** are only allowed on CAs, routers, or switch port 0 (An error is generated if attempted on external switch ports). Hexadecimal and octal mkeys may be specified by prepending the key with '0x' or '0', respectively. If a non-numeric value (like 'x') is specified for the mkey, then ibportstate will prompt for a value. Addressing Flags ---------------- .. include:: common/opt_L.rst .. include:: common/opt_G.rst .. include:: common/opt_D.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst .. include:: common/opt_t.rst .. include:: common/opt_y.rst Debugging flags --------------- .. include:: common/opt_h.rst .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_K.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst FILES ===== .. include:: common/sec_config-file.rst EXAMPLES ======== :: ibportstate 3 1 disable # by lid ibportstate -G 0x2C9000100D051 1 enable # by guid ibportstate -D 0 1 # (query) by direct route ibportstate 3 1 reset # by lid ibportstate 3 1 speed 1 # by lid ibportstate 3 1 width 1 # by lid ibportstate -D 0 1 lid 0x1234 arm # by direct route AUTHOR ====== Hal Rosenstock < hal.rosenstock@gmail.com > infiniband-diags-1.6.1/doc/rst/smpdump.8.in.rst0000644013161601316160000000323312003563134016205 00000000000000======= SMPDUMP ======= :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics -------------------------------------------- dump InfiniBand subnet management attributes -------------------------------------------- SYNOPSIS ======== smpdump [options] [attribute_modifier] DESCRIPTION =========== smpdump is a general purpose SMP utility which gets SM attributes from a specified SMA. The result is dumped in hex by default. OPTIONS ======= **dlid|drpath** LID or DR path to SMA **attribute** IBA attribute ID for SM attribute **attribute_modifier** IBA modifier for SM attribute **-s, --string** Print strings in packet if possible Addressing Flags ---------------- .. include:: common/opt_D.rst .. include:: common/opt_L.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst EXAMPLES ======== Direct Routed Examples :: smpdump -D 0,1,2,3,5 16 # NODE DESC smpdump -D 0,1,2 0x15 2 # PORT INFO, port 2 LID Routed Examples :: smpdump 3 0x15 2 # PORT INFO, lid 3 port 2 smpdump 0xa0 0x11 # NODE INFO, lid 0xa0 SEE ALSO ======== smpquery (8) AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibrouters.8.in.rst0000644013161601316160000000163412003563134016541 00000000000000========= IBROUTERS ========= ---------------------------------------- show InfiniBand router nodes in topology ---------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibrouters [options] [] DESCRIPTION =========== ibrouters is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the router nodes. OPTIONS ======= .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/opt_t.rst .. include:: common/opt_h.rst .. include:: common/opt_z-config.rst .. include:: common/sec_portselection.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst SEE ALSO ======== ibnetdiscover(8) DEPENDENCIES ============ ibnetdiscover, ibnetdiscover format AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibccquery.8.in.rst0000644013161601316160000000344612003563134016514 00000000000000========= IBCCQUERY ========= -------------------------------------- query congestion control settings/info -------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibccquery [common_options] [-c cckey] [port] DESCRIPTION =========== ibccquery support the querying of settings and other information related to congestion control. OPTIONS ======= Current supported operations and their parameters: CongestionInfo (CI) CongestionKeyInfo (CK) CongestionLog (CL) SwitchCongestionSetting (SS) SwitchPortCongestionSetting (SP) [] CACongestionSetting (CS) CongestionControlTable (CT) Timestamp (TI) **--cckey, -c ** Specify a congestion control (CC) key. If none is specified, a key of 0 is used. Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Addressing Flags ---------------- .. include:: common/opt_G.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_y.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst EXAMPLES ======== :: ibccquery CongestionInfo 3 # Congestion Info by lid ibccquery SwitchPortCongestionSetting 3 # Query all Switch Port Congestion Settings ibccquery SwitchPortCongestionSetting 3 1 # Query Switch Port Congestion Setting for port 1 AUTHOR ====== Albert Chu < chu11@llnl.gov > infiniband-diags-1.6.1/doc/rst/sminfo.8.in.rst0000644013161601316160000000343112003563134016013 00000000000000====== SMINFO ====== :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics --------------------------------- query InfiniBand SMInfo attribute --------------------------------- SYNOPSIS ======== sminfo [options] sm_lid | sm_dr_path [modifier] DESCRIPTION =========== Optionally set and display the output of a sminfo query in human readable format. The target SM is the one listed in the local port info, or the SM specified by the optional SM lid or by the SM direct routed path. Note: using sminfo for any purposes other then simple query may be very dangerous, and may result in a malfunction of the target SM. OPTIONS ======= **-s, --state ** set SM state 0 not active 1 discovering 2 standby 3 master **-p, --priority ** set priority (0-15) **-a, --activity ** set activity count Addressing Flags ---------------- .. include:: common/opt_D.rst .. include:: common/opt_G.rst .. include:: common/opt_L.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_y.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst EXAMPLES ======== :: sminfo # local port\'s sminfo sminfo 32 # show sminfo of lid 32 sminfo -G 0x8f1040023 # same but using guid address SEE ALSO ======== smpdump (8) AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/iblinkinfo.8.in.rst0000644013161601316160000000615112005565227016655 00000000000000========== IBLINKINFO ========== -------------------------------------------- report link info for all links in the fabric -------------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== iblinkinfo DESCRIPTION =========== iblinkinfo reports link info for each port in an IB fabric, node by node. Optionally, iblinkinfo can do partial scans and limit its output to parts of a fabric. OPTIONS ======= **--down, -d** Print only nodes which have a port in the "Down" state. **--line, -l** Print all information for each link on one line. Default is to print a header with the node information and then a list for each port (useful for grep'ing output). **--additional, -p** Print additional port settings (,,) **--switches-only** Show only switches in output. **--cas-only** Show only CAs in output. Partial Scan flags ------------------ The node to start a partial scan can be specified with the following addresses. .. include:: common/opt_G_with_param.rst .. include:: common/opt_D_with_param.rst **Note:** For switches results are printed for all ports not just switch port 0. **--switch, -S ** same as "-G". (provided only for backward compatibility) How much of the scan to be printed can be controled with the following. **--all, -a** Print all nodes found in a partial fabric scan. Normally a partial fabric scan will return only the node specified. This option will print the other nodes found as well. **--hops, -n ** Specify the number of hops away from a specified node to scan. This is useful to expand a partial fabric scan beyond the node specified. Cache File flags ---------------- .. include:: common/opt_load-cache.rst .. include:: common/opt_diff.rst .. include:: common/opt_diffcheck.rst **--filterdownports ** Filter downports indicated in a ibnetdiscover cache. If a port was previously indicated as down in the specified cache, and is still down, do not output it in the resulting output. This option may be particularly useful for environments where switches are not fully populated, thus much of the default iblinkinfo info is considered unuseful. See **ibnetdiscover** for information on caching ibnetdiscover output. Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst .. include:: common/opt_o-outstanding_smps.rst .. include:: common/opt_node_name_map.rst .. include:: common/opt_t.rst .. include:: common/opt_y.rst Debugging flags --------------- .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst **-R** (This option is obsolete and does nothing) EXIT STATUS =========== 0 on success, -1 on failure to scan the fabric, 1 if check mode is used and inconsistencies are found. FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst AUTHOR ====== Ira Weiny < weiny2@llnl.gov > infiniband-diags-1.6.1/doc/rst/ibfindnodesusing.8.in.rst0000644013161601316160000000237112003563134020054 00000000000000================ IBFINDNODESUSING ================ :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics ------------------------------------------------------------------------------- find a list of end nodes which are routed through the specified switch and port ------------------------------------------------------------------------------- SYNOPSIS ======== ibfindnodesusing.pl [options] DESCRIPTION =========== ibfindnodesusing.pl uses ibroute and detects the current nodes which are routed through both directions of the link specified. The link is specified by one switch port end; the script finds the remote end automatically. OPTIONS ======= **-h** show help **-R** Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed. **-C ** use the specified ca_name. **-P ** use the specified ca_port. FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst AUTHOR ====== Ira Weiny < weiny2@llnl.gov > infiniband-diags-1.6.1/doc/rst/ibstat.8.in.rst0000644013161601316160000000271512003563134016012 00000000000000====== IBSTAT ====== :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics ------------------------------------------ query basic status of InfiniBand device(s) ------------------------------------------ SYNOPSIS ======== ibstat [options] [portnum] DESCRIPTION =========== ibstat is a binary which displays basic information obtained from the local IB driver. Output includes LID, SMLID, port state, link width active, and port physical state. It is similar to the ibstatus utility but implemented as a binary rather than a script. It has options to list CAs and/or ports and displays more information than ibstatus. OPTIONS ======= **-l, --list_of_cas** list all IB devices **-s, --short** short output **-p, --port_list** show port list **ca_name** InfiniBand device name **portnum** port number of InfiniBand device Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst EXAMPLES ======== :: ibstat # display status of all ports on all IB devices ibstat -l # list all IB devices ibstat -p # show port guids ibstat mthca0 2 # show status of port 2 of 'mthca0' SEE ALSO ======== ibstatus (8) AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibping.8.in.rst0000644013161601316160000000264012003563134015771 00000000000000====== IBPING ====== -------------------------- ping an InfiniBand address -------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics SYNOPSIS ======== ibping [options] DESCRIPTION =========== ibping uses vendor mads to validate connectivity between IB nodes. On exit, (IP) ping like output is show. ibping is run as client/server. Default is to run as client. Note also that a default ping server is implemented within the kernel. OPTIONS ======= **-c, --count** stop after count packets **-f, --flood** flood destination: send packets back to back without delay **-o, --oui** use specified OUI number to multiplex vendor mads **-S, --Server** start in server mode (do not return) Addressing Flags ---------------- .. include:: common/opt_L.rst .. include:: common/opt_G.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst .. include:: common/opt_t.rst Debugging flags --------------- .. include:: common/opt_h.rst .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst FILES ===== .. include:: common/sec_config-file.rst AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/saquery.8.in.rst0000644013161601316160000001127212003563134016213 00000000000000======= SAQUERY ======= :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics ------------------------------------------------- query InfiniBand subnet administration attributes ------------------------------------------------- SYNOPSIS ======== saquery [options] [ | | ] DESCRIPTION =========== saquery issues the selected SA query. Node records are queried by default. OPTIONS ======= **-p** get PathRecord info **-N** get NodeRecord info **-D, --list** get NodeDescriptions of CAs only **-S** get ServiceRecord info **-I** get InformInfoRecord (subscription) info **-L** return the Lids of the name specified **-l** return the unique Lid of the name specified **-G** return the Guids of the name specified **-O** return the name for the Lid specified **-U** return the name for the Guid specified **-c** get the SA's class port info **-s** return the PortInfoRecords with isSM or isSMdisabled capability mask bit on **-g** get multicast group info **-m** get multicast member info. If a group is specified, limit the output to the group specified and print one line containing only the GUID and node description for each entry. Example: saquery -m 0xc000 **-x** get LinkRecord info **--src-to-dst ** get a PathRecord for where src and dst are either node names or LIDs **--sgid-to-dgid ** get a PathRecord for **sgid** to **dgid** where both GIDs are in an IPv6 format acceptable to **inet_pton (3)** **--smkey ** use SM_Key value for the query. Will be used only with "trusted" queries. If non-numeric value (like 'x') is specified then saquery will prompt for a value. Default (when not specified here or in @IBDIAG_CONFIG_PATH@/ibdiag.conf) is to use SM_Key == 0 (or \"untrusted\") .. include:: common/opt_K.rst **--slid ** Source LID (PathRecord) **--dlid ** Destination LID (PathRecord) **--mlid ** Multicast LID (MCMemberRecord) **--sgid ** Source GID (IPv6 format) (PathRecord) **--dgid ** Destination GID (IPv6 format) (PathRecord) **--gid ** Port GID (MCMemberRecord) **--mgid ** Multicast GID (MCMemberRecord) **--reversible** Reversible path (PathRecord) **--numb_path** Number of paths (PathRecord) **--pkey** P_Key (PathRecord, MCMemberRecord). If non-numeric value (like 'x') is specified then saquery will prompt for a value **--qos_class** QoS Class (PathRecord) **--sl** Service level (PathRecord, MCMemberRecord) **--mtu** MTU and selector (PathRecord, MCMemberRecord) **--rate** Rate and selector (PathRecord, MCMemberRecord) **--pkt_lifetime** Packet lifetime and selector (PathRecord, MCMemberRecord) **--qkey** Q_Key (MCMemberRecord). If non-numeric value (like 'x') is specified then saquery will prompt for a value **--tclass** Traffic Class (PathRecord, MCMemberRecord) **--flow_label** Flow Label (PathRecord, MCMemberRecord) **--hop_limit** Hop limit (PathRecord, MCMemberRecord) **--scope** Scope (MCMemberRecord) **--join_state** Join state (MCMemberRecord) **--proxy_join** Proxy join (MCMemberRecord) Supported query names (and aliases): :: ClassPortInfo (CPI) NodeRecord (NR) [lid] PortInfoRecord (PIR) [[lid]/[port]/[options]] SL2VLTableRecord (SL2VL) [[lid]/[in_port]/[out_port]] PKeyTableRecord (PKTR) [[lid]/[port]/[block]] VLArbitrationTableRecord (VLAR) [[lid]/[port]/[block]] InformInfoRecord (IIR) LinkRecord (LR) [[from_lid]/[from_port]] [[to_lid]/[to_port]] ServiceRecord (SR) PathRecord (PR) MCMemberRecord (MCMR) LFTRecord (LFTR) [[lid]/[block]] MFTRecord (MFTR) [[mlid]/[position]/[block]] GUIDInfoRecord (GIR) [[lid]/[block]] Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_o-outstanding_smps.rst .. include:: common/opt_node_name_map.rst .. include:: common/opt_z-config.rst COMMON FILES ============ .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst DEPENDENCIES ============ OpenSM (or other running SM/SA), libosmcomp, libibumad, libibmad AUTHORS ======= Ira Weiny < weiny2@llnl.gov > Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibroute.8.in.rst0000644013161601316160000000460612003563134016176 00000000000000======= IBROUTE ======= :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics ----------------------------------------- query InfiniBand switch forwarding tables ----------------------------------------- SYNOPSIS ======== ibroute [options] [ [ []]] DESCRIPTION =========== ibroute uses SMPs to display the forwarding tables (unicast (LinearForwardingTable or LFT) or multicast (MulticastForwardingTable or MFT)) for the specified switch LID and the optional lid (mlid) range. The default range is all valid entries in the range 1...FDBTop. OPTIONS ======= **-a, --all** show all lids in range, even invalid entries **-n, --no_dests** do not try to resolve destinations **-M, --Multicast** show multicast forwarding tables In this case, the range parameters are specifying the mlid range. Addressing Flags ---------------- .. include:: common/opt_D.rst .. include:: common/opt_G.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_y.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst EXAMPLES ======== Unicast examples :: ibroute 4 # dump all lids with valid out ports of switch with lid 4 ibroute -a 4 # same, but dump all lids, even with invalid out ports ibroute -n 4 # simple dump format - no destination resolution ibroute 4 10 # dump lids starting from 10 (up to FDBTop) ibroute 4 0x10 0x20 # dump lid range ibroute -G 0x08f1040023 # resolve switch by GUID ibroute -D 0,1 # resolve switch by direct path Multicast examples :: ibroute -M 4 # dump all non empty mlids of switch with lid 4 ibroute -M 4 0xc010 0xc020 # same, but with range ibroute -M -n 4 # simple dump format SEE ALSO ======== ibtracert (8) AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibstatus.8.in.rst0000644013161601316160000000166712003563134016367 00000000000000======== IBSTATUS ======== :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics ------------------------------------------ query basic status of InfiniBand device(s) ------------------------------------------ SYNOPSIS ======== ibstatus [\-h] [devname[:port]]... DESCRIPTION =========== ibstatus is a script which displays basic information obtained from the local IB driver. Output includes LID, SMLID, port state, link width active, and port physical state. OPTIONS ======= .. include:: common/opt_h.rst **devname** InfiniBand device name **portnum** port number of InfiniBand device EXAMPLES ======== :: ibstatus # display status of all IB ports ibstatus mthca1 # status of mthca1 ports ibstatus mthca1:1 mthca0:2 # show status of specified ports SEE ALSO ======== **ibstat (8)** AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/vendstat.8.in.rst0000644013161601316160000000431212003563134016347 00000000000000======== VENDSTAT ======== :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics ------------------------------------------ query InfiniBand vendor specific functions ------------------------------------------ SYNOPSIS ======== vendstat [options] DESCRIPTION =========== vendstat uses vendor specific MADs to access beyond the IB spec vendor specific functionality. Currently, there is support for Mellanox InfiniSwitch-III (IS3) and InfiniSwitch-IV (IS4). OPTIONS ======= **-N** show IS3 or IS4 general information. **-w** show IS3 port xmit wait counters. **-i** show IS4 counter group info. **-c ** configure IS4 counter groups. Configure IS4 counter groups 0 and 1. Such configuration is not persistent across IS4 reboot. First number is for counter group 0 and second is for counter group 1. Group 0 counter config values: :: 0 - PortXmitDataSL0-7 1 - PortXmitDataSL8-15 2 - PortRcvDataSL0-7 Group 1 counter config values: :: 1 - PortXmitDataSL8-15 2 - PortRcvDataSL0-7 8 - PortRcvDataSL8-15 **-R, --Read ** Read configuration space record at addr **-W, --Write ** Write configuration space record at addr Addressing Flags ---------------- .. include:: common/opt_G.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst EXAMPLES ======== :: vendstat -N 6 # read IS3 or IS4 general information vendstat -w 6 # read IS3 port xmit wait counters vendstat -i 6 12 # read IS4 port 12 counter group info vendstat -c 0,1 6 12 # configure IS4 port 12 counter groups for PortXmitDataSL vendstat -c 2,8 6 12 # configure IS4 port 12 counter groups for PortRcvDataSL AUTHOR ====== Hal Rosenstock < hal.rosenstock@gmail.com > infiniband-diags-1.6.1/doc/rst/ibnodes.8.in.rst0000644013161601316160000000161512003563134016145 00000000000000======= IBNODES ======= --------------------------------- show InfiniBand nodes in topology --------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibnodes [options] [] DESCRIPTION =========== ibnodes is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the IB nodes (CAs and switches). OPTIONS ======= .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/opt_t.rst .. include:: common/opt_h.rst .. include:: common/opt_z-config.rst .. include:: common/sec_portselection.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst SEE ALSO ======== ibnetdiscover(8) DEPENDENCIES ============ ibnetdiscover, ibnetdiscover format AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibsysstat.8.in.rst0000644013161601316160000000277212003563134016554 00000000000000========= IBSYSSTAT ========= :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics -------------------------------------- system status on an InfiniBand address -------------------------------------- SYNOPSIS ======== ibsysstat [options] [] DESCRIPTION =========== ibsysstat uses vendor mads to validate connectivity between IB nodes and obtain other information about the IB node. ibsysstat is run as client/server. Default is to run as client. OPTIONS ======= Current supported operations: :: ping \- verify connectivity to server (default) host \- obtain host information from server cpu \- obtain cpu information from server **-o, --oui** use specified OUI number to multiplex vendor mads **-S, --Server** start in server mode (do not return) Addressing Flags ---------------- .. include:: common/opt_G.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibhosts.8.in.rst0000644013161601316160000000160712003563134016176 00000000000000======= IBHOSTS ======= -------------------------------------- show InfiniBand host nodes in topology -------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibhosts [options] [] DESCRIPTION =========== ibhosts is a script which either walks the IB subnet topology or uses an already saved topology file and extracts the CA nodes. OPTIONS ======= .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/opt_t.rst .. include:: common/opt_h.rst .. include:: common/opt_z-config.rst .. include:: common/sec_portselection.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst SEE ALSO ======== ibnetdiscover(8) DEPENDENCIES ============ ibnetdiscover, ibnetdiscover format AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibclearcounters.8.in.rst0000644013161601316160000000153011750620675017716 00000000000000=============== IBCLEARCOUNTERS =============== :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics -------------------------------- clear port counters in IB subnet -------------------------------- SYNOPSIS ======== ibclearcounters [\-h] [ | \-C ca_name \-P ca_port \-t(imeout) timeout_ms] DESCRIPTION =========== ibclearcounters is a script that clears the PMA port counters by either walking the IB subnet topology or using an already saved topology file. OPTIONS ======= Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_t.rst SEE ALSO ======== **ibnetdiscover(8), perfquery(8)** AUTHOR ====== Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/dump_lfts.8.in.rst0000644013161601316160000000236512003563134016522 00000000000000============ DUMP_LFTS.SH ============ ----------------------------------------- dump InfiniBand unicast forwarding tables ----------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== dump_lfts.sh [-h] [-D] [-C ca_name] [-P ca_port] [-t(imeout) timeout_ms] [>/path/to/dump-file] DESCRIPTION =========== dump_lfts.sh is a script which dumps the InfiniBand unciast forwarding tables (MFTs) in the switch nodes in the subnet. The dump file format is compatible with loading into OpenSM using the -R file -U /path/to/dump-file syntax. OPTIONS ======= **-D** dump forwarding tables using direct routed rather than LID routed SMPs **-h** show help Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst .. include:: common/opt_t.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst SEE ALSO ======== **dump_mfts(8), ibroute(8), ibswitches(8), opensm(8)** AUTHORS ======= Sasha Khapyorsky < sashak@voltaire.com > Hal Rosenstock < halr@voltaire.com > infiniband-diags-1.6.1/doc/rst/ibccconfig.8.in.rst0000644013161601316160000000517012003563134016610 00000000000000========== IBCCCONFIG ========== ------------------------------------- configure congestion control settings ------------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibccconfig [common_options] [-c cckey] [port] DESCRIPTION =========== **ibccconfig** supports the configuration of congestion control settings on switches and HCAs. **WARNING -- You should understand what you are doing before using this tool. Misuse of this tool could result in a broken fabric.** OPTIONS ======= Current supported operations and their parameters: CongestionKeyInfo (CK) SwitchCongestionSetting (SS) SwitchPortCongestionSetting (SP) CACongestionSetting (CS) CongestionControlTable (CT) ... **--cckey, -c, ** Specify a congestion control (CC) key. If none is specified, a key of 0 is used. Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Addressing Flags ---------------- .. include:: common/opt_G.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_y.rst .. include:: common/opt_z-config.rst EXAMPLES ======== :: ibccconfig SwitchCongestionSetting 2 0x1F 0x1FFFFFFFFF 0x0 0xF 8 0 0:0 1 # Configure Switch Congestion Settings ibccconfig CACongestionSetting 1 0 0x3 150 1 0 0 # Configure CA Congestion Settings to SL 0 and SL 1 ibccconfig CACongestionSetting 1 0 0x4 200 1 0 0 # Configure CA Congestion Settings to SL 2 ibccconfig CongestionControlTable 1 63 0 0:0 0:1 ... # Configure first block of Congestion Control Table ibccconfig CongestionControlTable 1 127 0 0:64 0:65 ... # Configure second block of Congestion Control Table FILES ===== .. include:: common/sec_config-file.rst AUTHOR ====== Albert Chu < chu11@llnl.gov > infiniband-diags-1.6.1/doc/rst/ibqueryerrors.8.in.rst.orig0000644013161601316160000000671511752615075020420 00000000000000============= IBQUERYERRORS ============= --------------------------------- query and report IB port counters --------------------------------- :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: OpenIB Diagnostics SYNOPSIS ======== ibqueryerrors [options] DESCRIPTION =========== The default behavior is to report the port error counters which exceed a threshold for each port in the fabric. The default threshold is zero (0). Error fields can also be suppressed entirely. In addition to reporting errors on every port. ibqueryerrors can report the port transmit and receive data as well as report full link information to the remote port if available. OPTIONS ======= **-s, --suppress ** Suppress the errors listed in the comma separated list provided. **-c, --suppress-common** Suppress some of the common "side effect" counters. These counters usually do not indicate an error condition and can be usually be safely ignored. **-r, --report-port** Report the port information. This includes LID, port, external port (if applicable), link speed setting, remote GUID, remote port, remote external port (if applicable), and remote node description information. **--data** Include the optional transmit and receive data counters. **--threshold-file ** Specify an alternate threshold file. The default is @IBDIAG_CONFIG_PATH@/error_thresholds **--switch** print data for switch's only **--ca** print data for CA's only **--router** print data for routers only **--clear-errors -k** Clear error counters after read. **--clear-counts -K** Clear data counters after read. **CAUTION** clearing data or error counters will occur regardless of if they are printed or not. See **--counters** and **--data** for details on controling which counters are printed. **--details** include receive error and transmit discard details **--counters** print data counters only Partial Scan flags ------------------ The node to start a partial scan can be specified with the following addresses. .. include:: common/opt_G_with_param.rst .. include:: common/opt_D_with_param.rst **Note:** For switches results are printed for all ports not just switch port 0. **-S ** same as "-G". (provided only for backward compatibility) Cache File flags ---------------- .. include:: common/opt_load-cache.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Configuration flags ------------------- .. include:: common/opt_z-config.rst .. include:: common/opt_o-outstanding_smps.rst .. include:: common/opt_node_name_map.rst .. include:: common/opt_t.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst **-R** (This option is obsolete and does nothing) EXIT STATUS =========== **-1** if scan fails. **0** if scan succeeds without errors beyond thresholds **1** if errors are found beyond thresholds FILES ===== ERROR THRESHOLD --------------- @IBDIAG_CONFIG_PATH@/error_thresholds Define threshold values for errors. File format is simple "name=val". Comments begin with '#' **Example:** :: # Define thresholds for error counters SymbolErrorCounter=10 LinkErrorRecoveryCounter=10 VL15Dropped=100 .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst AUTHOR ====== Ira Weiny < weiny2@llnl.gov > infiniband-diags-1.6.1/doc/rst/ibtracert.8.in.rst0000644013161601316160000000373612003563134016507 00000000000000========= IBTRACERT ========= :Date: @BUILD_DATE@ :Manual section: 8 :Manual group: Open IB Diagnostics --------------------- trace InfiniBand path --------------------- SYNOPSIS ======== ibtracert [options] [ [ []]] DESCRIPTION =========== ibtracert uses SMPs to trace the path from a source GID/LID to a destination GID/LID. Each hop along the path is displayed until the destination is reached or a hop does not respond. By using the -m option, multicast path tracing can be performed between source and destination nodes. OPTIONS ======= **-n, --no_info** simple format; don't show additional information **-m** show the multicast trace of the specified mlid Addressing Flags ---------------- .. include:: common/opt_G.rst .. include:: common/opt_L.rst .. include:: common/opt_s.rst Port Selection flags -------------------- .. include:: common/opt_C.rst .. include:: common/opt_P.rst .. include:: common/sec_portselection.rst Debugging flags --------------- .. include:: common/opt_d.rst .. include:: common/opt_e.rst .. include:: common/opt_h.rst .. include:: common/opt_v.rst .. include:: common/opt_V.rst Configuration flags ------------------- .. include:: common/opt_t.rst .. include:: common/opt_node_name_map.rst .. include:: common/opt_y.rst .. include:: common/opt_z-config.rst FILES ===== .. include:: common/sec_config-file.rst .. include:: common/sec_node-name-map.rst EXAMPLES ======== Unicast examples :: ibtracert 4 16 # show path between lids 4 and 16 ibtracert -n 4 16 # same, but using simple output format ibtracert -G 0x8f1040396522d 0x002c9000100d051 # use guid addresses Multicast example :: ibtracert -m 0xc000 4 16 # show multicast path of mlid 0xc000 between lids 4 and 16 SEE ALSO ======== ibroute (8) AUTHOR ====== Hal Rosenstock Ira Weiny infiniband-diags-1.6.1/doc/generate0000754013161601316160000000117112003563134014121 00000000000000#!/bin/bash docdir=`dirname $0` mode=$1 cd $docdir if [ "$mode" == "" ]; then if [ ! -d man ]; then mkdir man fi for file in rst/*.rst; do file=`basename $file` target=`echo $file | sed -e 's/\(.*\).rst/\1/'` echo " creating man/$target ..." rst2man rst/$file > man/$target done elif [ "$mode" == "clean" ]; then rm -f man/* elif [ "$mode" == "-h" ] || [ "$mode" == "--help" ]; then echo "./generate [clean]" echo " Generate the .in 'man' files from rst documentation" echo " clean -- remove all files in 'man' and regenerate \"clean\"" else echo "ERROR: invalid option '$mode'" exit 1 fi exit 0 infiniband-diags-1.6.1/doc/README.rst0000644013161601316160000000566312003563134014103 00000000000000infiniband-diags ReStructured Text documentation ================================================ Having documentation in ReStructured Text has the following benefits 1) The addition of common functionality (options, config files, etc.) can be documented once and then included in documents for multiple tools. 1a) Documentation source is more straight forward and writers can concentrate on the features which are unique to each tool. 2) Documentation can be generated into multiple formats (man, html) not just man pages. 3) Documentation for any individual tool is complete within that page. (There is no referencing of other documents and guessing which "common" options apply.) Instructions ------------ Place main ``rst`` files in the rst directory. ``common include`` rst files should be in rst/common. "git add" should _only_ be run on the rst source files themselves. The best way to update generated documentation after changes is to [re]run configure. autoconf will run the ``generate`` script if rst2man is available on your system. If rst2man is not available, tarball and source rpm distributions contain the doc/man/\*.in files and can be built from those files a users system without rst2man. Of course they will not get any changes made to the rst files. Therefore developers are required to have rst2man[*] installed. [*] rst2man is available in the python-docutils package. Common files ------------ Common documents should be placed in the rst/common directory. Common files should not be put in the 'main' rst directory. The automated conversion script will try and make documents out of them. There are 2 types of common files 1) common options The common options are text which describes a common option. The naming conventions is: opt_