Gentoo Portage使用distcc编译失败：头文件差异导致的问题

DevOps 小满

2026-6-17

问题

本地是硬件配置一般的Gentoo Linux系统，远程是Ubuntu系统，两台机器都装了distcc来缩短编译时间，多数情况正常，但编译../../deps/v8/third_party/abseil-cpp/absl/crc/crc32c.cc时失败。

错误信息如下：

distcc[310] ERROR: compile ../../deps/v8/third_party/abseil-cpp/absl/crc/crc32c.cc on 192.168.0.4 failed
distcc[310] (dcc_build_somewhere) Warning: remote compilation of '../../deps/v8/third_party/abseil-cpp/absl/crc/crc32c.cc' failed, retrying locally
distcc[310] (dcc_mark_timefile) mark /var/tmp/portage/.distcc/lock/backoff_tcp_192.168.0.4_3632_0
distcc[310] (dcc_build_somewhere) ERROR: failed to distribute and fallbacks are disabled
In file included from /usr/lib/gcc/x86_64-linux-gnu/13/include/immintrin.h:129,
                 from /usr/lib/gcc/x86_64-linux-gnu/13/include/x86intrin.h:32,
                 from ../../deps/v8/third_party/abseil-cpp/absl/crc/internal/crc32_x86_arm_combined_simd.h:33,
                 from ../../deps/v8/third_party/abseil-cpp/absl/crc/internal/crc32c_inline.h:22,
                 from ../../deps/v8/third_party/abseil-cpp/absl/crc/crc32c.h:31,
                 from ../../deps/v8/third_party/abseil-cpp/absl/crc/crc32c.cc:15:
/usr/lib/gcc/x86_64-linux-gnu/13/include/amxtileintrin.h: In function ‘void _tile_loadconfig(const void*)’:
/usr/lib/gcc/x86_64-linux-gnu/13/include/amxtileintrin.h:42:3: error: ‘__builtin_ia32_ldtilecfg’ was not declared in this scope; did you mean ‘__builtin_ia32_rdtscp’?
   42 |   __asm__ volatile ("ldtilecfg\t%X0" :: "m" (*((const void **)__config)));
      |   ^~~~~~~~~~~~~~~~~~~~~~~~
      |   __builtin_ia32_rdtscp
/usr/lib/gcc/x86_64-linux-gnu/13/include/amxtileintrin.h: In function ‘void _tile_storeconfig(void*)’:
/usr/lib/gcc/x86_64-linux-gnu/13/include/amxtileintrin.h:49:3: error: ‘__builtin_ia32_sttilecfg’ was not declared in this scope; did you mean ‘__builtin_ia32_stui’?
   49 |   __asm__ volatile ("sttilecfg\t%X0" : "=m" (*((void **)__config)));
      |   ^~~~~~~~~~~~~~~~~~~~~~~~
      |   __builtin_ia32_stui

已匹配GCC/G++版本及目标三元组，仅差异：本地GCC是针对硬件定制编译，远程为通用二进制版本。检查发现/usr/lib/gcc/x86_64-linux-gnu/13/include/amxtileintrin.h存在不同：

本地版本：

#if defined(__x86_64__)
extern __inline void
__attribute__((__gnu_inline__, __always_inline__, __artificial__))
_tile_loadconfig (const void *__config)
{
  __builtin_ia32_ldtilecfg (__config);
}

远程版本：

#if defined(__x86_64__) 
extern __inline void 
__attribute__((__gnu_inline__, __always_inline__, __artificial__)) 
_tile_loadconfig (const void *__config) 
{ 
  __asm__ volatile ("ldtilecfg\t%X0" :: "m" (*((const void **)__config))); 
}

疑问：问题源于本地GCC及头文件针对本机定制，但distcc本应处理这类差异，为何仍出现问题？该如何解决？

附本地与远程GCC详细配置：

本地gcc --verbose输出：

Using built-in specs.
COLLECT_GCC=gcc
COLLECT_LTO_WRAPPER=/usr/libexec/gcc/x86_64-linux-gnu/13/lto-wrapper
Target: x86_64-linux-gnu
Configured with: /var/tmp/portage/sys-devel/gcc-13.3.1_p20240614/work/gcc-13-20240614/configure --host=x86_64-linux-gnu --build=x86_64-linux-gnu --prefix=/usr --bindir=/usr/x86_64-linux-gnu/gcc-bin/13 --includedir=/usr/lib/gcc/x86_64-linux-gnu/13/include --datadir=/usr/share/gcc-data/x86_64-linux-gnu/13 --mandir=/usr/share/gcc-data/x86_64-linux-gnu/13/man --infodir=/usr/share/gcc-data/x86_64-linux-gnu/13/info --with-gxx-include-dir=/usr/lib/gcc/x86_64-linux-gnu/13/include/g++-v13 --disable-silent-rules --disable-dependency-tracking --with-python-dir=/share/gcc-data/x86_64-linux-gnu/13/python --enable-languages=c,c++,fortran --enable-obsolete --enable-secureplt --disable-werror --with-system-zlib --enable-nls --without-included-gettext --disable-libunwind-exceptions --enable-checking=release --with-bugurl=https://bugs.gentoo.org/ --with-pkgversion='Gentoo 13.3.1_p20240614 p1' --with-gcc-major-version-only --enable-libstdcxx-time --enable-lto --disable-libstdcxx-pch --enable-shared --enable-threads=posix --enable-__cxa_atexit --enable-clocale=gnu --enable-multilib --with-multilib-list=m32,m64 --disable-fixed-point --enable-targets=all --enable-libgomp --disable-libssp --disable-libada --enable-cet --disable-systemtap --disable-valgrind-annotations --disable-vtable-verify --disable-libvtv --with-zstd --without-isl --enable-default-pie --enable-default-ssp --disable-fixincludes --with-build-config=bootstrap-cet
Thread model: posix
Supported LTO compression algorithms: zlib zstd
gcc version 13.3.1 20240614 (Gentoo 13.3.1_p20240614 p1) 
Using built-in specs.

远程gcc --verbose输出：

Using built-in specs.
COLLECT_GCC=gcc
COLLECT_LTO_WRAPPER=/usr/libexec/gcc/x86_64-linux-gnu/13/lto-wrapper
OFFLOAD_TARGET_NAMES=nvptx-none:amdgcn-amdhsa
OFFLOAD_TARGET_DEFAULT=1
Target: x86_64-linux-gnu
Configured with: ../src/configure -v --with-pkgversion='Ubuntu 13.2.0-4ubuntu3' --with-bugurl=file:///usr/share/doc/gcc-13/README.Bugs --enable-languages=c,ada,c++,go,d,fortran,objc,obj-c++,m2 --prefix=/usr --with-gcc-major-version-only --program-suffix=-13 --program-prefix=x86_64-linux-gnu- --enable-shared --enable-linker-build-id --libexecdir=/usr/libexec --without-included-gettext --enable-threads=posix --libdir=/usr/lib --enable-nls --enable-bootstrap --enable-clocale=gnu --enable-libstdcxx-debug --enable-libstdcxx-time=yes --with-default-libstdcxx-abi=new --enable-gnu-unique-object --disable-vtable-verify --enable-plugin --enable-default-pie --with-system-zlib --enable-libphobos-checking=release --with-target-system-zlib=auto --enable-objc-gc=auto --enable-multiarch --disable-werror --enable-cet --with-arch-32=i686 --with-abi=m64 --with-multilib-list=m32,m64,mx32 --enable-multilib --with-tune=generic --enable-offload-targets=nvptx-none=/build/gcc-13-XYspKM/gcc-13-13.2.0/debian/tmp-nvptx/usr,amdgcn-amdhsa=/build/gcc-13-XYspKM/gcc-13-13.2.0/debian/tmp-gcn/usr --enable-offload-defaulted --without-cuda-driver --enable-checking=release --build=x86_64-linux-gnu --host=x86_64-linux-gnu --target=x86_64-linux-gnu --with-build-config=bootstrap-lto-lean --enable-link-serialization=2
Thread model: posix
Supported LTO compression algorithms: zlib zstd
gcc version 13.2.0 (Ubuntu 13.2.0-4ubuntu3)

解决方案

问题原因

distcc的核心逻辑是仅传递编译命令和源代码，远程机器使用自身的头文件与库完成编译，不会同步本地的头文件到远程。你的本地Gentoo GCC是针对硬件定制编译的，大概率启用了AMX（高级矩阵扩展）相关的内置函数支持；而远程Ubuntu的通用GCC版本没有对应实现，当本地传递的编译参数触发远程头文件里的汇编代码时，远程GCC无法识别对应的内置函数，最终导致编译失败。

另外，本地GCC版本是13.3.1，远程是13.2.0，小版本差异也会导致头文件实现不同——distcc要求两端GCC版本完全一致，而非仅大版本匹配。

解决方法

统一GCC版本：将远程Ubuntu的GCC升级到与本地一致的13.3.1，或是把本地Gentoo的GCC降级到13.2.0，确保两端GCC版本完全相同，头文件实现一致。
禁用AMX编译选项：编译时添加-mno-amx-tile参数，关闭AMX指令集支持，这样编译过程不会触发amxtileintrin.h中的代码，规避头文件差异问题。可以临时修改编译命令，或是在项目的Makefile/CMakeLists.txt中添加该参数。
跳过单个文件的远程编译：如果仅该文件编译出错，可设置distcc不对其进行远程编译。比如在Makefile中针对目标文件指定本地编译：
```
../../deps/v8/third_party/abseil-cpp/absl/crc/crc32c.o: CC := gcc
```
同步头文件到远程：将本地的amxtileintrin.h替换远程机器上的同名文件，确保头文件实现一致。但该方法属于临时方案，后续GCC更新会覆盖修改。
开启distcc本地 fallback：修改distcc配置，启用fallback功能（默认可能关闭），远程编译失败时自动切换到本地编译，避免直接报错。可设置环境变量DISTCC_FALLBACK=1，或是修改distcc的配置文件。

内容的提问来源于stack exchange，提问作者S.Y. Kim

Gentoo Portage使用distcc编译失败：头文件差异导致的问题

问题原因 #

解决方法 #

问题原因

解决方法