2.2 KiB
Contributing
Hi! Thanks for taking the time and contributing to MITMf! Pull requests are always welcome!
Submitting Issues/Bug Reporting
Bug reporting is an essential part of any project since it let's people know whats broken!
Before reading on, here's a list of cases where you shouldn't be reporting the bug:
- If you haven't installed MITMf using method described in the installation intructions. (your fault!)
- If you're using and old version of the framework (and by old I mean anything else that isn't the current version on Github)
- If you found a bug in a packaged version of MITMf (e.g. Kali Repos), please file a bug report with the distros maintaner
Lately, there has been a sharp increase in the volume of bug reports so in order for me to make any sense out of them and to quickly identify, reproduce and push a fix I do pretend a minimal amount of cooperation from the reporter!
Writing the report
Before submitting a bug familiarize yourself with Github markdown and use it in your report!
After that, open an issue ticket and please describe the bug in detail! MITMf has a lot of moving parts so the more detail the better!
Include in the report:
- The full command string you used
- The full output of:
pip freeze
- The full output of MITMf in debug mode (append
--log debug
to the command you used) - The OS you're using (distribution and architecture)
- The full error traceback (If any)
- If the bug resides in the way MITMf sends/receives packets, include a link to a pcap containing a full packet capture
Some good & bad examples
- How to write a bug report
https://github.com/byt3bl33d3r/MITMf/issues/71
https://github.com/byt3bl33d3r/MITMf/issues/70
https://github.com/byt3bl33d3r/MITMf/issues/64
- How not to write a bug report
https://github.com/byt3bl33d3r/MITMf/issues/35 <-- My personal favorite
https://github.com/byt3bl33d3r/MITMf/issues/139
https://github.com/byt3bl33d3r/MITMf/issues/138