5.7.5. Linker “rpath” and “runpath” functionality — OpenPMIx 5.0.10 documentation

# 5.7.5. Linker “rpath” and “runpath” functionality

PMIx v5.0.10 is composed of multiple libraries that depend on each other.

When built from official distribution tarballs, PMIx is built with the following versions of the GNU Autotools:

- Autoconf 2.69.0

- Automake 1.13.4

- Libtool 2.4.2

This set of GNU Autotools invokes the `libtool` executable to build PMIx’s libraries and executables with the -rpath CLI option.

The behavior of `libtool -rpath ...` is, unfortunately, highly system-dependent. In conjunction with compiler-, linker-, and other system-level settings, the end result may be to effect “rpath” behavior, “runpath” behavior, or possibly even neither behavior.

Although the specific behavior of `libtool -rpath ..` is outside the scope of this documentation, you can run commands such as `readelf -d ...` to find out with which behavior your PMIx was built.

For example:

    shell$ ./configure --prefix=/opt/pmix/ ...
    ...
    shell$ make -j 32 all && make install
    ...
    shell$ readelf -d /opt/pmix/lib/libmpi.so | egrep -i 'rpath|runpath'
     0x000000000000001d (RUNPATH)            Library runpath: [/opt/pmix/lib]

The above output indicates that `libpmix.so` was built with “runpath” support, whereas output like this:

    shell$ readelf -d /opt/pmix/lib/libpmix.so | egrep -i 'rpath|runpath'
     0x000000000000000f (RPATH)              Library rpath: [/opt/pmix/lib]

indicates that `libpmix.so` was built with “rpath” support.

Note

If you want to utilize additional compiler or linker flags (such as runpath flags) when building PMIx, you can specify these flags on the configure command line.

For example, if invoking `libtool -rpath ...` on your system actually effects “rpath” behavior, and you wish to effect “runpath” behavior, you could set `LDFLAGS` when invoking `configure`, like this:

    shell$ ./configure LDFLAGS=-Wl,--enable-new-dtags ...