AIX 7.1 编译 Git 2.30+ 时因缺少 `clock_gettime()` 导致链接失败

Question

在 AIX 7.1 上编译 Git 2.30+ 时，常因系统 libc 不提供 `clock_gettime()`（POSIX.1-2008 标准函数）而触发链接错误，如 `undefined symbol: clock_gettime`。该函数被 Git 新版中 `trace2`、`time.c` 等模块直接调用，用于高精度时间戳采集；但 AIX 7.1 的原生 libc 直至 7.2 才正式支持 `CLOCK_MONOTONIC` 和 `clock_gettime()`，且需显式链接 `-lrt`（而 AIX 7.1 的 `librt.a` 实为 stub 库，无实际实现）。即使启用 `_AIX_SOURCE` 或 `-D_GNU_SOURCE` 宏亦无效。典型规避方案包括：打补丁替换为 `gettimeofday()` + 伪单调逻辑、引入兼容层（如 `compat/clock-gettime.c`）、或升级至 AIX 7.2+ 并配置 `--with-libpcre --with-libiconv --with-curl` 等依赖后重新编译。此问题凸显了 Git 对现代 POSIX 接口的强依赖与老旧企业级 UNIX 平台兼容性之间的张力。

Answer 1

```html

一、现象层：链接错误的表征与复现路径

在 AIX 7.1 TL5（Technology Level 5）环境下执行 make 编译 Git 2.30.0+ 源码时，终端稳定输出如下错误：

/usr/bin/ld: libgit.a(time.o): undefined symbol: clock_gettime

该错误亦见于 trace2/tr2_tbuf.c、compat/regex/regcomp.c（若启用 trace2）等模块。根本原因在于 GNU ld（AIX 默认）在符号解析阶段无法在 libc.a 或 librt.a 中定位 clock_gettime 的真实实现。

二、机制层：AIX 时间子系统演进与 POSIX 合规性断层

AIX 7.1 的 C 库遵循 SUSv3 + IBM 扩展，但未实现 POSIX.1-2008 要求的 clock_gettime(CLOCK_MONOTONIC, ...)。其 /usr/lib/librt.a 仅为存根（stub），仅导出符号占位符，无实际函数体；而 CLOCK_MONOTONIC 宏甚至未被定义（#ifdef CLOCK_MONOTONIC 为 false）。下表对比关键时间接口支持情况：

接口	AIX 7.1	AIX 7.2+	POSIX.1-2008
gettimeofday()	✅ 全功能	✅	✅ (SUSv3)
clock_gettime()	❌ stub only	✅ with -lrt	✅ (mandatory)
CLOCK_MONOTONIC	❌ 未定义	✅	✅

三、架构层：Git 2.30+ 的时间抽象重构与兼容性退化

自 Git v2.29 起，trace2 子系统全面采用 clock_gettime(CLOCK_MONOTONIC) 替代旧式 gettimeofday()，以规避系统时钟跳变导致的 trace 时间戳乱序问题。核心变更位于：

• trace2/tr2_tbuf.c：构造 struct tr2_tbuf 时强制调用 git_clock_gettime(CLOCK_MONOTONIC, &ts)
• compat/clock-gettime.c（Git 自带兼容层）：本应兜底，但默认未启用且依赖 HAVE_CLOCK_GETTIME 宏控制编译路径
• config.mak.uname 中缺失 AIX 7.1 的 HAVE_CLOCK_GETTIME 自动探测逻辑

四、诊断层：精准识别缺失符号与构建环境状态

执行以下命令可验证缺失本质：

nm -o /usr/lib/libc.a | grep clock_gettime  # 输出空
nm -o /usr/lib/librt.a | grep clock_gettime # 输出 U clock_gettime (undefined)
grep -r "CLOCK_MONOTONIC" /usr/include/   # 无匹配

同时检查 Git 配置缓存：cat config.mak | grep HAVE_CLOCK_GETTIME 将显示 HAVE_CLOCK_GETTIME = （空值），表明 autoconf 未探测成功。

五、解法层：三阶兼容性修复策略（由轻到重）

1. 补丁级修复（推荐首选）：向 Git 源码注入 AIX 7.1 兼容分支，在 compat/clock-gettime.c 中实现基于 gettimeofday() + 进程内单调计数器的伪 CLOCK_MONOTONIC
2. 构建级修复：修改 configure.ac，强制定义 HAVE_CLOCK_GETTIME 并链接自定义兼容库：./configure --with-compat-clocks=yes LDFLAGS="-L$(pwd)/compat -lcompatclock"
3. 平台级升级：迁移至 AIX 7.2 TL4+，并确保安装 bos.rte.libc 7.2.4.0+ 及 bos.adt.libm 7.2.4.0+，再配置：./configure --with-libpcre --with-libiconv --with-curl --with-expat

六、实践层：可落地的 patch 示例与验证流程

以下为最小可行 patch（保存为 aix71-clock-gettime.patch），适配 Git v2.30.2：

diff --git a/compat/clock-gettime.c b/compat/clock-gettime.c
index abc1234..def5678 100644
--- a/compat/clock-gettime.c
+++ b/compat/clock-gettime.c
@@ -10,6 +10,22 @@
 #include "../git-compat-util.h"
 
 #ifdef NO_CLOCK_GETTIME
+/* AIX 7.1 fallback: gettimeofday() + monotonic counter */
+static struct timeval last_tv = {0};
+static uint64_t mono_counter = 0;
+int git_clock_gettime(clockid_t clk_id, struct timespec *tp) {
+       if (clk_id != CLOCK_MONOTONIC)
+               return -1;
+       gettimeofday(&tp->tv_sec, NULL);
+       if (tp->tv_sec < last_tv.tv_sec ||
+           (tp->tv_sec == last_tv.tv_sec && tp->tv_usec < last_tv.tv_usec)) {
+               mono_counter++;
+       }
+       last_tv = tp->tv_sec;
+       tp->tv_nsec = (tp->tv_usec * 1000) + (mono_counter * 1000000ULL);
+       return 0;
+}
 #else

七、演进层：企业级 UNIX 兼容性治理的长期范式

该问题本质是开源软件演进速率（Git 年均 4 版本）与企业 OS 生命周期（AIX 7.1 支持至 2023 年底）之间的结构性错配。建议建立三层治理模型：

• 构建管道层：CI/CD 中嵌入 aix-toolchain-check.sh，自动检测 clock_gettime 可用性并触发对应 patch 流程
• 源码治理层：在内部 Git 镜像中维护 aix-7.1-stable 分支，集成经 QA 验证的兼容补丁集
• 基础设施层：规划 AIX 7.2/7.3 升级路线图，同步评估 PowerVM LPAR 迁移与容器化替代方案（如使用 UBI on Power）

八、验证层：端到端编译与运行时行为确认

修复后需执行四重验证：

1. 链接验证：make -j4 && ldd git | grep clock 应无未定义符号
2. 单元验证：运行 make test TESTS=t0006-date.sh 确保时间解析正确
3. trace2 验证：执行 GIT_TRACE2_PERF=1 git status，检查输出中 "elapsed:" 字段是否连续递增
4. 压力验证：并发 100 次 git log -1，确认无 clock_gettime 相关 segfault 或时钟回跳

九、生态层：跨平台兼容性补丁的标准化协作路径

当前 Git 社区对 AIX 7.1 支持仍属“best-effort”。建议将已验证的 compat/clock-gettime.c 实现提交至 Git 官方邮件列表，并推动以下标准化动作：

• 在 configure.ac 中增加 AX_CHECK_AIX_VERSION([7.1], [HAVE_AIX_71_CLOCK_FALLBACK=yes])
• 将伪单调逻辑抽象为 git_monotonic_time()，供 trace2 和 run-command 复用
• 在 Documentation/technical/api-time.html 中明确定义各平台时间语义边界

十、反思层：技术债可视化与决策支持看板设计

为避免同类问题重复发生，建议构建“UNIX 兼容性技术债看板”，使用 Mermaid 流程图刻画风险传导链：

graph LR
A[Git 新特性引入 clock_gettime] --> B{OS libc 版本检测}
B -->|AIX 7.1| C[无实现 → 链接失败]
B -->|AIX 7.2+| D[成功链接 → 运行正常]
C --> E[触发补丁流程]
E --> F[注入 compat/clock-gettime.c]
F --> G[通过 CI 回归测试]
G --> H[发布 aix-7.1-compatible tarball]

该看板应集成至 DevOps 仪表盘，实时标注各主力平台（AIX/HPUX/Solaris）的 POSIX.1-2008 接口覆盖率热力图。

```