ibnetdiscover Command - Sun Datacenter InfiniBand Switch 36 HTML Document Collection for Firmware Version 2.1

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=0x21283a8389a0a3
switchguid=0x21283a8389a0a0(21283a8389a0a0)
Switch  36 "S-0021283a8389a0a0" # "Sun DCS 36 QDR switch localhost" enhanced port 0 lid 15 lmc 0
[23]    "H-0003ba000100e388"[2](3ba000100e38a) # "mnm33-43 HCA-1" lid 14 4xQDR
.
.
.

Note - The ibnetdiscover command is available to only the root user.

Options

This 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

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

Note - The output for your InfiniBand fabric will differ from that in the example.

FabMan@switch_name->ibnetdiscover
#
# Topology file: generated on Thu Dec 13 03:41:36 2012
#
# Max of 1 hops discovered
# Initiated from node 0021283a8389a0a0 port 0021283a8389a0a0
vendid=0x2c9
devid=0xbd36
sysimgguid=0x21283a8389a0a3
switchguid=0x21283a8389a0a0(21283a8389a0a0)
Switch  36 "S-0021283a8389a0a0" # "Sun DCS 36 QDR switch localhost" enhanced port 0 lid 15 lmc 0
[23]    "H-0003ba000100e388"[2](3ba000100e38a) # "mnm33-43 HCA-1" lid 14 4xQDR
 
vendid=0x2c9
devid=0x673c
sysimgguid=0x3ba000100e38b
caguid=0x3ba000100e388
Ca      2 "H-0003ba000100e388" # "mnm33-43 HCA-1"
[2](3ba000100e38a)      "S-0021283a8389a0a0"[23] # lid 14 lmc 0 "Sun DCS 36 QDR switch localhost" lid 15 4xQDR
FabMan@switch_name->

Related Information

ibnetdiscover man page

Skip Navigation Links
Exit Print View
	Sun Datacenter InfiniBand Switch 36 HTML Document Collection for Firmware Version 2.1