Linux autoconf 调试指南

autoconf 是 GNU 构建系统的重要组成部分，用于生成可移植的配置脚本。调试 autoconf 相关问题可能会比较复杂，以下是一些有效的调试方法：

基本调试方法

1. 查看详细输出

   ./configure --verbose
   

   或

   ./configure -v
   

2. 检查 config.log 文件

   • 这是最重要的调试信息来源
   • 包含所有测试执行的命令及其输出
   • 搜索 "failed"、"error" 或 "checking" 关键字

3. 启用 shell 调试

   sh -x ./configure
   

   这会显示所有执行的 shell 命令

高级调试技巧

1. 检查特定的宏测试

   • 在 configure.ac 中添加调试输出： m4 m4_pattern_allow([^PKG_]) AC_MSG_CHECKING([for something]) AC_MSG_RESULT([$result])

2. 使用 autoconf 的调试选项

   autoconf --trace=AC_DEFINE
   autoconf --trace='AC_MSG_*'
   

3. 检查生成的 configure 脚本

   • 查看 configure 脚本中特定测试的部分
   • 搜索相关的测试名称或变量

4. 缓存测试结果

   • 使用 --config-cache 或 -C 选项缓存测试结果
   • 检查 config.cache 文件内容

常见问题排查

1. 宏未定义错误

   • 确保所有需要的宏都在 configure.ac 中正确定义
   • 检查是否缺少必要的 m4 文件

2. 测试失败

   • 检查测试的依赖是否满足
   • 查看 config.log 中具体的失败原因

3. 交叉编译问题

   • 确保设置了正确的 --host、--build 和 --target 参数
   • 检查工具链是否配置正确

4. 过时的文件

   • 运行 autoreconf -fvi 重新生成所有文件
   • 确保所有生成的文件都是最新的

实用工具

1. autoscan

   • 生成初步的 configure.ac 模板

   autoscan
   

2. ifnames

   • 识别源代码中使用的条件编译指令

   ifnames *.c
   

3. autom4te

   • autoconf 的底层处理器

   autom4te --language=autoconf -t 'AC_PROG_CC' configure.ac
   

通过以上方法，你应该能够有效地诊断和解决 autoconf 相关的问题。如果遇到特定问题，检查 config.log 通常是第一步也是最重要的一步。