Removed trailing white spaces in api-documentation.rst 99/14999/1
authorUlas Kozat <ulas.kozat@gmail.com>
Wed, 1 Jun 2016 19:03:33 +0000 (12:03 -0700)
committerUlas Kozat <ulas.kozat@gmail.com>
Wed, 1 Jun 2016 19:03:40 +0000 (12:03 -0700)
Change-Id: I00a746c13987c9fd6085a73fa1a4c3cde31b146b
Signed-off-by: Ulas Kozat <ulas.kozat@gmail.com>
docs/userguide/api-documentation.rst [changed mode: 0644->0755]

old mode 100644 (file)
new mode 100755 (executable)
index b588dc9..2937127
 |
 Using domino-cli Client
 =======================
+Make sure that domino-cli.py is in +x mode.
 
-* heartbeat message
+Change directory to where domino-cli.py is located or include file path in the PATH environment variable
+
+* Registration Command
+
+Command line input:
+
+.. code-block:: bash
+
+  ./domino-cli.py register
+
+This message has the following fields that are automatically filled in.
+
+.. code-block:: bash
+
+  Message Type (= REGISTER)
+  DESIRED UDID (= if not allocated, this will be assigned as Unique Domino ID)
+  Sequence Number (=incremented after each RPC call)
+  IP ADDR (= IP address of DOMINO Client to be used by DOMINO Server for future RPC Calls to this client)
+  TCP PORT (= TCP port of DOMINO Client to be used by DOMINO Server for future RPC Calls to this client)
+  Supported Templates (= Null, this field not used currently)
+
+* Heart Beat Command
 
 Command line input:
 
@@ -25,8 +47,61 @@ This message has the following fields that are automatically filled in.
 .. code-block:: bash
 
   Message Type (= HEART_BEAT)
-  UDID (= assigned during registration)
+  UDID (= Unique Domino ID assigned during registration)
+  Sequence Number (=incremented after each RPC call)
+
+* Label and Template Type Subscription Command
+
+.. code-block:: bash
+
+  ./domino-cli.py subscribe -l <labelname> -t <templatetype>
+
+Note that -l can be substituted by --label and -t can be substituted by --ttype.
+
+To subscribe more than one label or template type, one can repeat the options -l and -t, e.g.:
+
+.. code-block:: bash
+
+  ./domino-cli.py subscribe -l <label1> -l <label2> ... -l <labeln> -t <ttype1> -t <ttype2> ... -t <ttypen>
+
+It is safe to call subscribe command multiple times with duplicate labels.
+
+This message has the following fields that are automatically filled in.
+
+.. code-block:: bash
+
+  Message Type (= SUBSCRIBE)
+  UDID (= Unique Domino IDassigned during registration)
+  Sequence Number (=incremented after each RPC call)
+  Template Operation (= APPEND)
+  Label Operation (= APPEND)
+
+The following fields are filled in based on arguments passed on via -l/--label and -t/--ttype flags
+
+.. code-block:: bash
+
+  Supported Template Types
+  Supported Labels
+
+* Template Publishing Command
+
+.. code-block:: bash
+
+  ./domino-cli.py publish -t <toscafile>
+
+Note that -t can be substituted by --tosca-file.
+
+If -t or --tosca-file flag is used multiple times, the last tosca file passed as input will be used. This usage is not recommended as undefined/unintended results may emerge as the Domino client will continue to publish.
+
+This message has the following fields that are automatically filled in.
+
+.. code-block:: bash
+
+  Message Type (= SUBSCRIBE)
+  UDID (= Unique Domino IDassigned during registration)
   Sequence Number (=incremented after each RPC call)
+  Template Type (= TOSCA)
+  Template File
 
 Interactive CLI mode
 ====================