Displaying IB Device Information

To display IB device information, use the following command syntax:

# cfgadm -[a]l

where the –a option adds more information that is displayed than by using the –l option alone.

In the following sample output, information is truncated to show relevant IB information only.

# cfgadm -al
Ap_Id                       Type         Receptacle     Occupant     Condition
ib                          IB-Fabric    connected      configured   ok
hca:21280001A0A478          IB-HCA       connected      configured   ok
ib::21280001A0A47A,0,ipib   IB-PORT      connected      configured   ok
ib::21280001A0A479,0,ipib   IB-PORT      connected      configured   ok
ib::1730000008070,0,hnfs    IB-HCA_SVC   connected      configured   ok
ib::daplt,0                 IB-PSEUDO    connected      configured   ok
ib::iser,0                  IB-PSEUDO    connected      configured   ok
ib::rdsib,0                 IB-PSEUDO    connected      configured   ok
ib::rdsv3,0                 IB-PSEUDO    connected      configured   ok
ib::rpcib,0                 IB-PSEUDO    connected      configured   ok
ib::sdpib,0                 IB-PSEUDO    connected      configured   ok
ib::sol_umad,0              IB-PSEUDO    connected      configured   ok
ib::sol_uverbs,0            IB-PSEUDO    connected      configured   ok

The cfgadm command displays information about attachment points, which are locations in the system where DR operations can occur.

For more information about attachment points, see Attachment Points. For more information about attachment points supported by the cfgadm command, see the cfgadm_ib(1M) man page.

An attachment point consists of a receptacle and an occupant. The following table describes the state of a device depending on the corresponding combined states of the receptacle, occupant, and condition:

Receptacle/Occupant/Condition Combined State Description connected/configured/ok The device is connected and available. The devinfo node is present. connected/unconfigured/unknown The device is unavailable and no devinfo node or device driver exists for this device. Or, the device was never configured for use by ib nexus driver. The device might be known to the IB Device Manager.

Devices are listed by their attachment point IDs (Ap_Id). Note that all IB Ap_Ids are shown as connected. The following list explains the information for a specific Ap_Id in the sample output.

ib::21280001A0A47A,0,ipib

Identifies an IB port device that is connected to port GUID and is bound to the ipib service.

ib::sdpib,0

Identifies a pseudo device.

hca:21280001A0A478

Identifies an HCA device.

ib::1730000008070,0,hnfs

Identifies an IB HCA_SVC device that is bound to the hnfs service.

ib::ibgen,0

Identifies a pseudo device.

You can use other options of the cfgadm command to further customize the information to be displayed. The following examples show the use of selected options.

Example 3-1  Displaying Information About a Port Device

This example shows information about the port device ib::21280001A0A47A,0,ipib.

# cfgadm -al -s "cols=ap_id:info" ib::21280001A0A47A,0,ipib
Ap_Id                          Information
ib::21280001A0A47A,0,ipib      ipib

Example 3-2  Displaying Port and GUID Information of an HCA Device

This example shows the number of ports and their respective GUIDs for the HCA device hca::1730000008070.

# cfgadm -al -s "cols=ap_id:info" hca::1730000008070
Ap_Id                          Information
hca::1730000008070             VID: 0x15b3, PID: 0x5a44, #ports: 0x2,
port1 GUID: 0x1730000008071, port2 GUID: 0x1730000008072

Example 3-3  Displaying Kernel Clients of an HCA Device

This example shows the kernel clients of the HCA hca:173000007F50.

$ cfgadm -x list_clients hca:173000007F50
Ap_Id                       IB Client         Alternate HCA
ib::1730000007F51D0            ibgen              no
ib::1730000007F51D1            ibgen              no
ib::1730000007F51,0,ipib       ibd                no
ib::ibgen,0                    ibgen              no
-                              ibdm               no
-                              ibmf               no
-                              nfs/ib             no

In the sample output, if a kernel IB client uses an HCA other than hca:173000007F50, the entry under the column Alternate HCA would indicate yes. If IB Managers and kernel clients that do not use the HCA, their Ap_Ids would not be listed. Moreover, although EoIB uses the Solaris IB framework, the command does not list EoIB as a kernel IB client.

Example 3-4  Displaying Supported Communication Services

The following example lists IB communication services currently used by the InfiniBand Transport Framework (IBTF).

# cfgadm -x list_services ib
Port communication services:
srp
VPPA communication services:
ibd
HCA_SVC communication services:
hnfs

Using the prtconf Command

You can also use the prtconf command to display general information about IB devices. In the following example, pci15b3,673c refers to an IB HCA.

$ prtconf
.
.
.
ib, instance #0
rpcib, instance #0
rdsib, instance #0
daplt, instance #0
rdsv3, instance #0
sdpib, instance #0
sol_umad, instance #0
sol_uverbs, instance #0
iser, instance #0
.
.
.
pci15b3,673c, instance #0
ibport, instance #0
ibport, instance #1