smcd - Display information about SMC-D link groups and devices

Edit online

Red Hat Enterprise Linux 8.6 LPAR mode z/VM guest KVM guest

SMC-D connections are based on ISM devices, see Internal shared memory device driver.

Where:

linkgroup

displays information about SMC-D link groups and links.

device

displays information about a specified SMC-D device, or all.

stats

displays statistics for SMC-D.

show

displays information about link groups, devices, or statistics.

all

displays information about all link groups or devices.

<LG-ID>

displays information about the specified link group.

-d or --details

displays detailed SMC-D statistics.

-a or --absolute

ignores any counter resets and displays statistics beginning with smc module load.

reset

displays the current statistics and resets all SMC-D statistics counters to zero.

json

displays the current statistics in JSON format.

info

displays a summary of the SMC levels supported in the Linux kernel, and the capabilities of the hardware:

Kernel Capabilities: Shows the Linux kernel’s SMC capabilities independently of any hardware prerequisites.
Hardware Capabilities: Shows the hardware’s capabilities independently of support for it in Linux.

-h or --help

displays help information for the specified sub-command. Depending on the sub-command of interest, specify smcd device help, smcd linkgroup help, or smcd stats help. To view the man page, enter man smcd.

-v or --version

displays version information.

Output columns for linkgroup and device

In the output table, the columns headers have the following meanings:

FID

Function ID of the PCI device.

Type

Type of the underlying PCI device. For SMC-D connections, the type is ISM.

PCI-ID

ID of the PCI device.

PCHID

Physical channel ID of the PCI device.

InUse

Shows whether the ISM device is in use. The value can be:

Yes: At least one link group runs on the ISM device.
No: No link group runs on the ISM device.

#LGs

Number of link groups on the device.

PNET-ID

PNET ID of the device. A leading asterisk (*) means that the PNET ID is set by the user. For example, *NET1.

Output of stats

For the output of the stats sub-command, see Obtaining statistics for SMC connections.

Examples

To display all SMC-D devices, issue:

# smcd device 
FID   Type PCI-ID        PCHID  InUse #LGs  PNET-ID
02e1  ISM  0002:00:00.0  07c2   No       0  NET1

The same output results with the command: smcd device show all.

To show SMC-D statistics:
```
# smcd stats
```
To show detailed SMC-D statistics and reset SMC-D statistics counters:
```
# smcd -d stats reset
```
To ignore any counter resets and show detailed SMC-D statistics since module load in JSON format:
```
# smcd -da stats json
```

To display a summary of SMC capabilities, issue:

# smcd info
   Kernel Capabilities
   SMC Version:      2.0
   SMC Hostname:     myHost
   SMC-D Features:   v1 v2
   SMC-R Features:   v1

   Hardware Capabilities
   SEID:             IBM-SYSZ-ISMSEID00000000XYZ
   ISM:              v1 v2
   RoCE:             n/a

The example shows that SMC-D version 1 and SMC-D version 2 could be used, as the kernel and ISM supports both versions. However, SMC-R would not be available: While the kernel supports it, the hardware is missing.