ABACUS 的-i/-I/--info 功能使用说明

作者：周徐源，邮箱：xy_z@pku.edu.cn

审核：陈默涵，邮箱：mohanchen@pku.edu.cn

最后更新时间：2025/12/15

功能背景

先前 ABACUS 仅支持 -v/-V/--version 选项，仅输出版本号，无 -h/--help 选项，输出信息过少。接收完#6734 PR 后，3.9.0.20 版本(https://github.com/deepmodeling/abacus-develop/releases/tag/v3.9.0.20)的 abacus 支持输入 -i/-I/--info 选项输出编译平台、功能支持及依赖库版本等详细信息。考虑到需要首先通过 configure 命令获取版本号再基于版本号编译，采用引入通过 CMake 自动填充模板头文件的技术路线。

编译注意事项

由于在 CMake 的 configure 过程或 Makefile 通过 generate_build_info.sh 生成 build_info.h，为避免污染源代码，需要采用“源外构建”，即在单独的 BUILD_DIR=build 中构建

mkdir build && cd build
cmake ../ -D...
or
make -f ../source/Makefile ...

使用说明

编译完成后假设可执行文件名为 abacus，则通过运行 abacus -i 或 abacus -I 或 abacus --info，输出包括如下部分的信息：

1. 核心版本信息和平台

   1. ABACUS 版本：v3.x.x.x
   2. Git commit 的哈希值
   3. 目标平台：CPU、GPU、DCU、DSP 或 SW
   4. 构建类型：Custom 或 Debug

2. 构建基本环境

   1. 构建用户
   2. 构建主机
   3. 构建时间

3. 编译器和编译标志

   1. C++ 编译器类型与路径
   2. C++ 编译器版本号
   3. C++ 编译标志
   4. 链接标志
   5. CUDA 编译标志

4. 清查和调试

   1. 地址清查支持情况
   2. 调试符号支持情况

5. CMake 构建概况

   1. 构建选项
   2. 依赖包查找结果

6. 并行和通信

   1. MPI 应用：IntelMPI、OpenMPI
   2. MPI 版本
   3. CUDA 感知 MPI：若支持则显示版本号
   4. OpenMP：若支持则显示版本号

7. 核心数学库

   1. LCAO 支持情况
   2. ELPA：若支持则显示版本号（或路径）
   3. MKL：若支持则显示版本号（或路径）
   4. LibXC：若支持则显示版本号（或路径）
   5. FFTW：若支持则显示版本号（或路径）

8. 加速器和硬件

   1. NVIDIA CUDA：若支持则显示版本号（或路径）
   2. AMD POCm：若支持则显示版本号（或路径）
   3. CUSolverMP：若支持则显示版本号（或路径）

9. 杂化泛函相关

   1. Cereal 序列化：若支持则显示版本号（或路径）
   2. LibRI：若支持则显示版本号（或路径）
   3. LibComm：若支持则显示版本号（或路径）

10. 人工智能和机器学习相关

    1. LibTorch：若支持则显示版本号（或路径）
    2. Libnpy：若支持则显示版本号（或路径）
    3. DeePMD-kit 力场：若支持则显示版本号（或路径）
    4. NEP 力场：若支持则显示版本号（或路径）
    5. TensorFlow：若支持则显示版本号（或路径）

11. 测试和其它支持

    1. Google 测试：若支持则显示版本号（或路径）
    2. Google 基准测试：若支持则显示版本号（或路径）
    3. RapidJSON：若支持则显示版本号（或路径）
    4. PEXSI：若支持则显示版本号（或路径）
    5. cnpy：若支持则显示版本号（或路径）