Skip to content

Latest commit

 

History

History
97 lines (72 loc) · 2.13 KB

README.md

File metadata and controls

97 lines (72 loc) · 2.13 KB

RDMA Plumbing

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 (libumad)
  • /dev/infiniband/ucmX (libibcm, deprecated)

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

  • iw_cxgb3.ko
  • iw_cxgb4.ko
  • hfi1.ko
  • i40iw.ko
  • ib_qib.ko
  • mlx4_ib.ko
  • mlx5_ib.ko
  • ib_mthca.ko
  • iw_nes.ko
  • ocrdma.ko
  • rdma_rxe.ko

Additional service daemons are provided for:

  • srp_daemon (ib_srp.ko)
  • iwpmd (for iwarp kernel providers)

Building

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

$ mkdir build
$ cd build
$ cmake -GNinja ..
$ ninja

build/bin will contain the sample programs and build/lib will contain the shared libraries.

NOTE: It is not currently easy to run from the build directory, the plugins only load from the system path.

Debian Derived

$ apt-get install build-essential cmake gcc libnl-3-dev libnl-route-3-dev ninja-build pkg-config valgrind

Fedora

$ dnf install cmake gcc libnl3-devel pkgconfig valgrind-devel ninja-build

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

OpenSuSE

$ zypper install cmake gcc libnl3-devel ninja pkg-config valgrind-devel

Building on CentOS 6/7

Install required packages:

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

For end users, the package can be built using GNU Make and the old cmake included with the distro:

$ mkdir build
$ cd build
$ cmake  ..
$ make

Developers are suggested to install more modern tooling for the best experience.

$ yum install epel-release
$ yum install cmake3 unzip
$ curl -OL https://github.com/ninja-build/ninja/releases/download/v1.7.1/ninja-linux.zip
$ unzip ninja-linux.zip
$ install -m755 ninja /usr/local/bin/ninja

Use the 'cmake3' program in place of cmake in the above instructions.