diff --git a/openmp/docs/SupportAndFAQ.rst b/openmp/docs/SupportAndFAQ.rst index 4ccc2ae2963fc4..249eb18b82a268 100644 --- a/openmp/docs/SupportAndFAQ.rst +++ b/openmp/docs/SupportAndFAQ.rst @@ -168,11 +168,18 @@ The compiled executable is dynamically linked against a host runtime, e.g. are found like any other dynamic library, by setting rpath or runpath on the executable, by setting ``LD_LIBRARY_PATH``, or by adding them to the system search. -``libomptarget.so`` has rpath or runpath (whichever the system default is) set to -``$ORIGIN``, and the plugins are located next to it, so it will find the plugins -without any environment variables set. If ``LD_LIBRARY_PATH`` is set, whether it -overrides which plugin is found depends on whether your system treats ``-Wl,-rpath`` -as RPATH or RUNPATH. +``libomptarget.so`` is only supported to work with the associated ``clang`` +compiler. On systems with globally installed ``libomptarget.so`` this can be +problematic. For this reason it is recommended to use a `Clang configuration +file `__ to +automatically configure the environment. For example, store the following file +as ``openmp.cfg`` next to your ``clang`` executable. + +.. code-block:: text + + # Library paths for OpenMP offloading. + -L '/../lib' + -Wl,-rpath='/../lib' The plugins will try to find their dependencies in plugin-dependent fashion.