# gazelle-src

**Repository Path**: wu-changsheng/gazelle

## Basic Information

- **Project Name**: gazelle-src
- **Description**: A high performance user-mode stack, which powered by dpdk and lwip
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 108
- **Created**: 2022-02-24
- **Last Updated**: 2023-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<img src="doc/logo.png" alt=Gazelle style="zoom:20%"> 

# 用户态协议栈Gazelle

## 简介

Gazelle是一款高性能用户态协议栈。它基于DPDK在用户态直接读写网卡报文，共享大页内存传递报文，使用轻量级LwIP协议栈。能够大幅提高应用的网络I/O吞吐能力。专注于数据库网络性能加速，如MySQL、redis等。兼顾高性能与通用性：
- 高性能  
报文零拷贝，无锁，灵活scale-out，自适应调度。
- 通用性  
完全兼容POSIX，零修改，适用不同类型的应用。  

## 性能效果
### mysql 8.0.20
<img src="doc/test/mysql_kernel.png"> 
<img src="doc/test/mysql_gazelle.png"> 

使用内核协议栈跑分为54.84万，使用Gazelle跑分为66.85万，Gazelle提升20%+  
详见[实践系列(一):Gazelle加速mysql 20%](doc/%E5%AE%9E%E8%B7%B5%E7%B3%BB%E5%88%97(%E4%B8%80)Gazelle%E5%8A%A0%E9%80%9Fmysql%2020%25.md)

### ceph 14.2.8
<img src="doc/test/ceph_client_testdata.png"> 

4k整机场景，Gazelle提升20%+  
部署及测试详见 [高性能云盘](https://www.hikunpeng.com/document/detail/zh/kunpengcpfs/basicAccelFeatures/storageAccel/kunpengcpfs_hpcd_0002.html)

### 后续应用……
- redis 2022/12/30
- openGauss 2022/12/30

## 详情 
可点击标题跳转，欢迎投递文章、提意见。
| 主题 | 内容简介 | 发布时间 |
|:---|:-----|:---|
|[Gazelle使用指南](doc/Gazelle%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97.md)| 1，安装、部署环境、启动应用程序<br>2，配置参数说明<br>3，调测命令说明<br>4，使用约束、风险、注意事项|已发布|
|Gazelle介绍| 1，介绍背景<br>2，简介技术方案<br>3，性能效果|2022/11/30|
|[实践系列(一):Gazelle加速mysql 20%](doc/%E5%AE%9E%E8%B7%B5%E7%B3%BB%E5%88%97(%E4%B8%80)Gazelle%E5%8A%A0%E9%80%9Fmysql%2020%25.md)|1，详细测试步骤<br>2，性能效果|已发布|
|实践系列(二):Gazelle加速redis xx|1，详细测试步骤<br>2，性能效果|2022/12/31|
|[实践系列(三):Gazelle加速ceph client 20%](https://www.hikunpeng.com/document/detail/zh/kunpengcpfs/basicAccelFeatures/storageAccel/kunpengcpfs_hpcd_0002.html)|1，详细测试步骤<br>2，性能效果|已发布|
|实践系列(四):Gazelle加速openGauss xx|1，详细测试步骤<br>2，性能效果|2022/12/31|
|解读系列(一):Gazelle总体方案介绍|1，支持场景、特性、规格<br>2，与dpdk、lwip关系<br>3，总体框架<br>4，替换posix接口|2022/11/25|
|解读系列(二):Gazelle为什么能提升xx|介绍提关键技术点：减少拷贝、亲和性、减少上下文切换|2022/12/2|
|解读系列(三):Gazelle代码框架流程|1，Gazelle框架<br>2，事件、读、写、ltran报文流程图|2022/12/9|
|参与Gazelle指导|1，怎么判断应用适不适合应gazelle加速<br>2，Gazelle常见问题调试<br>|2022/12/5|
|[openEuler指南](https://gitee.com/openeuler/community/blob/master/zh/contributors/README.md)| 如何参与openEuler社区 | 已发布 |

## 支持列表
- [posix接口列表及应用支持列表](doc/support.md)

## FAQ
- [如何使用pdump工具抓包](doc/pdump/pdump.md) 
- listenshadow参数如何配置（文档11.30发布）
- [多进程各自独立使用网卡](doc/mNIC/mNIC.md)

## 路标
<img src="doc/roadmap.png" alt=scene style="zoom:50%"> 

## 联系方式
[订阅邮件列表](https://mailweb.openeuler.org/postorius/lists/high-performance-network.openeuler.org/)  
[历史邮件](https://mailweb.openeuler.org/hyperkitty/list/high-performance-network@openeuler.org/)  
微信群名称：openEuler 高性能网络sig  
[SIG首页](https://gitee.com/openeuler/community/tree/master/sig/sig-high-performance-network)