Skip to content
stack-rsPublic

About

Rattan: An Extensible and Scalable Modular Internet Path Emulator

Topics

Resources

Code of conduct

Contributing

Stars

20 stars

Watchers

2 watching

Forks

Latest commit

 

History

374 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rattan

GitHub Release crates.io CI

Rattan is an extensible and scalable modular Internet path emulator. It separates what users emulate from how it is executed: users compose cells, each implementing one path effect, into channels that describe end-to-end Internet paths.

We provide a simple and easy-to-use API to create and manage network emulations. Rattan is designed to be used in a wide range of scenarios, from testing network applications to debugging complex network performance issues.

Our modular design makes it easy to extend Rattan with different network effects. We provide a set of built-in modules that can be used to emulate different network conditions, such as bandwidth, latency, packet loss, ISP policies and etc.

We support Linux only at the moment. Currently, kernel version v5.4, v5.15, v6.8 and v6.12 are tested.

Usage

We provide users with a CLI tool to use our pre-defined channels or cells and also a Rust library to build custom channels or cells.

Please check our User Guide for how to use Rattan.

Design Targets

  • High Performance. Rattan provides both high peak performance and execution efficiency.
  • Flexible. Rattan tries to be agnostic of the underlying path emulation model.
  • Extensible. Rattan provides rich features out-of-the-box, meanwhile tends to be easily extensible for custom conditions.
  • User-Friendly. Rattan aims to provide a simple and intuitive interface for quick usage on common cases and ensure complete controllability under the hood to cover the corner as well.

Contributing

Rattan is free and open source. You can find the source code on GitHub and issues and feature requests can be posted on the GitHub issue tracker. Rattan relies on the community to fix bugs and add features: if you'd like to contribute, please read the CONTRIBUTING guide and consider opening a pull request.

Citation

Rattan is published at the 2026 ACM SIGOPS Annual Technical Conference (SIGOPS ATC '26). The artifact for reproducing the paper's experiments is available at 10.5281/zenodo.23267891 or the ATC26 branch.

If you want to cite our paper, please use the doi: 10.1145/3828523.3857129 or the BibTeX entry below:

@inproceedings{10.1145/3828523.3857129,
      author={Shen, Yixin and Wang, Minhu and Wang, Bo and Tong, Haixuan and Li, Chenghao and Xie, Yutong and Gao, Yixuan and Xu, Mingwei and Wu, Jianping},
      title={Rattan: An Extensible and Scalable Modular Internet Path Emulator},
      year={2026},
      isbn={9798400728181},
      publisher={Association for Computing Machinery},
      address={New York, NY, USA},
      url={https://doi.org/10.1145/3828523.3857129},
      doi={10.1145/3828523.3857129},
      booktitle={Proceedings of the 2026 ACM SIGOPS Annual Technical Conference},
      pages={129--144},
      numpages={16},
      keywords={Network emulation, Internet paths, modularity, reproducibility, transport evaluation},
      location={Hong Kong, China},
      series={SIGOPS ATC '26}
}

About

Rattan: An Extensible and Scalable Modular Internet Path Emulator

Topics

Resources

Code of conduct

Contributing

Stars

20 stars

Watchers

2 watching

Forks

Releases

Used by

Contributors

Languages