diff options
| -rw-r--r-- | README.md | 13 | ||||
| -rw-r--r-- | docs/darwin/README.md | 10 | ||||
| -rw-r--r-- | docs/found_bugs.md | 4 | ||||
| -rw-r--r-- | docs/setup.md | 2 | ||||
| -rw-r--r-- | docs/windows/README.md (renamed from docs/windows.md) | 10 |
5 files changed, 35 insertions, 4 deletions
@@ -11,9 +11,18 @@ You can subscribe to it with a google account or by sending an email to syzkalle ## Documentation -Initially, syzkaller was developed with Linux kernel fuzzing in mind, but now it's being extended to support other OS kernels as well. +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 kernel. -For other OS kernels check: [Akaros](docs/akaros/README.md), [FreeBSD](docs/freebsd.md), [Fuchsia](docs/fuchsia.md), [NetBSD](docs/netbsd.md), [OpenBSD](docs/openbsd/setup.md), [Windows](docs/windows.md), [gVisor](docs/gvisor.md). +For other OS kernels check: +[Akaros](docs/akaros/README.md), +[Darwin/XNU](docs/darwin/README.md), +[FreeBSD](docs/freebsd.md), +[Fuchsia](docs/fuchsia.md), +[NetBSD](docs/netbsd.md), +[OpenBSD](docs/openbsd/setup.md), +[Windows](docs/windows/README.md), +[gVisor](docs/gvisor.md). - [How to install syzkaller](docs/setup.md) - [How to use syzkaller](docs/usage.md) diff --git a/docs/darwin/README.md b/docs/darwin/README.md new file mode 100644 index 000000000..f4c75e6b0 --- /dev/null +++ b/docs/darwin/README.md @@ -0,0 +1,10 @@ +# Darwin/XNU + +`Darwin/XNU` is not supported at the moment. + +[panicall](https://twitter.com/panicaII) has +[ported](https://i.blackhat.com/eu-18/Wed-Dec-5/eu-18-Juwei_Lin-Drill-The-Apple-Core.pdf) +syzkaller to `Darwin/XNU` and that has found more than +[50 bugs](https://twitter.com/panicaII/status/1070696972326133760) including +`CVE-2018-4447` and `CVE-2018-4435` mentioned in +[Apple security updates](https://support.apple.com/en-us/HT209341). diff --git a/docs/found_bugs.md b/docs/found_bugs.md index d77d33744..469ea33cd 100644 --- a/docs/found_bugs.md +++ b/docs/found_bugs.md @@ -5,3 +5,7 @@ [Akaros kernel bugs](akaros/found_bugs.md) [OpenBSD kernel bugs](openbsd/found_bugs.md) + +[Darwin/XNU](darwin/README.md) + +[Windows](windows/README.md) diff --git a/docs/setup.md b/docs/setup.md index 7c8438d02..d40d85cfc 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -1,7 +1,7 @@ # How to set up syzkaller Generic setup instructions for fuzzing Linux kernel are outlined [here](linux/setup.md). -For other OS kernels check: [Akaros](/docs/akaros/README.md), [FreeBSD](/docs/freebsd.md), [Fuchsia](/docs/fuchsia.md), [NetBSD](/docs/netbsd.md), [Windows](/docs/windows.md). +For other OS kernels check: [Akaros](/docs/akaros/README.md), [FreeBSD](/docs/freebsd.md), [Fuchsia](/docs/fuchsia.md), [NetBSD](/docs/netbsd.md), [Windows](/docs/windows/README.md). After following these instructions you should be able to run `syz-manager`, see it executing programs and be able to access statistics exposed at `http://127.0.0.1:56741`: diff --git a/docs/windows.md b/docs/windows/README.md index 37990b3b8..1511db135 100644 --- a/docs/windows.md +++ b/docs/windows/README.md @@ -1,4 +1,12 @@ -# Windows support +# Windows + +`Windows` support is very raw and preliminary (read, non-working). + +There is a more complete +[closed-source Windows port](https://www.slideshare.net/AnthonyLAOUHINETSUEI/wsl-reloaded) +done by [Fritz](https://twitter.com/anarcheuz) and [zer0mem](https://twitter.com/zer0mem). +The port has found 6 bugs including +[CVE-2018-8441](https://portal.msrc.microsoft.com/en-US/security-guidance/advisory/CVE-2018-8441). To update descriptions run (assumes `cl` cross-compiler is in PATH): ``` |