Troubleshooting

Using the complete LLVM toolchain system wide in Gentoo is not standard. Knowledge on how to troubleshoot various Portage phase errors is important. The key phases are configuring, compiling, testing, and installing. Any one of these phases can fail when straying off the standard Gentoo configuration.

This page will cover how to troubleshoot and also document packages with problems. Some errors are not going to be universal since Gentoo is capable of being tailored to different uses. What may affect one machine might not affect another.

A package failed to emerge

If a package failed to emerge, take note of the phase it failed at. Did it fail at the configure phase, compile phase, or test phase? Each of these phases can fail for various reasons and troubleshooting each one takes a little finesse to find out why. When using Clang and the LLVM toolchain system wide, you will need to be able to diagnose if the failure is toolchain related or from some other cause, like a missing dependency or USE flag setting.

Troubleshooting the configure phase

The compiler failed to compile a test program!

Check the ebuild for any specific flag overriding. Most normal people don't use flags beyond -march and -O. This isn't a normal system and uses flags like -fvirtual-function-elimination which can cause a test program to fail if -flto was filtered out by the ebuild. Gentoo developers are not going to expect users to use Clang only -flto flags and aren't likely to write flag filtering to take care of those.

Solution:

• Use the workaround _FLAG_O_MATIC_ECLASS=1
• Use a local ebuild if the workaround doesn't work
• Use a local patch if the source itself is altering system flag settings

The workaround _FLAG_O_MATIC_ECLASS=1 works most of the time, but sometimes altering an offending ebuild is necessary. Worst case scenario is the filtering occurring in the actual source. For example, x11-base/xorg-server has the -flto flag and GCC link-time optimization related flags such as -fuse-linker-plugin filtered in the test sources. Since it doesn't filter Clang's, a compile phase error happens when the test phase is enabled because -fvirutal-function-elimination expects -flto, and hasn't been filtered.

---

Configure phase failures

Failures from USE flag settings

• kde-apps/kio-extras configure phase fails with USE="-X"; not reported
• kde-frameworks/kinit configure phase fails with USE="-X"; not reported
• kde-frameworks/kio configure phase fails with USE="-X"; not reported
• kde-plasma/libksysguard configure phase fails with USE="-X"; not reported
• kde-plasma/plasma-pa configure phase fails with media-sound/pulseaudio[-glib]; not reported

Compile phase failures

Failures from USE flag settings

• sys-devel/bc compile phase fails with USE="libedit"; bug 830101

Failures from missing dependencies

• sys-devel/elftoolchain compile phase requires sys-apps/groff; not reported

Test phase failures

Failures from USE flag settings

• app-crypt/p11-kit test phase fails with USE="-libffi"; bug 691640
• app-crypt/gcr test phase fails with app-cypt/gnupg[-bzip2]; not reported
• app-crypt/gnupg test phase fails with net-misc/openssh[-ssl]; bug 833148
• dev-libs/gmp test phase fails with USE="cxx"; not reported
• dev-libs/libpcre2 test phase fails with USE="jit"; not reported
• dev-libs/openssl test phase fails with USE="-weak-ssl-ciphers"; not reported
• dev-python/six test phase fails with dev-lang/python[-gdbm]; not reported
• dev-vcs/git test phase fails with USE="-iconv"; not reported
• net-misc/wget test phase fails with USE="-ipv6"; not reported

Failures from missing dependencies

• app-text/htmltidy test phase requires dev-ruby/thor; bug 824534
• dev-python/pillow test phase requires sys-libs/zlib; not reported
• dev-python/pycurl test phase requires dev-python/bottle; not reported
• dev-python/pygobject test phase requires dev-python/pycairo; not reported
• dev-ruby/mini_portile test phase requires dev-ruby/thor; not reported
• sys-fs/fuse test phase requires app-misc/hello; not reported
• sys-devel/elftoolchain test phase requires sys-apps/groff; not reported
• sys-libs/libblockdev test phase requires app-admin/sudo; not reported
• x11-libs/pango test phase requires media-fonts/cantarell; bug 816378

Packages failing tests

Less with Clang

• dev-cpp/tbb not reported

More with Clang

• dev-libs/elfutils not reported

Only with Clang

• dev-cpp/gtest not reported
• dev-libs/double-conversion not reported
• dev-libs/libfmt not reported
• media-libs/harfbuzz[abi_x86_32] bug 835457; resolved upstream

Unrelated to Clang

• app-arch/gzip not reported
• app-crypt/gcr not reported
• app-crypt/libsecret not reported
• app-portage/gemato not reported
• app-shells/fish not reported
• app-text/docbook-xsl-stylesheets not reported
• dev-cpp/tbb not reported
• dev-libs/libnl bug 840167
• dev-libs/newt not reported
• dev-util/cmake not reported
• dev-util/gtk-doc not reported
• dev-util/umockdev not reported
• x11-libs/pango bug 836317