IBLINKINFO(8) OpenIB Diagnostics IBLINKINFO(8)NAMEiblinkinfo - report link info for all links in the fabric
SYNOPSISiblinkinfo
[-hcdl -C <ca_name> -P <ca_port> -p -S <port_guid> -G <port_guid> -D
<direct_route> --load-cache <filename>]
DESCRIPTIONiblinkinfo 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-S <port_guid> -G <port_guid> --port-guid
start partial scan at the port specified by <port_guid> (hex
format)
-D <direct_route>
start partial scan at the port specified by the direct route
path.
-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).
-d Print only nodes which have a port in the "Down" state.
-p Print additional port settings (<LifeTime>,<HoqLife>,<VLStall‐
Count>)
-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 direct 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.
--switches-only
Show only switches in output.
--cas-only
Show only CAs in output.
AUTHOR
Ira Weiny
<weiny2@llnl.gov>
OpenIB Jan 24, 2008 IBLINKINFO(8)