mirror of https://github.com/reactos/syzkaller.git synced 2025-02-15 00:57:35 +00:00

Dmitry Vyukov f8d0ffe005 docs: update source download instructions

Since we don't don't have auto-generated files checked-in,
go get fails to parse packages.
go get only prog package without building,
this will checkout the whole repo anyway
and that's the only thing we need.

2020-05-02 14:12:25 +02:00

3.0 KiB

Raw Blame History

Setup

Instructions for running OpenBSD host, OpenBSD vm, amd64 kernel. In addition, the host must be running -current.

Variables used throughout the instructions:

$KERNEL - Custom built kernel, see Compile Kernel. Defaults to /sys/arch/amd64/compile/SYZKALLER/obj/bsd if the instructions are honored.
$SSHKEY - SSH key without a passphrase used to connect to the VMs, it's advised to use a dedicated key.
$USER - The name of the user intended to run syzkaller.
$VMIMG - VM disk image.
$VMID - The numeric ID of last started VM.

Install syzkaller

Install dependencies:
```
# pkg_add git gmake go
```
In order for reproducers to work, GCC from ports is also required:
```
# pkg_add gcc
```

Clone repository:

$ go get -u -d github.com/google/syzkaller/prog
$ cd ~/go/src/github.com/google/syzkaller
$ gmake all

Compile Kernel

A GENERIC kernel must be compiled with kcov(4) enabled:

$ cd /sys/arch/amd64
$ cat <<EOF >conf/SYZKALLER
include "arch/amd64/conf/GENERIC"
pseudo-device kcov 1
EOF
$ cp -R compile/GENERIC compile/SYZKALLER
$ make -C compile/SYZKALLER obj
$ make -C compile/SYZKALLER config
$ make -C compile/SYZKALLER

Create VM

vmd(8) must be configured to allow non-root users to create VMs since it removes the need to run syzkaller as root:

$ cat /etc/vm.conf
vm "syzkaller" {
  disable
  disk "/dev/null"
  local interface
  owner $USER
  allow instance { boot, disk, memory }
}

Create disk image:
```
$ vmctl create -s 4G "qcow2:$VMIMG"
```

Install VM:

$ vmctl start -c -t syzkaller -b /bsd.rd -d "$VMIMG" syzkaller-1

Answers to questions that deviates from the defaults:

Password for root account? ******
Allow root ssh login? yes

Restart the newly created VM and copy the SSH-key:

$ vmctl stop -w syzkaller-1
$ vmctl start -c -t syzkaller -d "$VMIMG" syzkaller-1
$ ssh "root@100.64.${VMID}.3" 'cat >~/.ssh/authorized_keys' <$SSHKEY.pub

Optionally, library ASLR can be disabled in order to improve boot time:

$ ssh "root@100.64.${VMID}.3" 'echo library_aslr=NO >>/etc/rc.conf.local'

Finally, stop the VM:
```
$ vmctl stop -w syzkaller-1
```

Configure and run syzkaller

$ pwd
~/go/src/github.com/google/syzkaller
$ cat openbsd.cfg
{
  "name": "openbsd",
  "target": "openbsd/amd64",
  "http": ":10000",
  "workdir": "$HOME/go/src/github.com/google/syzkaller/workdir",
  "kernel_obj": "/sys/arch/amd64/compile/SYZKALLER/obj",
  "kernel_src": "/",
  "syzkaller": "$HOME/go/src/github.com/google/syzkaller",
  "image": "$VMIMG",
  "sshkey": "$SSHKEY",
  "sandbox": "none",
  "procs": 2,
  "type": "vmm",
  "vm": {
    "count": 4,
    "mem": 512,
    "kernel": "$KERNEL",
    "template": "syzkaller"
  }
}
$ ./bin/syz-manager -config openbsd.cfg

3.0 KiB Raw Blame History