Highway项目在s390x架构下的BitPermute测试问题分析

问题背景

在Fedora Rawhide操作系统中，使用Clang 18.1.6编译器在s390x架构上运行Highway项目的测试时，发现BitPermute测试组中的TestAllBitShuffle/EMU128测试用例失败。测试输出显示，预期的64位整数值与实际得到的值不匹配，导致测试中止。

错误现象

测试失败的具体表现为：

• 预期值：0x00000000000000d1
• 实际值：0x00000000000000e9

这种不匹配发生在EMU128目标的i64x2向量的第一个通道(lane 0)上。测试框架在bit_permute_test.cc文件的第68行检测到这一差异并中止了测试过程。

根本原因分析

经过深入调查，发现这个问题源于两个层面的因素：

1. LLVM编译器代码生成缺陷：在s390x架构的Z14/Z15处理器上，LLVM编译器将vec_perm内部函数转换为@llvm.s390.vperm LLVM IR内部函数时存在代码生成错误。这个缺陷会导致在某些情况下生成的机器码不能正确执行位排列操作。

2. Highway实现问题：在generic_ops-inl.h文件中的BitShuffle实现存在一个bug，这个bug在EMU128目标上会触发上述编译器缺陷，导致测试失败。

解决方案

针对这个问题，开发团队采取了以下措施：

1. Highway实现修复：通过修改generic_ops-inl.h文件中的BitShuffle实现，修复了导致测试失败的根本问题。这个修复确保了即使在存在编译器缺陷的情况下，代码也能正确执行位排列操作。

2. 编译器规避方案：对于需要常量索引的情况，可以使用Clang 3+或GCC 12+提供的__builtin_shufflevector内置函数作为替代方案，绕过Z14/Z15上的vec_perm内部函数问题。

验证结果

修复后的测试验证表明：

• 在Z14处理器上使用Clang 18.1.6编译器，并启用-march=z14 -mzvector编译选项
• 除TestAllBitShuffle外的所有测试用例均能通过
• 应用BitShuffle修复后，TestAllBitShuffle测试也能成功通过

未来展望

值得注意的是，LLVM主干版本已经包含了修复这个Z14/Z15 vec_perm内部函数问题的补丁，但这个修复尚未包含在LLVM 18或更早版本中。随着编译器版本的更新，这个平台特定的问题将得到彻底解决。

对于开发者来说，这个案例提醒我们在跨平台开发时需要特别注意：

1. 编译器特定实现的差异
2. 不同架构下内部函数的行为变化
3. 测试覆盖的重要性，特别是在仿真目标(如EMU128)上的验证

通过这次问题的分析和解决，Highway项目在s390x架构上的稳定性和可靠性得到了进一步提升。