docs: move syz-hub page from wiki

This commit is contained in:
Andrey Konovalov 2017-06-14 13:31:32 +02:00
parent 4939b55f03
commit 5c5bc1c0ea

28
docs/tools_syz-hub.md Normal file
View File

@ -0,0 +1,28 @@
# Tools: syz-hub
`syz-hub` program can be used to connect several `syz-manager`'s together and allow them to exchange programs.
Build `syz-hub` with `go install github.com/google/syzkaller/syz-hub`. Then create a config file along the lines of:
```
{
"http": ":80",
"rpc": ":55555",
"workdir": "/syzkaller/workdir",
"managers": [
{"name": "manager1", "key": "6sCFsJVfyFQVhWVKJpKhHcHxpCH0gAxL"},
{"name": "manager2", "key": "FZFSjthHHf8nKm2cqqAcAYKM5a3XM4Ao"},
{"name": "manager3", "key": "fTrIBQCmkEq8NsvQXZiOUyop6uWLBuzf"}
]
}
```
And start it with `$GOPATH/syz-hub -config hub.cfg`. Then add the following additional parameters to `syz-manager` config files of each manager:
```
"name": "manager1",
"hub_addr": "1.2.3.4:55555",
"hub_key": "6sCFsJVfyFQVhWVKJpKhHcHxpCH0gAxL",
```
And start managers. Once they triage local corpus, they will connect to the hub and start exchanging inputs. Both hub and manager web pages will show how many inputs they send/receive from the hub.