smcd - Display information about SMC-D link groups and devices
Where:
- Generic options
- These options are available for all subcommands.
- show
- displays information about link groups, devices, or statistics, the system enterprise ID (EID), or user defined EIDs. This is the default option.
- -h or --help
- displays help information for the specified sub-command. To view the man page, enter man smcd.
- linkgroup options
- The linkgroup subcommand displays information about SMC-D link groups and links.
- all
- displays information about all link groups or devices.
- <LG-ID>
- limits the information to the specified link group.
- device options
- The device subcommand displays information about SMC-D devices.
- all
- displays information about all SMC-D devices. This is the default.
- stats options
- The stats subcommand displays statistics for SMC-D.
- -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.
- seid otions
- The seid subcommand controls the system EID.
- enable
- uses the system EID for your Linux instance.
- disable
- does not use the system EID for your Linux instance. At least one user defined EID must exists. A disabled system EID is automatically enabled when the last user defined EID entry is deleted.
- ueid options
- the ueid subcommand manages user defined EIDs.
- add <ueid>
- add a user defined EID.
For <ueid>, specify up 32 uppercase alphabetic (A-Z) characters, numerals (0-9), hyphens (-), and dots (.). The first character must be alphanumeric, and dots must not be consecutive.
- del <ueid>
- delete the specified user defined EID.
- flush
- delete all user defined EIDs.
- 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.
- -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:
The same output results with the command: smcd device show all.# smcd device FID Type PCI-ID PCHID InUse #LGs PNET-ID 02e1 ISM 0002:00:00.0 07c2 No 0 NET1 - 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 show all user defined EIDs.
# smcd ueid BUILDING-19 BUILDING-04 - To show the system
EID.
# smcd seid IBM-SYSZ-ISMSEID000000002E488561 [enabled] - To disable the system
EID.
# smcd seid disable - To display a summary of SMC capabilities,
issue:
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.# 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