From d79c943631b2d118983e60a04eb88578157d9632 Mon Sep 17 00:00:00 2001 From: Ulas Kozat Date: Wed, 1 Jun 2016 12:03:33 -0700 Subject: Removed trailing white spaces in api-documentation.rst Change-Id: I00a746c13987c9fd6085a73fa1a4c3cde31b146b Signed-off-by: Ulas Kozat --- docs/userguide/api-documentation.rst | 79 +++++++++++++++++++++++++++++++++++- 1 file changed, 77 insertions(+), 2 deletions(-) mode change 100644 => 100755 docs/userguide/api-documentation.rst (limited to 'docs/userguide/api-documentation.rst') diff --git a/docs/userguide/api-documentation.rst b/docs/userguide/api-documentation.rst old mode 100644 new mode 100755 index b588dc9..2937127 --- a/docs/userguide/api-documentation.rst +++ b/docs/userguide/api-documentation.rst @@ -11,8 +11,30 @@ | 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 -t + +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 -l ... -l -t -t ... -t + +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 + +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 ==================== -- cgit 1.2.3-korg