rrddmma

A Rust RDMA library.

This library is more for academic use than for industry. It is highly specialized to Mellanox/NVIDIA ConnectX network adapter series.

WARNING: the interfaces are unstable and under continuous change!

Linkage

This library supports multiple linkage types to the ibverbs library.

First, this library respects existing MLNX_OFED installations. It works on both v4.9-x and v5.x versions.
- ~~MLNX_OFED v4.9-x will enable experimental verbs.~~ (TODO)
- ~~MLNX_OFED v5.x will enable mlx5dv_* features.~~ (TODO)
Otherwise, rrddmma will try to find an existing libibverbs installation via pkg-config.
- ~~This will enable enable mlx5dv_* features.~~ (TODO)
Otherwise, rrddmma will try to download rdma-core and build from source. You need to ensure that the dependencies are properly installed. In Ubuntu and other Debian-derived OSs, these are:
```
sudo apt install -y build-essential cmake gcc libclang-dev libudev-dev libsystemd-dev \
                    libnl-3-dev libnl-route-3-dev ninja-build pkg-config valgrind \
                    python3-dev cython3 python3-docutils pandoc
```
Building from source is different from the previous two approaches in that libibverbs is linked statically and cannot detect providers at runtime. This library currently only allows the mlx5 provider.
- ~~This will enable enable mlx5dv_* features.~~ (TODO)