ibnetdiscover Command - Sun Datacenter InfiniBand Switch 648 Topic Set

`ibnetdiscover` Command

Discovers the InfiniBand topology. Issued on the Linux InfiniBand host.

Syntax

ibnetdiscover [-d][-e][-v][-s][-l][-g][-H][-S][-R][-C ca_name][-P ca_port][-t timeout][-V][--node-name-map map][-p][-h][topology]

where:

ca_name is the channel adapter name.
ca_port is the channel adapter port.
timeout is the timeout in milliseconds.
map is the file name of the node name map.
topology is the topology file.

Description

This InfiniBand software command performs InfiniBand fabric discovery and outputs a human readable topology file. Nodes, node types, node descriptions, links, port numbers, port LIDs, and GUIDs are displayed. The output is directed to a topology file, if the file name is specified.

The output of the topology file follows this basic format for each node:

vendid=vendor_ID_in_hex
devid=device _ID_in_hex
and
sysimgguid=GUID_in_hex
and/or
switchguid=GUID_in_hex(portGUID_in_hex)
Switch ports_total "type-nodeGUID_in_hex" # "NodeDescription" base port 0 lid LID lmc 0
or
caguid=GUID_in_hex
Ca ports_total "type-nodeGUID_in_hex" # "NodeDescription"
and
[port] "type-nodeGUID_in_hex"[port](portGUID_in_hex) # "NodeDescription" lid LID widthspeed
[port] "type-nodeGUID_in_hex"[port](portGUID_in_hex) # "NodeDescription" lid LID widthspeed
.
.
.

For example:

vendid=0x8f1
devid=0x5a05
switchguid=0x8f10400410015(8f10400410015)
Switch  8 "S-0008f10400410015" # "SW-6IB4 Voltaire" base port 0 lid 3 lmc 0
[6] "H-0008f10403960984"[1](8f10403960985) # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR
[4] "H-005442b100004900"[1](5442b100004901) # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR
.
.
.

Options

The following table describes the options to the ibnetdiscover command and their purposes:

Option	Purpose
`-d`	Sets the debug level. Can be used several times to increase the debug level.
`-e`	Displays send and receive errors.
`-v`	Provides verbose output.
`-s`	Shows more information.
`-l`	Lists the connected nodes.
`-g`	Shows the grouping and switch external ports correspondence.
`-H`	Lists the connected channel adapters.
`-S`	Lists the connected switches.
`-R`	Lists the connected routers.
`-C`	Uses the specified channel adapter name.
`-P`	Uses the specified channel adapter port.
`-t`	Overrides the default timeout.
`-V`	Displays the version information.
`--node-name-map`	Reads the node name map file.
`-p`	Returns a list of connected ports, including status information: LID portnum GUID link width link speed NodeDescription
`-h`	Provides help.

Example

The following example shows how to discover the InfiniBand fabric topology with the ibnetdiscover command.

# ibnetdiscover
#
# Topology file: generated on Thu Oct 29 16:49:36 2009
#
# Initiated from node 0003ba000100c708 port 0003ba000100c70a
vendid=0x2c9
devid=0xbd36
sysimgguid=0x3ba2550282543
switchguid=0x21283a83ae11d2(21283a83ae11d2)
Switch  36 "S-0021283a83ae11d2" # "Sun DCS 648 shmm1500 LC slot 1 switch 3" base port 0 lid 35 lmc 0
 [1]     "S-00bad0fc0100f8a2"[19] # "Sun DCS 648 shmm1500 FC slot 8 switch 0" lid 56 4xQDR
 [2]     "S-00bad0fc0100f8b2"[36] # "Sun DCS 648 shmm1500 FC slot 8 switch 1" lid 57 4xQDR
 [3]     "S-0021283a77bdf7a2"[19] # "Sun DCS 648 shmm1500 FC slot 7 switch 0" lid 54 4xQDR
.
.
.
vendid=0x2c9
devid=0x673c
sysimgguid=0x3ba000100c70b
caguid=0x3ba000100c708
Ca      2 "H-0003ba000100c708" # "nsn34-39 HCA-1"
[2](3ba000100c70a)      "S-00bad0cc010016a2"[22]                # lid 58 lmc 0 "Sun DCS 648 shmm1500 LC slot 6 switch 0" lid 1 4xQDR
#

Note - The output in the example is just a portion of the full output.

Related Information

ibnetdiscover man page

Exit Print View
Sun Datacenter InfiniBand Switch 648 Topic Set