From 44e0a0eac98792013014e475165187932075f045 Mon Sep 17 00:00:00 2001 From: Andrei Vagin Date: Wed, 9 Dec 2020 21:45:56 -0800 Subject: Add syzkaller docker image --- images/syzkaller/README.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 images/syzkaller/README.md (limited to 'images/syzkaller/README.md') diff --git a/images/syzkaller/README.md b/images/syzkaller/README.md new file mode 100644 index 000000000..60aa61d12 --- /dev/null +++ b/images/syzkaller/README.md @@ -0,0 +1,34 @@ +syzkaller is an unsupervised coverage-guided kernel fuzzer. + +* [Github](https://github.com/google/syzkaller) +* [gVisor dashboard](https://syzkaller.appspot.com/gvisor) + +# How to run syzkaller. + +* Build the syzkaller docker image +``` +make load-syzkaller +``` +* Build runsc and place it in /tmp/syzkaller. +``` + make RUNTIME_DIR=/tmp/syzkaller refresh +``` +* Copy the syzkaller config in /tmp/syzkaller +``` +cp images/syzkaller/default-gvisor-config.cfg /tmp/syzkaller/syzkaller.cfg +``` +* Run syzkaller +``` +docker run --privileged -it --rm -v /tmp/syzkaller:/tmp/syzkaller gvisor.dev/images/syzkaller:latest +``` + +# How to run a syz repro. + +* Repeate all steps except the last one from the previous section. + +* Save a syzkaller repro in /tmp/syzkaller/repro + +* Run syz-repro +``` +docker run --privileged -it --rm -v /tmp/syzkaller:/tmp/syzkaller --entrypoint="" gvisor.dev/images/syzkaller:latest ./bin/syz-repro -config /tmp/syzkaller/syzkaller.cfg /tmp/syzkaller/repro +``` -- cgit v1.2.3