1 files changed, 59 insertions, 8 deletions

diff --git a/bbot/agent.cli b/bbot/agent.cli
index 562860f..3e02807 100644
--- a/bbot/agent.cli
+++ b/bbot/agent.cli
@@ -11,22 +11,19 @@ include <bbot/common.cli>;
 namespace bbot
 {
   {
-    "<options> <name> <num> <id> ",
+    "<options> <url>",
 
     "
     \h|SYNOPSIS|
 
     \cb{bbot-agent --help}\n
     \cb{bbot-agent --version}\n
-    \c{\b{bbot-agent} [<options>] <name> <num> <id>}
+    \c{\b{bbot-agent} [<options>] <url>...}
 
     \h|DESCRIPTION|
 
     \cb{bbot-agent} @@ TODO.
 
-    The <name> argument is the toolchain name, <id> \- the toolchain id,
-    and <num> \- the toolchain number in this deployment.
-
     Note that on termination \cb{bbot-agent} may leave a working machine
     snapshot behind. It is expected that the caller (normally Build OS
     monitor) cleans them up before restarting the agent.
@@ -45,6 +42,26 @@ namespace bbot
       "Start as a simple systemd daemon."
     }
 
+    string --toolchain-name = "default"
+    {
+      "<str>",
+      "Toolchain name, \cb{default} by default."
+    }
+
+    size_t --toolchain-num = 1
+    {
+      "<num>",
+      "Toolchain number, 1 by default."
+    }
+
+    string --toolchain-id
+    {
+      "<str>",
+      "Toolchain id. If unspecified or empty, then no re-bootstrapping on
+       toolchain changes will be performed (which is primarily useful for
+       testing)."
+    }
+
     size_t --cpu = 1
     {
       "<num>",
@@ -60,8 +77,13 @@ namespace bbot
     dir_path --machines = "/build/machines/"
     {
       "<dir>",
-      "The location of the build machines with \cb{/build/machines/} being
-       the default."
+      "The location of the build machines, \cb{/build/machines/} by default."
+    }
+
+    dir_path --tftp = "/build/tftp/"
+    {
+      "<dir>",
+      "The location of the TFTP server root, \cb{/build/tftp/} by default."
     }
 
     size_t --bootstrap-timeout = 600
@@ -78,6 +100,13 @@ namespace bbot
        minutes) by default."
     }
 
+    size_t --request-timeout = 300
+    {
+      "<sec>",
+      "Maximum number of seconds to wait for controller request completion,
+       300 (5 minutes) by default."
+    }
+
     uint16_t --verbose = 1
     {
       "<level>",
@@ -89,15 +118,37 @@ namespace bbot
     //
     bool --dump-machines
     {
-      "Dump available machines to \c{stdout}, (re)-bootstrapping any if
+      "Dump the available machines to \cb{stdout}, (re)-bootstrapping any if
        necessary, and exit."
     }
 
+    bool --dump-task
+    {
+      "Dump the received build task to \cb{stdout} and exit."
+    }
+
+    bool --dump-result
+    {
+      "Dump the obtained build result to \cb{stdout} and exit."
+    }
+
     bool --fake-bootstrap
     {
       "Fake the machine bootstrap process by creating the expected bootstrapped
        machine manifest."
     }
+
+    bool --fake-build
+    {
+      "Fake the package building process by creating the aborted build result."
+    }
+
+    path --fake-request
+    {
+      "<file>",
+      "Fake the task request process by reading the task manifest from <file>
+       (or \cb{stdin} if <file> is '\cb{-}')."
+    }
   };
 
   "