diff options
Diffstat (limited to 'docs/hub.md')
| -rw-r--r-- | docs/hub.md | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/docs/hub.md b/docs/hub.md new file mode 100644 index 000000000..7b7cb3f8c --- /dev/null +++ b/docs/hub.md @@ -0,0 +1,33 @@ +# Connecting several managers via Hub + +`syz-hub` program can be used to connect several `syz-manager`'s together and +allow them to exchange programs. + +Build `syz-hub` with `make hub`. Then create a config file along the lines of: + +``` +{ + "http": ":80", + "rpc": ":55555", + "workdir": "/syzkaller/workdir", + "clients": [ + {"name": "manager1", "key": "6sCFsJVfyFQVhWVKJpKhHcHxpCH0gAxL"}, + {"name": "manager2", "key": "FZFSjthHHf8nKm2cqqAcAYKM5a3XM4Ao"}, + {"name": "manager3", "key": "fTrIBQCmkEq8NsvQXZiOUyop6uWLBuzf"} + ] +} +``` + +And start it with `bin/syz-hub -config hub.cfg`. Then add the following +additional parameters to `syz-manager` config files of each manager: + +``` + "name": "manager1", + "hub_client": "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. |