iblinkinfo(8) - Linux man page

Name

Synopsis

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

-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>,<VLStallCount>)

-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 specified 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 available 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>

Referenced By