aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorAndrey Konovalov <andreyknvl@google.com>2017-06-14 13:31:32 +0200
committerAndrey Konovalov <andreyknvl@google.com>2017-06-14 13:31:32 +0200
commit5c5bc1c0ea277cb49d445b43d1b2bd4bf2451764 (patch)
treedc77a1a0daa6ec0c93857c0c946d993695478a04 /docs
parent4939b55f03a495a339b77703b5460a77bc4791ed (diff)
docs: move syz-hub page from wiki
Diffstat (limited to 'docs')
-rw-r--r--docs/tools_syz-hub.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/tools_syz-hub.md b/docs/tools_syz-hub.md
new file mode 100644
index 000000000..626466403
--- /dev/null
+++ b/docs/tools_syz-hub.md
@@ -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.