开源项目 `progress` 使用教程

1. 项目的目录结构及介绍

progress 是一个用于显示文件操作进度的小工具，支持 cp, mv, dd, tar, gzip/gunzip, cat 等命令。以下是项目的目录结构及各部分介绍：

progress/
├── CMakeLists.txt
├── COPYING
├── Makefile
├── README.md
├── config.h.in
├── core.c
├── core.h
├── progress.c
├── progress.h
├── progress.1
├── progress.1.md
├── progress.png
├── sha256.c
├── sha256.h
├── tests
│   ├── Makefile
│   ├── test1
│   ├── test2
│   └── test3
└── watch.c

• CMakeLists.txt 和 Makefile：构建文件，用于编译项目。
• COPYING：许可证文件，说明项目的开源许可。
• README.md：项目说明文档。
• config.h.in：配置文件模板。
• core.c 和 core.h：核心功能实现。
• progress.c 和 progress.h：主程序文件。
• progress.1 和 progress.1.md：man 手册页。
• progress.png：项目图标。
• sha256.c 和 sha256.h：SHA-256 哈希算法实现。
• tests/：测试目录，包含多个测试脚本。
• watch.c：用于监控文件系统的功能实现。

2. 项目的启动文件介绍

项目的启动文件是 progress.c，它是主程序文件，负责初始化和调用其他模块的功能。以下是 progress.c 的主要功能：

• 解析命令行参数。
• 初始化核心模块。
• 监控文件操作并显示进度。
• 处理信号和退出逻辑。

3. 项目的配置文件介绍

progress 项目的配置文件是 config.h，它是在编译过程中由 config.h.in 模板生成的。config.h 包含了一些编译时定义的常量和选项，例如：

• 定义支持的文件操作命令。
• 定义默认的刷新间隔。
• 定义调试选项。

在编译项目时，CMakeLists.txt 会根据 config.h.in 生成 config.h，确保编译出的程序符合配置要求。

以上是 progress 项目的目录结构、启动文件和配置文件的介绍。希望这份教程能帮助你更好地理解和使用该项目。