Skip to content

Commit 48a33ee

Browse files
committed
README: Remove all references to --with-verbs[*]
Now that all use of libibverbs is gone from Open MPI, and all verbs-based configury is also removed, update README to remove all references to --with-verbs. Signed-off-by: Jeff Squyres <jsquyres@cisco.com>
1 parent 59c8ab6 commit 48a33ee

File tree

1 file changed

+0
-45
lines changed

1 file changed

+0
-45
lines changed

README

Lines changed: 0 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1193,51 +1193,6 @@ NETWORKING SUPPORT / OPTIONS
11931193
--with-usnic
11941194
Abort configure if Cisco usNIC support cannot be built.
11951195

1196-
--with-verbs=<directory>
1197-
Specify the directory where the verbs (also known as OpenFabrics
1198-
verbs, or Linux verbs, and previously known as OpenIB) libraries and
1199-
header files are located. This option is generally only necessary
1200-
if the verbs headers and libraries are not in default
1201-
compiler/linker search paths.
1202-
1203-
The Verbs library usually implies operating system bypass networks,
1204-
such as InfiniBand, usNIC, iWARP, and RoCE (aka "IBoIP").
1205-
1206-
--with-verbs-libdir=<directory>
1207-
Look in directory for the verbs libraries. By default, Open MPI
1208-
will look in <verbs_directory>/lib and <verbs_ directory>/lib64,
1209-
which covers most cases. This option is only needed for special
1210-
configurations.
1211-
1212-
--with-verbs-usnic
1213-
Note that this option is no longer necessary in recent Linux distro
1214-
versions. If your Linux distro uses the "rdma-core" package (instead
1215-
of a standalone "libibverbs" package), not only do you not need this
1216-
option, you shouldn't use it, either. More below.
1217-
1218-
This option will activate support in Open MPI for disabling a
1219-
dire-sounding warning message from libibverbs that Cisco usNIC
1220-
devices are not supported (because Cisco usNIC devices are supported
1221-
through libfabric, not libibverbs). This libibverbs warning can
1222-
also be suppressed by installing the "no op" libusnic_verbs plugin
1223-
for libibverbs (see https://github.com/cisco/libusnic_verbs, or
1224-
download binaries from cisco.com).
1225-
1226-
This option is disabled by default for two reasons:
1227-
1228-
1. It causes libopen-pal.so to depend on libibverbs.so, which is
1229-
undesirable to many downstream packagers.
1230-
2. As mentioned above, recent versions of the libibverbs library
1231-
(included in the "rdma-core" package) do not have the bug that
1232-
will emit dire-sounding warnings about usnic devices. Indeed,
1233-
the --with-verbs-usnic option will enable code in Open MPI that
1234-
is actually incompatible with rdma-core (i.e., cause Open MPI to
1235-
fail to compile).
1236-
1237-
If you enable --with-verbs-usnic and your system uses the rdma-core
1238-
package, configure will safely abort with a helpful message telling
1239-
you that you should not use --with-verbs-usnic.
1240-
12411196

12421197
RUN-TIME SYSTEM SUPPORT
12431198

0 commit comments

Comments
 (0)