ibstat Command

Purpose

Displays operational information about one or more InfiniBand network devices.

Syntax

ibstat [ -d, -h, -i, -n, -p, -v ] [DeviceName]

Description

This command displays InfiniBand operational information pertaining to a specified Host Channel Adapter Device (HCAD). If an HCAD device name is not entered, status for all available HCADs are displayed. Select a flag to narrow down your search results. You can display specific categories of information, including Node, Port, Interface, and Debug information. You can also choose to display all of the information categories.

Flags

Item Description
-d Displays current debug setting.
-h Displays ibstat command usage.
-i Displays network interface information.
-n Displays only IB node information.
-p Displays only IB port information.
-v Displays all IB device information.
The following fields display information for all valid calls:
Device Name
Displays the name of an available HCAD (for example, iba0).
Port State
Displays the current state of each HCAD port.
Down
Port is disabled.
Initialized
Port is enabled and issuing training sequences.
Armed
Port is trained and attempting to configure to the active state.
Active
Port is in a normal operational state.
Unknown
Port is in an invalid or unknown state.

Parameters

Item Description
DeviceName Specifies the name of the HCAD device (for example, iba0)

Tip: The device name is optional. If you do not specify a device name, all InfiniBand devices are queried for control or information.

Exit Status

When you specify an invalid DeviceName, the ibstat command produces error messages stating that it could not connect to the device. For example: 
IBSTAT: No device iba2 configured.
or: 
IBSTAT: Device iba3 is not available.

Examples

  1. To request node and port information, enter: 
    ibstat -n -p
    Information similar to the following is displayed: 
    ===============================================================================
 INFINIBAND DEVICE INFORMATION (iba0)
===============================================================================

-------------------------------------------------------------------------------
 IB NODE INFORMATION (iba0)
-------------------------------------------------------------------------------
Number of Ports:                        2
Globally Unique ID (GUID):              00.02.55.00.00.00.46.00
Maximum Number of Queue Pairs:          1023
Maximum Outstanding Work Requests:      32768
Maximum Scatter Gather per WQE:         252
Maximum Number of Completion Queues:    1023
Maximum Multicast Groups:               256
Maximum Memory Regions:                 3836
Maximum Memory Windows:                 3836

-------------------------------------------------------------------------------
 IB PORT 1 INFORMATION (iba0)
-------------------------------------------------------------------------------
Global ID Prefix:                       fe.80.00.00.00.00.00.00
Local ID (LID):                         0012
Port State:                             Active
Maximum Transmission Unit Capacity:     2048
Current Number of Partition Keys:       1
Partition Key List:
  P_Key[0]:                             ffff
Current Number of GUID's:               1
Globally Unique ID List:
  GUID[0]:                              00.02.55.00.00.00.46.12

-------------------------------------------------------------------------------
 IB PORT 2 INFORMATION (iba0)
-------------------------------------------------------------------------------
Global ID Prefix:                       fe.80.00.00.00.00.00.00
Local ID (LID):                         0011
Port State:                             Active
Maximum Transmission Unit Capacity:     2048
Current Number of Partition Keys:       1
Partition Key List:
  P_Key[0]:                             ffff
Current Number of GUID's:               1
Globally Unique ID List:
  GUID[0]:                              00.02.55.00.00.00.46.52

Location

/usr/sbin/ibstat