[Openmp-commits] [openmp] ed8943c - [OpenMP][NFC] Adding FAQ Entry for errors with static libraries

[via Openmp-commits]

Author: Joseph Huber
Date: 2021-02-02T10:50:22-05:00
New Revision: ed8943c08769082f4ce5e7682a4ff53ae25bee36

URL: https://github.com/llvm/llvm-project/commit/ed8943c08769082f4ce5e7682a4ff53ae25bee36
DIFF: https://github.com/llvm/llvm-project/commit/ed8943c08769082f4ce5e7682a4ff53ae25bee36.diff

LOG: [OpenMP][NFC] Adding FAQ Entry for errors with static libraries

Added: 
    

Modified: 
    openmp/docs/SupportAndFAQ.rst

Removed: 
    


################################################################################
diff  --git a/openmp/docs/SupportAndFAQ.rst b/openmp/docs/SupportAndFAQ.rst
index 73a28617c698..66a808ef2fa8 100644
--- a/openmp/docs/SupportAndFAQ.rst
+++ b/openmp/docs/SupportAndFAQ.rst
@@ -117,4 +117,21 @@ An experimental way to debug these errors is to use :ref:`remote process
 offloading <remote_offloading_plugin>`.
 By using ``libomptarget.rtl.rpc.so`` and ``openmp-offloading-server``, it is
 possible to explicitly perform memory transfers between processes on the host
-CPU and run sanitizers while doing so in order to catch these errors.
\ No newline at end of file
+CPU and run sanitizers while doing so in order to catch these errors.
+
+Q: Why does my application say "Named symbol not found" and abort when I run it?
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This is most likely caused by trying to use OpenMP offloading with static
+libraries. Static libraries do not contain any device code, so when the runtime
+attempts to execute the target region it will not be found and you will get an
+an error like this.
+
+.. code-block:: text
+
+   CUDA error: Loading '__omp_offloading_fd02_3231c15__Z3foov_l2' Failed
+   CUDA error: named symbol not found
+   Libomptarget error: Unable to generate entries table for device id 0.
+
+Currently, the only solution is to change how the application is built and avoid
+the use of static libraries.