=============

IBNETDISCOVER

=============

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

discover InfiniBand topology

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

:Date: @BUILD_DATE@

:Manual section: 8

:Manual group: Open IB Diagnostics

SYNOPSIS

========

ibnetdiscover [options] [<topology-file>]

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.

**-f, --full**

Show full information (ports' speed and width, vlcap)

**-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

        < ira.weiny@intel.com >