5.2.3. Specifics of GCC in the GCC Toolset 15

In the GCC Toolset 15, libraries are linked by using linker scripts, which might specify some symbols through static archives. This is required to ensure compatibility with multiple versions of Red Hat Enterprise Linux. However, the linker scripts use the names of the corresponding shared object files. As a consequence, the linker uses different symbol handling rules than expected, and does not recognize symbols required by object files when the option adding the library is specified before options specifying the object files:

$ gcc-toolset-15-env gcc -lsomelib objfile.o

Using a library from the GCC Toolset 15 in this manner results in the linker error message undefined reference to symbol. To prevent this problem, follow the standard linking practice and specify the option by adding the library after the options specifying the object files:

$ gcc-toolset-15-env gcc objfile.o -lsomelib

Note that this recommendation also applies when using the base Red Hat Enterprise Linux version of GCC.