diff options
| author | Dmitry Vyukov <dvyukov@google.com> | 2017-06-29 16:01:03 +0200 |
|---|---|---|
| committer | Dmitry Vyukov <dvyukov@google.com> | 2017-06-29 17:50:44 +0200 |
| commit | c5b6fcddca80153daba328334bc48caa3a546ab5 (patch) | |
| tree | ffe7680d084c29bec80f912a087b155981392e79 /docs/hub.md | |
| parent | ae33f0dff59bbd493d48eabe521b33981a785271 (diff) | |
syz-hub: split client name and manager name
This allows to reduce number of hub clients by grouping managers
and creating one client per such group.
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. |
