If you want to contribute to the project, feel free to send a pull request.
Before sending a pull request you need to sign Google CLA (if you don't a bot will ask you to do that) and add yourself to AUTHORS/CONTRIBUTORS files (in case this is your first pull request to syzkaller).
Some guildelines to follow:
package: one-line description <empty line> Extended multi-line description that includes the problem you are solving and how it is solved.
package is the package/tool this commit changes (look at examples in the commit history)
make presubmitand ensure that it passes before sending a PR. It may require some additional packages to be installed (try
sudo make install_prerequisites)
Extending/improving system call descriptions is always a good idea.
Unassigned issues from the bug tracker are worth doing, but some of them might be complicated.
If you want to work on something non-trivial, please briefly describe it on the firstname.lastname@example.org mailing list first, so that there is agreement on high level approach and no duplication of work between contributors.
Forkbutton in the top-right corner of the page. This will create
gocommand the checkout must be under
$GOPATH. The simplest way to do it is to run
go get github.com/google/syzkaller, this will checkout the repository in
cd $GOPATH/src/github.com/google/syzkaller git remote add my-origin https://github.com/YOUR_GITHUB_USERNAME/syzkaller.git git fetch my-origin git checkout -b my-branch master
This adds git origin
my-origin with your repository and checks out new branch
my-branch based on
git addfor all changed files, e.g.
git add sys/linux/sys.txt. You can run
git statusto see what files were changed/created. When all files are added (
git statusshows no files in
Changes not staged for commitsection and no relevant files in
Untracked filessection), run
git commitand enter commit description in your editor.
make install_prerequisitesfollowed by
go fmtand you’re seeing the presubmit fail on
check_diff, then you may need to use an older version of go to format your code. (Version 1.11 in particular introduced a breaking change, see here and here for details). A simple way to do this is:
go1.10 download # Default download path is here. ~/sdk/go1.10/bin/go fmt [target files]```
git push my-origin my-branch.
Compare & pull requestbutton, press it. Then press
Create pull request. Now your pull request should show up on pull requests page.
Create pull requestbutton for any reason, you can create pull request manually. For that nagivate to pull requests page, press
New pull request, then
compare across forksand choose
masteras base and
my-branchas compare and press
Create pull request.
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.