diff --git a/openmp/docs/SupportAndFAQ.rst b/openmp/docs/SupportAndFAQ.rst --- a/openmp/docs/SupportAndFAQ.rst +++ b/openmp/docs/SupportAndFAQ.rst @@ -329,3 +329,14 @@ stack memory during execution and crash. The environment variable ``LIBOMPTARGET_STACK_SIZE`` can be used to increase the stack size if this occurs. + +Q: Are libomptarget and plugins backward compatible? +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +No. libomptarget and plugins are now built as LLVM libraries starting from LLVM +15. Because LLVM libraries are not backward compatible, libomptarget and plugins +are not as well. Given that fact, the interfaces between 1) the Clang compiler +and libomptarget, 2) the Clang compiler and device runtime library, and 3) libomptarget +and plugins are not guaranteed to be compatible. Using the Clang compiler and +runtime libraries from the same build is always recommended. If not, it is up to +users to ensure compatibility.