mirror of
https://github.com/reactos/syzkaller.git
synced 2024-10-07 09:03:28 +00:00
e5701ed16c
The fuzzers now run on every new code that is pushed to master Regression using the generated corpus from the above step is run locally in the travis. This should fail the travis if new or old bugs are introduce and thus help catch bugs earlier. To reproduce locally you can run ./fuzzit create job --local syzkaller/target-name $PATH_TO_FUZZER
57 lines
4.2 KiB
Markdown
57 lines
4.2 KiB
Markdown
# syzkaller - kernel fuzzer
|
|
|
|
[](https://travis-ci.org/google/syzkaller)
|
|
[](https://fuzzit.dev)
|
|
[](https://goreportcard.com/report/github.com/google/syzkaller)
|
|
[](https://codecov.io/gh/google/syzkaller)
|
|
[](https://godoc.org/github.com/google/syzkaller)
|
|
[](LICENSE)
|
|
|
|
`syzkaller` is an unsupervised coverage-guided kernel fuzzer.\
|
|
Supported OSes: `Akaros`, `FreeBSD`, `Fuchsia`, `gVisor`, `Linux`, `NetBSD`, `OpenBSD`, `Windows`.
|
|
|
|
Mailing list: [syzkaller@googlegroups.com](https://groups.google.com/forum/#!forum/syzkaller) (join on [web](https://groups.google.com/forum/#!forum/syzkaller) or by [email](mailto:syzkaller+subscribe@googlegroups.com)).
|
|
|
|
Found bugs: [Akaros](docs/akaros/found_bugs.md), [Darwin/XNU](docs/darwin/README.md), [FreeBSD](docs/freebsd/found_bugs.md), [Linux](docs/linux/found_bugs.md), [NetBSD](docs/netbsd/found_bugs.md), [OpenBSD](docs/openbsd/found_bugs.md), [Windows](docs/windows/README.md).
|
|
|
|
## Documentation
|
|
|
|
Initially, syzkaller was developed with Linux kernel fuzzing in mind, but now
|
|
it's being extended to support other OS kernels as well.
|
|
Most of the documentation at this moment is related to the [Linux](docs/linux/setup.md) kernel.
|
|
For other OS kernels check:
|
|
[Akaros](docs/akaros/README.md),
|
|
[Darwin/XNU](docs/darwin/README.md),
|
|
[FreeBSD](docs/freebsd/README.md),
|
|
[Fuchsia](docs/fuchsia/README.md),
|
|
[NetBSD](docs/netbsd/README.md),
|
|
[OpenBSD](docs/openbsd/setup.md),
|
|
[Windows](docs/windows/README.md),
|
|
[gVisor](docs/gvisor/README.md).
|
|
|
|
- [How to install syzkaller](docs/setup.md)
|
|
- [How to use syzkaller](docs/usage.md)
|
|
- [How syzkaller works](docs/internals.md)
|
|
- [How to contribute to syzkaller](docs/contributing.md)
|
|
- [How to report Linux kernel bugs](docs/linux/reporting_kernel_bugs.md)
|
|
|
|
## External Articles
|
|
|
|
- [Research work based on syzkaller](docs/research.md)
|
|
- From [HardenedLinux](https://github.com/hardenedlinux) project:
|
|
- [Kernel QA with syzkaller and qemu](https://github.com/hardenedlinux/Debian-GNU-Linux-Profiles/blob/master/docs/harbian_qa/fuzz_testing/syzkaller_general.md) (tutorial on how to setup syzkaller with qemu)
|
|
- [Syzkaller crash DEMO](https://github.com/hardenedlinux/Debian-GNU-Linux-Profiles/blob/master/docs/harbian_qa/fuzz_testing/syzkaller_crash_demo.md) (tutorial on how to extend syzkaller with new syscalls)
|
|
- [Kernel debug tool with syzkaller](https://github.com/hardenedlinux/Debian-GNU-Linux-Profiles/blob/master/docs/harbian_qa/fuzz_testing/syz_debug.md) (debugging qemu VM created by syz-manager with gdb)
|
|
- [Explanation of some syzkaller internals](https://github.com/hardenedlinux/Debian-GNU-Linux-Profiles/blob/master/docs/harbian_qa/fuzz_testing/syz_analysis.md)
|
|
- [A example of fuzzing the ceph filesystem](https://github.com/hardenedlinux/Debian-GNU-Linux-Profiles/tree/master/docs/harbian_qa/fuzz_testing/syz_for_ceph)
|
|
- [Coverage-guided kernel fuzzing with syzkaller](https://lwn.net/Articles/677764/) (by David Drysdale)
|
|
- [ubsan, kasan, syzkaller und co](http://www.strlen.de/talks/debug-w-syzkaller.pdf) ([video](https://www.youtube.com/watch?v=Acp0A9X1254)) (by Florian Westphal)
|
|
- [Debugging a kernel crash found by syzkaller](http://vegardno.blogspot.de/2016/08/sync-debug.html) (by Quentin Casasnovas)
|
|
- [Linux Plumbers 2016 talk slides](https://docs.google.com/presentation/d/1iAuTvzt_xvDzS2misXwlYko_VDvpvCmDevMOq2rXIcA/edit?usp=sharing)
|
|
- [syzkaller: the next gen kernel fuzzer](https://www.slideshare.net/DmitryVyukov/syzkaller-the-next-gen-kernel-fuzzer) (basics of operations, tutorial on how to run syzkaller and how to extend it to fuzz new drivers)
|
|
- [syzbot and the tale of thousand kernel bugs](https://events.linuxfoundation.org/wp-content/uploads/2017/11/Syzbot-and-the-Tale-of-Thousand-Kernel-Bugs-Dmitry-Vyukov-Google.pdf) [[video](https://www.youtube.com/watch?v=qrBVXxZDVQY)]
|
|
|
|
## Disclaimer
|
|
|
|
This is not an official Google product.
|