# checksum

**Repository Path**: wenhuafeng/checksum

## Basic Information

- **Project Name**: checksum
- **Description**: Calculation hex/bin file: checksum, crc32, sha256 ...
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-03-20
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# checksum

一个轻量级的文件校验工具，支持多种校验算法，包括校验和、CRC、哈希等。

## 功能特点
- 支持多种校验算法、哈希算法和加密算法
- 跨平台兼容性（Windows/Linux）
- 简单易用的命令行接口
- 高效的文件处理
- 支持批量计算多个算法
- 支持计算文件的所有可用算法
- 详细的帮助文档

## 支持的算法

### 校验和算法
- **CHECKSUM32**：32位一补求和
- **CHECKSUM24**：24位一补求和
- **CHECKSUM16**：16位一补求和
- **CHECKSUM8**：8位一补求和
- **CHECKSUM_XOR**：逐字节异或校验
- **FLETCHER16**：低开销增强型校验
- **ADLER32**：RFC 1950 标准的 Adler-32
- **ROLLING_SUM**：rsync 风格滚动校验（S2||S1）

### CRC算法
- **CRC16**：CRC-16 CCITT False算法
- **CRC32**：标准CRC-32算法

### 哈希算法
- **MD5**：128位哈希算法
- **SHA1**：160位哈希算法
- **SHA256**：256位哈希算法
- **SHA512**：512位哈希算法

### 加密算法
- **AES128**：128位高级加密标准算法

## 编译方法

### 前提条件
- Python 3.x
- CMake
- C编译器（如GCC、MinGW或MSVC）

### 编译步骤

1. 克隆或下载项目源码
2. 运行编译脚本：

```bash
python build.py
```

编译完成后，可执行文件将生成在`output`目录下。

## 使用方法

### 基本语法
```bash
checksum [文件名] [选项/算法1] [算法2] ...
```

### 选项
- **-h, -help**：显示帮助信息
- **-ALL**：计算文件的所有算法校验值

### 示例

显示帮助信息：
```bash
checksum.exe -h
# 或
checksum.exe -help
```

计算文件的特定算法校验值：
```bash
checksum.exe your.bin CHECKSUM16 CHECKSUM_XOR ADLER32
# 或使用带-前缀的命令
checksum.exe your.bin -CHECKSUM16 -CHECKSUM_XOR -ADLER32
```

计算文件的所有算法校验值：
```bash
checksum.exe your.bin ALL  # 输出全部算法
# 或使用带-前缀的命令
checksum.exe your.bin -ALL
```

### 注意事项
- 文件路径可以是相对路径或绝对路径
- 算法名称不区分大小写
- 支持带-前缀的命令参数（如-CHECKSUM32、-MD5、-SHA256等）
- 输出结果将显示文件大小、修改时间和各种校验值

## 版本信息
当前版本：v1.0.3

## 项目结构
```
src/
├── aes128/            # AES128加密算法实现
├── checksum/          # 校验和算法实现
├── common/            # 通用功能模块
├── crc/               # CRC算法实现
├── hash256/           # SHA256算法实现
├── hash512/           # SHA512算法实现
├── log/               # 日志功能模块
├── md5/               # MD5算法实现
├── sha1/              # SHA1算法实现
└── main.c             # 主程序入口
```

## 许可证
本项目采用MIT许可证。