SMC Tools

Utilities for use with AF_SMC sockets.

This package consists of the following tools:

libsmc-preload.so : preload library.
smc : List linkgroups, links, devices, and more
smc_chk : SMC support diagnostics
smc_pnet : C program for PNET Table handling
smc_rnics : List available RDMA NICs
smc_run : preload library environment setup script.
smcss : C program for displaying the information about active SMC sockets.

The preload shared library libsmc-preload.so provides mapping of TCP socket operations to SMC sockets. The environment setup script smc_run sets up the preload environment for the libsmc-preload.so shared library before starting application. The smcss program is used to gather and display information about the SMC sockets. The smc_pnet program is used to create, destroy, and change the SMC-R PNET table.

In addition the package contains the AF_SMC manpage (man af_smc).

License

See LICENSE.

Code Contributions

See CONTRIBUTING.md.

Release History:

v1.8.3 (2023-07-28)

Bug fixes:
- Makefile: Adjust default library path for Ubuntu
- smc_stats: Fix man page name
v1.8.2 (2022-09-26)

Bug fixes:
- smc_run: Fix for single quotes in parameters
- Makefile: Fix target check
- smcss/smc_pnet: Fix option --version
- smcr/smc_dbg: Fix for showing the correct hardware capabailities for RoCE Express3 cards
v1.8.1 (2022-04-14)

Changes:
- smc_rncs: Recognize RoCE Express3 cards
v1.8.0 (2022-04-11)

Changes:
- smc_dbg: Add stats and smc info output
- smc_rnics:
  - List unknown devices with option -a
  - Include software-set PNET IDs
- smc_chk: Indicate PNET IDs set by smc_pnet.
Bug fixes:
- smc_rnics: Display correct PNET ID for unknown Mellanox cards
- smc_run: Fix output of version info
v1.7.0 (2021-10-29)

Changes:
- Add support for SMC-Rv2
- smcd/smcr: Add support for new commands seid and ueid to manage system and user EIDs
v1.6.1 (2021-10-01)

Bug fixes:
- smcd/smcr statistics:
  - Fix memory overread in is_data_consistent()
  - Fix memory and file handle leaks
  - Use correct fallback counter values after reset
v1.6.0 (2021-07-01)

Changes:
- smcd/smcr: Add new command stats
- smc_rnics: Recognize unknown Mellanox cards
- smc_run: Add various command-line switches
Bug fixes:
- smc_chk: Remove 'EXPERIMENTAL' flag
- smc_chk: Improve cleanup
- smc_chk: Start server with intended port
- Makefile: Install smc_chk.8 on s390 only
- Makefile: Fix extra compile flags handling
- smc_rnics: Handle malformed FID arguments
v1.5.0 (2021-01-29)

Changes:
- smcd/smcr: Add new command info
- smc_rnics: Use n/a to indicate missing PNET ID
- smc_chk: New tool to perform SMC eligilibilty checks, requires man and python3 to be installed
- man pages: Consistency improvements
Bug fixes:
- smc_pnet.8: Use correct spelling for 'PNET ID'
- smc_rnics: Suppress output of port attribute for offline devices
v1.4.0 (2020-11-03)

Changes:
- Add SMC-Dv2 support
- smc: Add new tools smcd and smcr to list linkgroups, links and devices. Requires Linux kernel 5.11 or higher.
- smc_rnics: Display enabled devices per default, add new option --all
- smc_rnics: Sort output by FID
Bug fixes:
- smc_rnics/smc_dbg: Fix PNETID for multiport devices
- smcss/smc_pnet: Consistent use of option -v
v1.3.1 (2020-09-14)

Changes:
- smcss: Add further error codes to man page
Bug fixes:
- smcss: Display more than 321 connections
- smc_rnics: Suppress any unknown non-networking device unless option -r is specified
v1.3.0 (2020-06-16)

Changes:
- smcss: Add description of Linux error codes to man page
- smc_rnics:
  - Sort output by PCHID
  - Replace spaces in output by underscores for easier parsing
  - Add new option --IB-dev to display IB-specific attributes
Bug fixes:
- smc_rnics:
  - FIDs can have up to 4 digits and are planned to be extended to a total of 8 digits - adjusting output format accordingly
  - Do not display port attribute for RoCE Express2 devices unless we have an accurate value
v1.2.2 (2019-10-24) Changes:
- Add bash autocompletion support
- Makefile: Drop 31 Bit install due to rpmbuild conflict
Bug fixes:
- smcss: Do not show connection mode for already closed sockets
- smc_rnics: Set interface to "n/a" for ISM devices
v1.2.1 (2019-04-15) Bug fixes:
- smc_rnics: Install man page on s390 only
- libsmc..: Handle behavior flags in type argument to socket() call
- Makefile: Fixed install target on Ubuntu for platforms other than s390
- smc_pnet: Changes in support of kernel 5.1
v1.2.0 (2019-02-08) Changes:
- smc_rnics: Initial version added
- smc_dbg: Initial version added
Bug fixes:
- smcss: Parse address family of ip address
v1.1.0 (2018-06-29) Changes:
- smcss: Add IPv6 support
- libsmc..: Add IPv6 support
- smcss: Output format changed
- libsmc..: Rename preload library to libsmc-preload.so
- Makefile: Improve distro compatibility
- Makefile: Add SONAME to shared libraries
- Makefile: Do not strip binaries on install
- Makefile: Use LDFLAGS to allow addition of externally set link flags
- libsmc..: Remove hardcoded reference to libc
- Manpages: Formatting changes
Bug fixes:
- Makefile: Fix target install dependencies
- smcss: Fix --version output
- smc_pnet: Fix --version output
- smc_run: Append preload library to LD_PRELOAD instead of potentially overwriting pre-set values
- libsmc..: Set suid flag to work with suid executables
v1.0.0 (2017-02-13) The initial version

ibm-s390-linux/smc-tools

SMC Tools

License

Code Contributions

Release History: