# curl-rust

**Repository Path**: fanqiliang/curl-rust

## Basic Information

- **Project Name**: curl-rust
- **Description**: Rewrite memory leak related modules for curl using Rust
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 13
- **Created**: 2022-06-24
- **Last Updated**: 2022-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# curl-rust

## 介绍

cURL 提供了curl（命令行工具）和 libcurl（C语言的API库），两者功能均是基于网络协议，对指定 URL 进行网络传输。cURL 使用C语言实现，libcurl 历史安全漏洞较多，其中内存类占比51%。本项目通过使用 Rust 重写 cURL 的高危模块，利用 Rust 语言的内存安全优势，以增加 libcurl 的安全性和可靠性。

## 项目实施方案

对 cURL 的改写，分为以下步骤进行：

- 构建 Rust 项目结构，确定重写的部分的组织方式
- 使用 c2rust 工具自动改写 C 代码
- 手动将一些数据结构定义和函数声明移动到公共模块中
- 改写宏定义
- 与 C 代码混合编译并通过测试

## 从源码编译

### 前置条件

需准备前置条件，以便 curl-rust 能正确地编译，需要的前置条件有：

- make
-  rustup
-  cargo
-  nightly 版的 rustc
-  gcc
-  openssl-libs
-  automake 等。

可以使用如下命令完成完成安装：

```
sudo yum install -y gcc openssl-libs automake make cmake
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs -o rustlang.sh
sh rustlang.sh -y
rustup install nightly
rustup default nightly
```

准备好前置条件后，可以按如下步骤完成编译：

1.  进入`rust/`目录，执行`cargo build --release -v`
2.  在项目根目录下，执行`aclocal`和`automake`
3.  在项目根目录下，执行`LDFLAGS="-L./rust/target/release" LIBS="-lrust_project -ldl" ./configure --without-ssl --disable-shared`
4.  执行`make`完成编译
5.  还可以执行`make test`进行测试

## 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request