iblinkinfo - report link info for all links in the fabric
iblinkinfo [-hcdl -C <ca_name> -P <ca_port> -v <lt,hoq,vlstall> -S <guid> -D <direct_route> --load-cache <filename>]
IBLINKINFO(1m) OpenIB Diagnostics IBLINKINFO(1m)
NAME
iblinkinfo - report link info for all links in the fabric
SYNOPSIS
iblinkinfo
[-hcdl -C <ca_name> -P <ca_port> -v <lt,hoq,vlstall> -S <guid> -D
<direct_route> --load-cache <filename>]
DESCRIPTION
iblinkinfo reports the link info for each port of each switch active in
the IB fabric.
OPTIONS
-S <guid>
Output only the switch specified by <guid> (hex format)
-D <direct_route>
Output only the switch specified by the direct route path.
-l Print all information for each link on one line. Default is to
print a header with the switch information and then a list for
each port (useful for grep'ing output).
-d Print only switches which have a port in the "Down" state.
-v <lt,hoq,vlstall>
Verify additional switch settings (<Life-
Time>,<HoqLife>,<VLStallCount>)
-c Print port capabilities (enabled and supported values)
-C <ca_name> use the specified ca_name for the search.
-P <ca_port> use the specified ca_port for the search.
-R (This option is obsolete and does nothing)
--load-cache <filename>
Load and use the cached ibnetdiscover data stored in the speci-
fied filename. May be useful for outputting and learning about
other fabrics or a previous state of a fabric. Cannot be used
if user specifies a directo route path. See ibnetdiscover for
information on caching ibnetdiscover output.
--diff <filename>
Load cached ibnetdiscover data and do a diff comparison to the
current network or another cache. A special diff output for
iblinkinfo output will be displayed showing differences between
the old and current fabric links. Be default, the following are
compared for differences: port connections and port state. See
ibnetdiscover for information on caching ibnetdiscover output.
--diffcheck <key(s)>
Specify what diff checks should be done in the --diff option
above. Comma separate multiple diff check key(s). The avail-
able diff checks are:port = port connections, state = port
state, lid = lids, nodedesc = node descriptions. If port is
specified alongside lid or nodedesc, remote port lids and node
descriptions will also be compared.
--filterdownports <filename>
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.
AUTHOR
Ira Weiny
<weiny2@llnl.gov>
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+---------------+----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+----------------------+
|Availability | network/open-fabrics |
+---------------+----------------------+
|Stability | Volatile |
+---------------+----------------------+
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original community
source was downloaded from ['http://www.openfabrics.org/downloads/ibu-
tils/ibutils-1.5.7.tar.gz', 'http://www.openfabrics.org/down-
loads/libibverbs/libibverbs-1.1.4-1.22.g7257cd3.tar.gz',
'http://www.openfabrics.org/down-
loads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz', 'http://www.openfab-
rics.org/downloads/libsdp/libsdp-1.1.108-0.15.gd7fdb72.tar.gz',
'http://www.openfabrics.org/downloads/management/infiniband-
diags-1.5.8.tar.gz', 'http://www.openfabrics.org/downloads/manage-
ment/libibmad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/man-
agement/libibumad-1.3.7.tar.gz', 'http://www.openfabrics.org/down-
loads/management/opensm-3.3.9.tar.gz', 'http://www.openfab-
rics.org/downloads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz',
'http://www.openfabrics.org/down-
loads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz', 'http://www.openfab-
rics.org/downloads/rdmacm/librdmacm-1.0.14.1.tar.gz', 'http://www.open-
fabrics.org/downloads/rds-tools/rds-tools-2.0.4.tar.gz']
Further information about this software can be found on the open source
community website at http://www.openfabrics.org/.
OpenIB Jan 24, 2008 IBLINKINFO(1m)