diff options
| author | Dmitry Vyukov <dvyukov@google.com> | 2020-05-16 07:14:45 +0200 |
|---|---|---|
| committer | Dmitry Vyukov <dvyukov@google.com> | 2020-05-18 11:34:42 +0200 |
| commit | 37137150cb3bec5efc9112447b03d4999612e3d4 (patch) | |
| tree | 72eb8c1675cc9a050efa5fc657ca920d8cdb9b91 /docs | |
| parent | 848ec2e87bd69decdb19bc897a7798d9f216724a (diff) | |
tools: add syz-env
syz-env provides a canned dev environment with all tools necessary
(Go, gcc, clang-format, etc) for development/testing in a form
of a Docker image. Example use:
$ syz-env make presubmit
$ syz-env make extract SOURCEDIR=~/linux
Update #1699
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/contributing.md | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/contributing.md b/docs/contributing.md index 6d5a1f321..fae689f6e 100644 --- a/docs/contributing.md +++ b/docs/contributing.md @@ -85,3 +85,28 @@ This adds git origin `my-origin` with your repository and checks out new branch - Nagivate to [github.com/google/syzkaller](https://github.com/google/syzkaller) and you should see green `Compare & pull request` button, press it. Then press `Create pull request`. Now your pull request should show up on [pull requests page](https://github.com/google/syzkaller/pulls). - If you don't see `Create pull request` button for any reason, you can create pull request manually. For that nagivate to [pull requests page](https://github.com/google/syzkaller/pulls), press `New pull request`, then `compare across forks` and choose `google/syzkaller`/`master` as base and `YOUR_GITHUB_USERNAME/syzkaller`/`my-branch` as compare and press `Create pull request`. - If you decided to rebase commits in `my-branch` (e.g. to rebase them onto updated master) after you created a pull-request, you will need to do a force push: `git push -f my-origin my-branch`. + +### Using syz-env + +Developing syzkaller requires a number of tools installed (Go toolchain, C/C++ cross-compilers, golangci-lint, etc). +Installing all of them may be cumbersome, e.g. due broken/missing packages. +[syz-env](/tools/syz-env) provides a working hermetic development environment based on a Docker container. +If you don't yet have Docker installed, see [documentation](https://docs.docker.com/engine/install), +in particular regarding enabling [sudo-less](https://docs.docker.com/engine/install/linux-postinstall) +Docker (Googlers see go/docker). + +It's recommended to create an alias for `syz-env` script: +``` +alias syz-env="$(go env GOPATH)/src/github.com/google/syzkaller/tools/syz-env" +``` +Then it can be used to wrap almost any make invocation as: +``` +syz-env make format +syz-env make presubmit +syz-env make extract SOURCEDIR=~/linux +``` +Or other commands/scripts, e.g.: +``` +syz-env go test -short ./pkg/csource +``` +Or you may run the shell inside of the container with just `syz-env` and look around. |