Failed to load plugin 'usdSbsar'

[sdromero01]

I'm trying to load only the usdSbsar plug-in to a renderer. I only need sbsar and don't need the tests. But I keep getting this error:

Coding Error: in _Load at line 243 of /dependencies/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 353 of /dependencies/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Coding Error: in _Load at line 243 of /dependencies/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 353 of /dependencies/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Coding Error: in _Load at line 243 of /dependencies/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 353 of /dependencies/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Warning: in _ReportErrors at line 3253 of /dependencies/pxr/usd/usd/stage.cpp -- Could not load sublayer @/share/USD-Fileformat-plugins/sbsar/data/sbsar/CardBoard.sbsar@ of layer @/share/USD-Fileformat-plugins/sbsar/data/simplest.usda@ -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'; Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'; Cannot determine file format for @/share/USD-Fileformat-plugins/sbsar/data/sbsar/CardBoard.sbsar:SDF_FORMAT_ARGS:target=usd@; skipping. (instantiating stage on stage @/share/USD-Fileformat-plugins/sbsar/data/simplest.usda@ <0x58bcb2311d70>)

System info (on docker)

• Ubuntu 22.04.5 LTS
• Python 3.10.12
• cmake version 3.31.6
• OpenUSD 25.08
• Ubuntu clang version 14.0.0-1ubuntu1.1, Thread model: posix
• gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0

Steps to Reproduce:

1. Use latest OpenUSD release: wget https://github.com/PixarAnimationStudios/OpenUSD/archive/refs/tags/v25.08.tar.gz then tar -xzvf v25.08.tar.gz
2. Build OpenUSD with command python3 ./build_scripts/build_usd.py "docker-usd" -v --build-variant release --materialx --tools --usd-imaging --usdview --embree --openimageio --opencolorio --draco --jobs 1
3. Installed Adobe Substance 3D Materials SDK for Ubuntu (v9.2.3) from the website then ran tar -xf substance-ubuntu22-v9.2.3-04c69995.tar.bz2
4. git clone git@github.com:adobe/USD-Fileformat-plugins.git
5. cmake -S . -B build -DCMAKE_INSTALL_PREFIX=bin -DCMAKE_BUILD_TYPE=Release -Dpxr_ROOT=$USD_PATH -Dsubstance_DIR=/share/substance-ubuntu22-v9.2.3-04c69995 -DUSD_FILEFORMATS_ENABLE_SBSAR=ON -DUSD_FILEFORMATS_ENABLE_FBX=OFF -DUSD_FILEFORMATS_ENABLE_GLTF=OFF -DUSD_FILEFORMATS_ENABLE_OBJ=OFF -DUSD_FILEFORMATS_ENABLE_PLY=OFF -DUSD_FILEFORMATS_ENABLE_SPZ=OFF -DUSD_FILEFORMATS_ENABLE_STL=OFF
6. cmake --build build --config release then cmake --install build --config release
7. Environment variables (as listed in the env file for docker image)
   USD_PATH=/dependencies/docker-usd/
   pxr_DIR=/dependencies/docker-usd/
   OSL_PATH=/OpenShadingLanguage/dist
   OSL_DIR=/OpenShadingLanguage/dist/lib/cmake/OSL
   PYTHONPATH=/dependencies/docker-usd/lib/python
   PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/dependencies/docker-usd/bin:/share/USD-Fileformat-plugins/bin/bin:/share/USD-Fileformat-plugins/bin/plugin/usd
   CORTEX_PATH=/cortex
   CMAKE_PREFIX_PATH=/oidn-2.3.3.x86_64.linux
   OpenImageDenoise_DIR=/oidn-2.3.3.x86_64.linux/lib/cmake/OpenImageDenoise-2.3.3
   OpenImageIO_DIR=/dependencies/docker-usd/lib/cmake/OpenImageIO
   LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/dependencies/docker-usd/lib:/share/USD-Fileformat-plugins/bin/lib
   OpenSubdiv_DIR=/dependencies/docker-usd/lib/cmake/OpenSubdiv
   CPLUS_INCLUDE_PATH=/usr/include/python3.10/
   PXR_PLUGINPATH_NAME=/share/USD-Fileformat-plugins/bin/plugin/usd
8. When I built my renderer with the plug-in, I'd get this error:
   [ 94%] Linking CXX executable bin/renderer
/usr/bin/ld: CMakeFiles/renderer.dir/src/main.cpp.o: undefined reference to symbol '_ZN3tbb10interface78internal15task_arena_base21internal_current_slotEv'
/usr/bin/ld: /dependencies/docker-usd/lib/libtbb.so.2: error adding symbols: DSO missing from command line collect2: error: ld returned 1 exit status
gmake[2]: *** [CMakeFiles/renderer.dir/build.make:217: bin/renderer] Error 1
gmake[1]: *** [CMakeFiles/Makefile2:187: CMakeFiles/renderer.dir/all] Error 2
gmake: *** [Makefile:91: all] Error 2
   which I resolved by entering export LDFLAGS="-Wl,--copy-dt-needed-entries" in the command line.

Could the USD version be the reason for the error or did I do something wrong? The minimum version of usd I could use on the renderer is 25.05.

[sdromero01]

I tried to build this with the monolithic USD build that I have but got the same error:

Coding Error: in _Load at line 243 of /OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 352 of /OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Coding Error: in _Load at line 243 of /OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 352 of /OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Coding Error: in _Load at line 243 of /OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 352 of /OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Warning: in _ReportErrors at line 3304 of /OpenUSD/pxr/usd/usd/stage.cpp -- Could not load sublayer @/share/USD-Fileformat-plugins/sbsar/data/sbsar/CardBoard.sbsar@ of layer @/share/USD-Fileformat-plugins/sbsar/data/simplest.usda@ -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'; Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'; Cannot determine file format for @/share/USD-Fileformat-plugins/sbsar/data/sbsar/CardBoard.sbsar:SDF_FORMAT_ARGS:target=usd@; skipping. (instantiating stage on stage @/share/USD-Fileformat-plugins/sbsar/data/simplest.usda@ <0x5b891bf64410>)

Steps to recreate:

1. In sbsar/CMakeLists.txt, add this below find(ZLIB REQUIRED)

find_package(OpenGL REQUIRED)
find_package(X11 REQUIRED)

2. In sbsar/src/CMakeLists.txt, change target_link_libraries to

target_link_libraries(
        ${PLUGIN_NAME}
        PUBLIC
        ${PXR_LIBRARIES}
        ${SUBSTANCE_TARGETS}
        fileformatUtils
)

3. Run in command-line (I also did this with non-monolithic build, I just forgot to include it)

sudo apt update
sudo apt install libgl1-mesa-dev mesa-common-dev

4. Exclude tests from build command cmake -S . -B build -DCMAKE_INSTALL_PREFIX=bin -DCMAKE_BUILD_TYPE=Release -Dpxr_ROOT=$USD_PATH -Dsubstance_DIR=/share/substance-ubuntu22-v9.2.3-04c69995 -DUSD_FILEFORMATS_ENABLE_SBSAR=ON -DUSD_FILEFORMATS_ENABLE_FBX=OFF -DUSD_FILEFORMATS_ENABLE_GLTF=OFF -DUSD_FILEFORMATS_ENABLE_OBJ=OFF -DUSD_FILEFORMATS_ENABLE_PLY=OFF -DUSD_FILEFORMATS_ENABLE_SPZ=OFF -DUSD_FILEFORMATS_ENABLE_STL=OFF -DUSD_FILEFORMATS_FETCH_GTEST=OFF -DUSD_FILEFORMATS_FETCH_TINYGLTF=OFF -DUSD_FILEFORMATS_FETCH_HAPPLY=OFF -DUSD_FILEFORMATS_FETCH_FMT=OFF -DUSD_FILEFORMATS_FETCH_FASTFLOAT=OFF -DUSD_FILEFORMATS_BUILD_TESTS=OFF
5. cmake --build build --config release then cmake --install build --config release
6. Environment variables (as listed in the env file for docker image)

USD_PATH=/v25.05
OSL_PATH=/OpenShadingLanguage/dist
CORTEX_PATH=/cortex
CMAKE_PREFIX_PATH=/oidn-2.3.3.x86_64.linux
OpenImageDenoise_DIR=/oidn-2.3.3.x86_64.linux/lib/cmake/OpenImageDenoise-2.3.3
OpenImageIO_DIR=/v25.05/lib/cmake/OpenImageIO
OSL_DIR=/OpenShadingLanguage/dist/lib/cmake/OSL
pxr_DIR=/v25.05
OpenSubdiv_DIR=/v25.05/lib/cmake/OpenSubdiv
CPLUS_INCLUDE_PATH=/usr/include/python3.10/
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/v25.05/bin:/share/USD-Fileformat-plugins/bin/bin:/share/USD-Fileformat-plugins/bin/plugin/usd
PYTHONPATH=/v25.05/lib/python
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/v25.05/lib:/share/USD-Fileformat-plugins/bin/lib
CPLUS_INCLUDE_PATH=/usr/include/python3.10/
PXR_PLUGINPATH_NAME=/share/USD-Fileformat-plugins/bin/plugin/usd

[dstover11]

Hi sdromero01,
Thank you for the report. One thing we noticed while reading through this report is that the missing symbol references 25.08, but your environment lists the version at 25.05. You also state that you downloaded 25.08. Could this possibly be a version mismatch? Could you please clean your build and try a clean build/install with a consistent version of USD?

[sdromero01]

Hi thank you for your response! I followed your advice and removed all versions of USD on my machine except for 25.05 and still got the same error.

For more context, 25.05 is my monolithic build. I built 25.08 for a non-monolithic build when I realized the plugin wasn't linking to a monolithic usd. But then I found the PR for linking to a monolithic build so I just copied some of the code and attempted to load the plugin with 25.05. The usd build 25.05 is on a docker image so when I'd run the docker with the intention of using 25.05 I would just omit --v /docker-usd:/docker-usd which is 25.08. I also have two different .env files for each USD version.

But to be sure, I removed 25.08 (/docker-usd) from my machine because I'd really prefer for a monolithic build to work for this. I echo my $USD_PATH variable to be sure I'm using the correct version and it does print v25.05. Then I removed the build and bin folders in USD-Fileformat-plugins and rebuilt everything with the same build commands I listed in my previous comment. I also did the same for my renderer. I also removed substance-ubuntu22-v9.2.3-04c69995 and extracted its tarball again.

However, I still have the same error with the v0_25_8 in the undefined symbol:

2025-10-03T15:33:14 [ INFO ]    [API] ===== LoadUSDFile =====
Coding Error: in _Load at line 243 of /OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 352 of /OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Coding Error: in _Load at line 243 of /OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 352 of /OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Coding Error: in _Load at line 243 of /OpenUSD/pxr/base/plug/plugin.cpp -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'
Coding Error: in Create at line 352 of /OpenUSD/pxr/usd/ar/resolver.cpp -- Failed to load plugin usdSbsar for SBSARPackageResolver
Warning: in _ReportErrors at line 3304 of /OpenUSD/pxr/usd/usd/stage.cpp -- Could not load sublayer @/share/USD-Fileformat-plugins/sbsar/data/sbsar/CardBoard.sbsar@ of layer @/share/USD-Fileformat-plugins/sbsar/data/simplest.usda@ -- Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'; Failed to load plugin 'usdSbsar': /share/USD-Fileformat-plugins/bin/lib/libfileformatUtils.so: undefined symbol: _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE in '/share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so'; Cannot determine file format for @/share/USD-Fileformat-plugins/sbsar/data/sbsar/CardBoard.sbsar:SDF_FORMAT_ARGS:target=usd@; skipping. (instantiating stage on stage @/share/USD-Fileformat-plugins/sbsar/data/simplest.usda@ <0x6534c5d750b0>)

If it helps, this is how USD was built in the Dockerfile around four months ago when the latest version was 25.05.

RUN git clone --depth 1 https://github.com/PixarAnimationStudios/OpenUSD.git && \
    python3 OpenUSD/build_scripts/build_usd.py "v25.05" -v --build-variant release --build-monolithic --materialx --tools --usd-imaging --usdview --embree --openimageio --opencolorio --jobs=$(nproc)

[sdromero01]

Hi again! I'd like to know if there are any updates on this? :) We're also moving towards building and loading all the plugins for the renderer so it would be great if we could complete usdSbsar.

@biffpixel

[sdromero01]

I decided to check the missing symbol in the libusdSbsar.so library, and also in the libusd_ms.so usd library.

First I ran:
nm /share/USD-Fileformat-plugins/bin/plugin/usd/libusdSbsar.so | grep ListOpIT_EE
It yielded no results.

Then I ran:
nm /v25.05/lib/libusd_ms.so | grep ListOpIT_EE
And it yielded a lot of results, interestingly it was referencing v0_25_8. This docker image I'm using was created and built OpenUSD 4 months ago when v25.05 was the latest OpenUSD release so I'm not sure why it's showing v0_25_8. Anyway it is my only existing USD build in the docker image and locally, so it should be consistent.

I ran:
nm /v25.05/lib/libusd_ms.so | grep _ZN34pxrInternal_v0_25_8__pxrReserved__lsISsEERSoS1_RKNS_9SdfListOpIT_EE
but there were no results.

[sdromero01]

I loaded the plugin successfully when I added this line to the CMakeList:
add_compile_definitions(_GLIBCXX_USE_CXX11_ABI=1)
When I tried adding -DUSD_FILEFORMATS_STANDALONE=ON to the cmake build command, it didn't work so I tried to set _GLIBCXX_USE_CXX11_ABI to 1 by default and it did work. I got the idea from this issue with a missing symbol as well.
It's a hacky solution, I'd be open to a better approach because I just added that line directly before this part:

if (UNIX AND NOT APPLE)
    # Only use this option to drive flags if set standalone. If this is
    # included in another project, don't set the ABI at all and let
    # the parent project drive it
    if (USD_FILEFORMATS_STANDALONE)
        if (USD_FILEFORMATS_ENABLE_CXX11_ABI)
            add_compile_definitions(_GLIBCXX_USE_CXX11_ABI=1)
        else ()
            add_compile_definitions(_GLIBCXX_USE_CXX11_ABI=0)
        endif ()

        set(CMAKE_POSITION_INDEPENDENT_CODE ON)
    endif ()
endif ()