Repository files navigation

This is the userspace components for the Linux Kernel's drivers/infinibandsubsystem. Specifically this contains the userspace libraries for thefollowing 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 includedunder the providers/ directory. Support for the following Kernel RDMA driversis included:

• bnxt_re.ko
• efa.ko
• erdma.ko
• iw_cxgb4.ko
• hfi1.ko
• hns-roce.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)

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

$ bash build.sh

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

$ 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

$ dnf builddep redhat/rdma-core.spec

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

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

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

To set up software RDMA on an existing interface with either of the availabledrivers, use the following commands, substituting<DRIVER> with the name ofthe driver of your choice (rdma_rxe orsiw) and<TYPE> with the typecorresponding to the driver (rxe orsiw).

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

Please note that you need version ofiproute2 recent enough is required for thecommand above to work.

You can use eitheribv_devices orrdma link to verify that the device wassuccessfully added.

Bugs should be reported to thelinux-rdma@vger.kernel.org mailing listIn 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 crashoccurred, including any kernel messages produced.

SeeContributing to rdma-core.

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