==========

IBLINKINFO

==========

--------------------------------------------

report link info for all links in the fabric

--------------------------------------------

:Date: @BUILD_DATE@

:Manual section: 8

:Manual group: OpenIB Diagnostics

SYNOPSIS

========

iblinkinfo <options>

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 (<LifeTime>,<HoqLife>,<VLStallCount>)

**--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 <port_guid>** same as "-G". (provided only for backward compatibility)

How much of the scan to be printed can be controlled 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 <hops>**

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

**--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.  Note that **port**, **lid**, and **nodedesc** are checked only

for the node types that are specified (e.g.  **switches-only**, **cas-only**).

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 useless.  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

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

        < ira.weiny@intel.com >