From 5e7849c5d16ce9e941cb8ecadcabed7fc43566ce Mon Sep 17 00:00:00 2001 From: Dmitry Vyukov Date: Mon, 25 Jun 2018 11:58:28 +0200 Subject: docs: add gvisor page --- README.md | 4 ++-- docs/gvisor.md | 26 ++++++++++++++++++++++++++ 2 files changed, 28 insertions(+), 2 deletions(-) create mode 100644 docs/gvisor.md diff --git a/README.md b/README.md index 595e09876..f52d1a969 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![Build Status](https://travis-ci.org/google/syzkaller.svg?branch=master)](https://travis-ci.org/google/syzkaller) -`syzkaller` is an unsupervised coverage-guided kernel fuzzer. `Linux` kernel fuzzing has the most support, `akaros`, `freebsd`, `fuchsia`, `netbsd` and `windows` are supported to varying degrees. +`syzkaller` is an unsupervised coverage-guided kernel fuzzer. `Linux` kernel fuzzing has the most support, `akaros`, `freebsd`, `fuchsia`, `netbsd`, `windows` and `gvisor` are supported to varying degrees. The project mailing list is [syzkaller@googlegroups.com](https://groups.google.com/forum/#!forum/syzkaller). You can subscribe to it with a google account or by sending an email to syzkaller+subscribe@googlegroups.com. @@ -13,7 +13,7 @@ You can subscribe to it with a google account or by sending an email to syzkalle 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), [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.md), [gVisor](docs/gvisor.md). - [How to install syzkaller](docs/setup.md) - [How to use syzkaller](docs/usage.md) diff --git a/docs/gvisor.md b/docs/gvisor.md new file mode 100644 index 000000000..be399b107 --- /dev/null +++ b/docs/gvisor.md @@ -0,0 +1,26 @@ +# gVisor + +[gVisor](https://github.com/google/gvisor) is a user-space kernel, written in +Go, that implements a substantial portion of the Linux system surface. + +`gVisor` uses `linux` OS, but the special `gvisor` VM type. There is nothing +special regarding `gVisor` besides that. Here is an example manager config: + +``` +{ + "name": "gvisor", + "target": "linux/amd64", + "http": ":12345", + "workdir": "/workdir", + "image": "/usr/local/bin/runsc", + "vmlinux": "/usr/local/bin/runsc", + "syzkaller": "/gopath/src/github.com/google/syzkaller", + "cover": false, + "procs": 8, + "type": "gvisor", + "vm": { + "count": 5, + "runsc_args": "-platform=kvm" + } +} +``` -- cgit mrf-deployment