Skip to content

Latest commit

 

History

History
200 lines (153 loc) · 6.2 KB

README.md

File metadata and controls

200 lines (153 loc) · 6.2 KB
Raw

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.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

Copyright IBM Corp. 2016, 2020