Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

refactor: Removed dependencies, major refactor #2

Merged
merged 18 commits into from
Sep 7, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/bench.yml
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ jobs:
# What benchmark tool the output.txt came from
tool: 'cargo'
# Where the output from the benchmark tool is stored
output-file-path: markov_model_bench.txt
output-file-path: lib/markov_model_bench.txt
# GitHub API token to make a commit comment
github-token: ${{ secrets.GITHUB_TOKEN }}
# Leave a job summary with benchmark result comparison
Expand Down
12 changes: 11 additions & 1 deletion Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,16 @@ A high-performance MQTT network Fuzzer.

This is an implementation of [FUME-Fuzzing-MQTT-Brokers](https://github.com/PBearson/FUME-Fuzzing-MQTT-Brokers/) in Rust.

# Architecture
The Fuzzing process is based on a Markov Model seen in the following image:
![Markov Model](images/MarkovModel.png)
For more details see src/lib/lib.rs or the original paper.

Notable changes from the paper include:
- The use of multiple asynchronous threads for fuzzing by default
- Improved performance
- Only counting broker crashes as crashes(The original paper also counted refused connections as crashes)

# Running the project
After [installing Rust](https://rustup.rs), run the following command in the project directory:
```
Expand All @@ -35,7 +45,7 @@ Pull requests are welcome. For major changes, please open an issue first to disc
## Compatibility
Currently, the Windows build is failing in the ci, however i've only tested this on Linux so far. Maybe it works on Windows, maybe it doesn't. I don't know. Pull Requests to fix this if necessary are welcome.

## Trophies
## 🏆 Trophies
All bugs found with this software. If you find a bug using rusty-FUME, please open an issue and I'll add it to the list once it is patched.
- [FlashMQ Null pointer dereference](https://github.com/halfgaar/FlashMQ/commit/eb3acf88771af3eeddf086e4c9dc51d703456eee)

Expand Down
Binary file added images/MarkovModel.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.