Google Git
Sign in
third-party-mirror / linux-rdma / rdma-core / 1deb440d17fa4abcd2609b66889a084b487902eb
commit1deb440d17fa4abcd2609b66889a084b487902eb[log] [tgz]
authorBenjamin Drung <bdrung@ubuntu.com>Mon Apr 14 12:36:46 2025 +0200
committerBenjamin Drung <bdrung@ubuntu.com>Mon Apr 14 12:40:30 2025 +0200
tree3015695e11f26cbfed7e0328c1681885a264ca75
parentf7686a93513246501d532277073a29b7285acf40 [diff]
parent45b7e6deffadbd81e6c95bb783926c051a5c0fa8 [diff]
Merge tag 'v56.1' into debian/unstable

rdma-core-56.1:

Updates from version 56.0
 * Backport fixes:
   * Revert "mlx4: Fix overrun-buffer-arg"
   * libibumad: Fix iteration index for switches
   * ocrdma: Fix uninit_use issues
   * rxe: Fix uninit_use_in_call issues
   * libibverbs: Fix cast-align warning in verbs_get_ctx()
   * bnxt_re/lib: Fix the data copy during the low latency push path
   * mlx4: Fix overrun-buffer-arg
   * mlx4: Fix uninit_use issues
   * vmw_pvrdma: Fix uninit_use issue
   * mlx5: vfio: fix memory leak in mlx5_vfio_get_iommu_info
   * mlx5: fix bad alloc type in dr_arg_pool_alloc_objs
   * libibmad: fix memory leak in mad_rpc_open_port2
   * cxgb4: Fix uninit_use issues
   * qedr: Fix uninit_use issue
   * iwpmd: Fix uninitialized value
   * efa: Fix receive SGE length overflow
   * rping: wait for acknowledgement before processing subsequent CONNECT_REQUESTs
   * providers/mana: Fix modify RC QPs for RTS and INIT states
   * providers/mana: Fix return values on unsupported parent domain flags
   * providers/mana: fix WRs with zero sges
   * providers/mana: Fix return value on unsupported QP type
   * stable branch creation

Signed-off-by: Benjamin Drung <bdrung@ubuntu.com>
tree: 3015695e11f26cbfed7e0328c1681885a264ca75
  1. ABI/
  2. buildlib/
  3. ccan/
  4. debian/
  5. Documentation/
  6. ibacm/
  7. infiniband-diags/
  8. iwpmd/
  9. kernel-boot/
  10. kernel-headers/
  11. libibmad/
  12. libibnetdisc/
  13. libibumad/
  14. libibverbs/
  15. librdmacm/
  16. providers/
  17. pyverbs/
  18. rdma-ndd/
  19. redhat/
  20. srp_daemon/
  21. suse/
  22. tests/
  23. util/
  24. .clang-format
  25. .gitignore
  26. .mailmap
  27. build.sh
  28. CMakeLists.txt
  29. COPYING.BSD_FB
  30. COPYING.BSD_MIT
  31. COPYING.GPL2
  32. COPYING.md
  33. MAINTAINERS
  34. README.md
README.md

Build Status

RDMA Core Userspace Libraries and Daemons

This is the userspace components for the Linux Kernel's drivers/infiniband subsystem. Specifically this contains the userspace libraries for the following device nodes:

  • /dev/infiniband/uverbsX (libibverbs)
  • /dev/infiniband/rdma_cm (librdmacm)
  • /dev/infiniband/umadX (libibumad)

The userspace component of the libibverbs RDMA kernel drivers are included under the providers/ directory. Support for the following Kernel RDMA drivers is included:

  • bnxt_re.ko
  • efa.ko
  • erdma.ko
  • iw_cxgb4.ko
  • hfi1.ko
  • hns-roce-hw-v2.ko
  • irdma.ko
  • ib_qib.ko
  • mana_ib.ko
  • mlx4_ib.ko
  • mlx5_ib.ko
  • ib_mthca.ko
  • ocrdma.ko
  • qedr.ko
  • rdma_rxe.ko
  • siw.ko
  • vmw_pvrdma.ko

Additional service daemons are provided for:

  • srp_daemon (ib_srp.ko)
  • iwpmd (for iwarp kernel providers)
  • ibacm (for InfiniBand communication management assistant)

Building

This project uses a cmake based build system. Quick start:

$ bash build.sh

build/bin will contain the sample programs and build/lib will contain the shared libraries. The build is configured to run all the programs ‘in-place’ and cannot be installed.

Debian Derived

$ apt-get install build-essential cmake gcc libudev-dev libnl-3-dev libnl-route-3-dev ninja-build pkg-config valgrind python3-dev cython3 python3-docutils pandoc

Supported releases:

  • Debian 9 (stretch) or newer
  • Ubuntu 16.04 LTS (xenial) or newer

Fedora, CentOS 8

$ dnf builddep redhat/rdma-core.spec

NOTE: Fedora Core uses the name ‘ninja-build’ for the ‘ninja’ command.

openSUSE

$ zypper install cmake gcc libnl3-devel libudev-devel ninja pkg-config valgrind-devel python3-devel python3-Cython python3-docutils pandoc

Building on CentOS 7, Amazon Linux 2

Install required packages:

$ yum install cmake gcc libnl3-devel libudev-devel make pkgconfig valgrind-devel

Developers on CentOS 7 or Amazon Linux 2 are suggested to install more modern tooling for the best experience.

CentOS 7:

$ yum install epel-release
$ yum install cmake3 ninja-build pandoc

Amazon Linux 2:

$ amazon-linux-extras install epel
$ yum install cmake3 ninja-build pandoc

NOTE: EPEL uses the name ‘ninja-build’ for the ‘ninja’ command, and ‘cmake3’ for the ‘cmake’ command.

Usage

To set up software RDMA on an existing interface with either of the available drivers, use the following commands, substituting <DRIVER> with the name of the driver of your choice (rdma_rxe or siw) and <TYPE> with the type corresponding to the driver (rxe or siw).

# modprobe <DRIVER>
# rdma link add <NAME> type <TYPE> netdev <DEVICE>

Please note that you need version of iproute2 recent enough is required for the command above to work.

You can use either ibv_devices or rdma link to verify that the device was successfully added.

Reporting bugs

Bugs should be reported to the linux-rdma@vger.kernel.org mailing list In your bug report, please include:

  • Information about your system:

    • Linux distribution and version
    • Linux kernel and version
    • InfiniBand hardware and firmware version
    • ... any other relevant information

  • How to reproduce the bug.

  • If the bug is a crash, the exact output printed out when the crash occurred, including any kernel messages produced.

Submitting patches

See Contributing to rdma-core.

Stable branches

Stable versions are released regularly with backported fixes (see Documentation/stable.md) The current minimum version still maintained is ‘v33.X’