From cdda358e214af445b3c4c5d2a1a526797d2a090c Mon Sep 17 00:00:00 2001 From: DRC Date: Fri, 6 Sep 2024 12:46:21 -0400 Subject: [PATCH] Document STAR-CCM+ application recipe Refer to #214 --- doc/apprecipes.txt | 8 ++++++++ doc/index.html | 9 ++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/doc/apprecipes.txt b/doc/apprecipes.txt index dc29d595..b9216d57 100644 --- a/doc/apprecipes.txt +++ b/doc/apprecipes.txt @@ -193,6 +193,14 @@ to ''LD_LIBRARY_PATH'', which is most easily accomplished with \ ''vglrun -ld'', or to disable VirtualGL's ''dlopen()'' interposer. \ | +| Siemens Simcenter STAR-CCM+ | v19.xx | Linux \ + | {pcode: vglrun __path-to-STAR-CCM+-scripts__/starccm+ \\}{nl} \ + '' -clientldpreload libdlfaker.so:libvglfaker.so'' \ + | Failing to pass the aforementioned arguments to the STAR-CCM+ startup \ + script prevents VirtualGL from being loaded into the application, \ + resulting in unaccelerated OpenGL and error messages such as "ERROR: in \ + isDisplayExcluded-- XX: Unexpected NULL condition" \ + | | Tecplot 360 | 2011 and earlier | Linux \ | Set the ''VGL_GLFLUSHTRIGGER'' environment variable to ''0'' prior to \ launching the application with ''vglrun'' \ diff --git a/doc/index.html b/doc/index.html index fccd12e0..55da5916 100644 --- a/doc/index.html +++ b/doc/index.html @@ -3,7 +3,7 @@ - + User’s Guide for VirtualGL 3.1.2 @@ -2196,6 +2196,13 @@

14 Other Application Recipes

vglrun -ld path-to-PyTorch-libs application
or
vglrun -nodl application
The PyTorch module and its dependency libraries are linked with a run-time library search path (rpath) of $ORIGIN, which would normally have the same effect as adding the directory in which the module is installed (for instance, /usr/local/lib64/python3.6/site-packages/torch/lib) to LD_LIBRARY_PATH. However, when VirtualGL is interposing the dlopen() function (which it does by default), this causes the actual dlopen() system calls to come from libdlfaker.so, so $ORIGIN will resolve to the directory in which the VirtualGL faker libraries are installed. This causes the dlopen() calls within the PyTorch module to fail. The workaround is to add the PyTorch module path to LD_LIBRARY_PATH, which is most easily accomplished with vglrun -ld, or to disable VirtualGL’s dlopen() interposer. + + Siemens Simcenter STAR-CCM+ + v19.xx + Linux + vglrun path-to-STAR-CCM+-scripts/starccm+ \
       -clientldpreload libdlfaker.so:libvglfaker.so + Failing to pass the aforementioned arguments to the STAR-CCM+ startup script prevents VirtualGL from being loaded into the application, resulting in unaccelerated OpenGL and error messages such as “ERROR: in isDisplayExcluded– XX: Unexpected NULL condition” + Tecplot 360 2011 and earlier