fabtests
Fabtests provides a set of examples that uses libfabric -- a high-performance fabric software library.
Building fabtests
Distribution tarballs are available from the Github releases tab.
If you are building Fabtests from a developer Git clone, you must first run the
autogen.sh script. This will invoke the GNU Autotools to bootstrap Fabtests'
configuration and build mechanisms. If you are building Fabtests from an
official distribution tarball, there is no need to run autogen.sh; Fabtests
distribution tarballs are already bootstrapped for you.
Fabtests relies on being able to find an installed version of Libfabric. In
some cases, Libfabric may be in default compiler / linker search paths, and you
don't need to tell Fabtests where to find it. In other cases, you may need to
tell Fabtests where to find the installed Libfabric's header and library files
using the --with-libfabric=<directory> option, described below.
Configure options
The configure script has many built in options (see ./configure --help). Some useful options are:
--prefix=<directory>
By default make install will place the files in the /usr tree.
The --prefix option specifies that the Fabtests files should be
installed into the tree specified by named <directory>. The
executables will be located at <directory>/bin.
--with-libfabric=<directory>
Specify the directory where the Libfabric library and header files are
located. This is necessary if Libfabric was installed in a location
where the compiler and linker will not search by default. The
Libfabric library will be searched for in <directory>/lib, and
headers will be searched for in <directory>/include.
--with-valgrind=<directory>
Directory where valgrind is installed. If valgrind is found, then valgrind annotations are enabled. This may incur a performance penalty.
Examples
Consider the following example:
$ ./configure --with-libfabric=/opt/libfabric --prefix=/opt/fabtests && make -j 32 && sudo make install
This will tell the Fabtests to look for Libfabric libraries in the
/opt/libfabric tree, and to install the Fabtests in the /opt/fabtests tree.
Alternatively:
$ ./configure --prefix=/opt/fabtests && make -j 32 && sudo make install
Tells the Fabtests that it should be able to find the Libfabric header files
and libraries in default compiler / linker search paths (configure will abort
if it is not able to find them), and to install Fabtests in /opt/fabtests.