Knowledge Base:LLVM undefined symbol

From Gentoo Wiki
Jump to:navigation Jump to:search

This issue occurs with the LLVM 17+ toolchain enforcing stricter coding practices. As described by Oracle:

After all input files have been read and all symbol resolution is complete, the link-editor searches the internal symbol table for any symbol references that have not been bound to symbol definitions. These symbol references are referred to as undefined symbols. The effect of these undefined symbols on the link-edit process can vary according to the type of output file being generated, and possibly the type of symbol.

This issues should be checked if they have been reported on and if not, must be reported so they can get fixed.


There is a workaround which can be used after checking and if needed, reporting the bug.


First, create the following file in /etc/portage/env/undefined.conf

It may be required to create the env directory with:

root #mkdir /etc/portage/env
FILE /etc/portage/env/undefined.confFileBox undefined.conf
LDFLAGS="{$LDFLAGS} -Wl,—undefined-version"

Next, create an /etc/portage/package.env/undefined and add the app-category/package-version to the file (This guide will use media-libs/mesa-23.3.1 as an example.)

It may be required to create the package.env directory with:

root #mkdir /etc/portage/package.env
FILE /etc/portage/package.env/undefinedFileBox undefined
media-libs/mesa-23.3.1 undefined.conf

It is now possible to run the emerge command again for the program to install succesfully free from this issue.

root #emerge --ask --verbose --oneshot media-libs/mesa