summaryrefslogtreecommitdiffhomepage
path: root/libs/lucid-rpc
diff options
context:
space:
mode:
authorSteven Barth <steven@midlink.org>2009-06-13 18:16:34 +0000
committerSteven Barth <steven@midlink.org>2009-06-13 18:16:34 +0000
commitf9263e00c1371eff6ace0252143236d6bf6f2ce2 (patch)
tree454726cc6d1e60fcd5a8bdba66ff1cef8041b694 /libs/lucid-rpc
parent120a7f558e27f2ca11b3dae251528d7100ca259d (diff)
GSoC: Documentation #1
Diffstat (limited to 'libs/lucid-rpc')
-rw-r--r--libs/lucid-rpc/docs/OVERVIEW19
1 files changed, 19 insertions, 0 deletions
diff --git a/libs/lucid-rpc/docs/OVERVIEW b/libs/lucid-rpc/docs/OVERVIEW
new file mode 100644
index 000000000..9da870065
--- /dev/null
+++ b/libs/lucid-rpc/docs/OVERVIEW
@@ -0,0 +1,19 @@
+ LuCId JSON-RPC Server Slave
+
+*** Abstract ***
+The LuCId JSON-RPC server slave implements the JSON-RPC 1.0 and 2.0 protocol
+to allow efficient light-weight remote procedure calling.
+It provides notification support and several unofficial protocol extensions such
+as:
+ * Close notifications
+ * Raw TCP switching to transfer BLOBs efficiently
+ * Client notification
+
+
+*** Workflow ***
+After receiving an incoming connection from LuCId, the slave analyses the
+request and passes it to the matching handler. The handler will enforce
+access restriction and deserialize the payload data and invokes the assigned
+Lua function in a protected way. In case of a success the handler will serialize
+the response and send it to the client - otherwise a detailed error message
+will be returned. \ No newline at end of file