From 7f0ad6665bf9e2ae8260bcec13f47e5b97cf0a40 Mon Sep 17 00:00:00 2001
From: Darko Poljak <darko.poljak@gmail.com>
Date: Mon, 31 Oct 2016 18:42:16 +0100
Subject: [PATCH] Add trigger to cdist man page.

---
 docs/src/man1/cdist.rst | 71 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/docs/src/man1/cdist.rst b/docs/src/man1/cdist.rst
index 45ce339e..c9384aaa 100644
--- a/docs/src/man1/cdist.rst
+++ b/docs/src/man1/cdist.rst
@@ -27,6 +27,11 @@ SYNOPSIS
 
     cdist shell [-h] [-d] [-v] [-s SHELL]
 
+    cdist trigger [-h] [-d] [-v] [-b] [-c CONF_DIR] [-i MANIFEST]
+                  [-j [JOBS]] [-n] [-o OUT_PATH]
+                  [--remote-copy REMOTE_COPY] [--remote-exec REMOTE_EXEC]
+                  [-6] [-H HTTP_PORT]
+
 
 DESCRIPTION
 -----------
@@ -148,6 +153,67 @@ usage. Its primary use is for debugging type parameters.
     Select shell to use, defaults to current shell. Used shell should
     be POSIX compatible shell.
 
+
+TRIGGER
+-------
+Start trigger (simple http server) that waits for connections. When host
+connects then it triggers config or install command, cdist config is then
+executed which configures/installs host.
+Request path recognies following formats:
+
+* :strong:`/config/.*` for config
+* :strong:`/install/.*` for install 
+
+
+.. option:: -6, --ipv6
+
+    Listen to both IPv4 and IPv6 (instead of only IPv4)
+
+.. option:: -b, --enable-beta
+
+    Enable beta functionalities.
+
+.. option:: -c CONF_DIR, --conf-dir CONF_DIR
+
+    Add configuration directory (can be repeated, last one wins)
+
+.. option:: -d, --debug
+
+    Set log level to debug
+
+.. option:: -H HTTP_PORT, --http-port HTTP_PORT
+
+    Create trigger listener via http on specified port
+
+.. option:: -h, --help
+
+    show this help message and exit
+
+.. option:: -i MANIFEST, --initial-manifest MANIFEST
+
+    path to a cdist manifest or '-' to read from stdin.
+
+.. option:: -n, --dry-run
+
+    do not execute code
+
+.. option:: -o OUT_PATH, --out-dir OUT_PATH
+
+    directory to save cdist output in
+
+.. option:: --remote-copy REMOTE_COPY
+
+    Command to use for remote copy (should behave like scp)
+
+.. option:: --remote-exec REMOTE_EXEC
+
+    Command to use for remote execution (should behave like ssh)
+
+.. option:: -v, --verbose
+
+    Set log level to info, be more verbose
+
+
 FILES
 -----
 ~/.cdist
@@ -199,6 +265,11 @@ EXAMPLES
     # Install ikq05.ethz.ch with debug enabled
     % cdist install -d ikq05.ethz.ch
 
+    # Start trigger in verbose mode that will configure host using specified
+    # init manifest
+    % cdist trigger -b -v -i ~/.cdist/manifest/init-for-triggered
+
+
 ENVIRONMENT
 -----------
 TMPDIR, TEMP, TMP