ibnetdiscover Command - Sun Datacenter InfiniBand Switch 72 Topic Set

`ibnetdiscover` Command

Discovers the InfiniBand topology.

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 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=0x2c9
devid=0xbd36
sysimgguid=0x21283a8620b0d3
switchguid=0x21283a8620b0d0(21283a8620b0d0)
Switch  36 "S-0021283a8620b0d0"     # "Sun DCS 72 QDR switch 1.2(LC)" base port 0 lid 23 lmc 0
[18]    "S-0021283a8620b0e0"[16]     # "Sun DCS 72 QDR switch 1.1(FC)" lid 24 4xQDR
.
.
.

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 Aug 13 22:40:51 2009
#
# Max of 2 hops discovered
# Initiated from node 0021283a8620b0f0 port 0021283a8620b0f0
vendid=0x2c9
devid=0xbd36
sysimgguid=0x21283a8620b0f3
switchguid=0x21283a8620b0f0(21283a8620b0f0)
Switch  36 "S-0021283a8620b0f0"     # "Sun DCS 72 QDR FC switch o4nm2-72p-2" enhanced port 0 lid 25 lmc 0
[36]    "S-0021283a8620b0d0"[4]     # "Sun DCS 72 QDR switch 1.2(LC)" lid 23 4xQDR
[35]    "S-0021283a8620b0b0"[5]     # "Sun DCS 72 QDR switch 1.2(LC)" lid 21 4xQDR
[34]    "S-0021283a8620b0d0"[6]     # "Sun DCS 72 QDR switch 1.2(LC)" lid 23 4xQDR
.
.
.
vendid=0x2c9
devid=0x673c
sysimgguid=0x21283a8620b0e3
switchguid=0x21283a8620b0e0(21283a8620b0e0)
Switch  36 "S-0021283a8620b0e0"     # "Sun DCS 72 QDR switch 1.1(FC)" base port 0 lid 24 lmc 0
[22]    "S-0021283a8620b0c0"[18]     # "Sun DCS 72 QDR switch 1.2(LC)" lid 22 4xQDR
[24]    "S-0021283a8620b0c0"[16]     # "Sun DCS 72 QDR switch 1.2(LC)" lid 22 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 72 Topic Set