C Roff C++ CMake Python Shell Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Documentation Documentation/versioning.md: Fix sentence and a typo Apr 30, 2018
buildlib buildlib: Turn sse3 option upon travis-build Jul 10, 2018
ccan ccan: Add array_size.h file Jun 4, 2018
debian Merge pull request #365 from nmorey/dev/master/rxe-iproute2 Aug 7, 2018
ibacm verbs, ibacm, librdmacm: Introduce ibv_get_pkey_index() Aug 1, 2018
iwpmd iwpmd: Initialize address of sockaddr May 23, 2018
kernel-boot Fix typo caase -> case Sep 11, 2017
kernel-headers Update kernel headers Aug 14, 2018
libibumad umad: Fix gcc-8 warning about truncated string May 23, 2018
libibverbs verbs: Fix dereg MR Aug 16, 2018
librdmacm verbs, ibacm, librdmacm: Introduce ibv_get_pkey_index() Aug 1, 2018
providers Add Microsoft Azure RDMA device to MLX4 HCA table Aug 15, 2018
rdma-ndd Merge pull request #179 from jgunthorpe/systemd2 Aug 6, 2017
redhat Update library version to be 20.0 Jul 4, 2018
srp_daemon srp_daemon: Rename ib_path_rec.num_path Aug 1, 2018
suse suse: Add recommends for rxe_cfg requirements Aug 2, 2018
util buildlib: Use -msse if the compiler does not support target(sse) Jun 8, 2018
.gitignore Consolidate the .gitignore files Sep 21, 2016
.mailmap Update MAINTAINERS Nov 20, 2017
.travis.yml Fixup travis builds May 15, 2018
CMakeLists.txt Merge pull request #356 from yishaih/mlx5_flow Jul 26, 2018
COPYING.BSD_FB Document copyright situation and select default license Sep 29, 2016
COPYING.BSD_MIT Document copyright situation and select default license Sep 29, 2016
COPYING.GPL2 Unified CMake build system Sep 21, 2016
COPYING.md rdma-core: Spell "daemon" correctly May 11, 2017
MAINTAINERS qedr: Update MAINTAINERS Mar 22, 2018
README.md Support writing man pages in MarkDown Mar 19, 2018
build.sh build: Pass extra cmake flags Feb 4, 2018

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:

  • iw_cxgb3.ko
  • iw_cxgb4.ko
  • hfi1.ko
  • hns-roce.ko
  • i40iw.ko
  • ib_qib.ko
  • mlx4_ib.ko
  • mlx5_ib.ko
  • ib_mthca.ko
  • iw_nes.ko
  • ocrdma.ko
  • qedr.ko
  • rdma_rxe.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.

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 libudev-dev libnl-3-dev libnl-route-3-dev ninja-build pkg-config valgrind

Fedora

$ dnf install cmake gcc libnl3-devel libudev-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 libudev-devel ninja pkg-config valgrind-devel

Building on CentOS 6/7

Install required packages:

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

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

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

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

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

Patches should also be submitted to the linux-rdma@vger.kernel.org mailing list. Please use unified diff form (the -u option to GNU diff), and include a good description of what your patch does and why it should be applied. If your patch fixes a bug, please make sure to describe the bug and how your fix works.

Make sure that your contribution can be licensed under the same license as the original code you are patching, and that you have all necessary permissions to release your work.

TravisCI

Submitted patches must pass the TravisCI automatic builds without warnings. A build similar to TravisCI can be run locally using docker and the 'buildlib/cbuild' script.

$ buildlib/cbuild build-images travis
$ buildlib/cbuild pkg travis