From 5c5bc1c0ea277cb49d445b43d1b2bd4bf2451764 Mon Sep 17 00:00:00 2001
From: Andrey Konovalov <andreyknvl@google.com>
Date: Wed, 14 Jun 2017 13:31:32 +0200
Subject: [PATCH] docs: move syz-hub page from wiki

---
 docs/tools_syz-hub.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 docs/tools_syz-hub.md

diff --git a/docs/tools_syz-hub.md b/docs/tools_syz-hub.md
new file mode 100644
index 00000000..62646640
--- /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.