aboutsummaryrefslogtreecommitdiffstats
path: root/doc/protocols
diff options
context:
space:
mode:
Diffstat (limited to 'doc/protocols')
-rw-r--r--doc/protocols66
1 files changed, 66 insertions, 0 deletions
diff --git a/doc/protocols b/doc/protocols
new file mode 100644
index 0000000..4926b71
--- /dev/null
+++ b/doc/protocols
@@ -0,0 +1,66 @@
+---------------------------------------------------------------------
+
+Command: assign-id
+ Assign new ID to client, or fetch current ID
+
+Purpose: assigning ID to clients so server can respond to that client
+
+Compulsivity: manditory (core infrastructure)
+
+More documentation: doc/messages
+
+Reference implementation: mds-server
+
+---------------------------------------------------------------------
+
+Command: intercept
+ Sign up for reception of message
+
+Optional header: Stop
+ Stop reception of messages if `yes`
+
+Optional header: Priority
+ Signed 64-bit integer of reception priority (reversed of order)
+
+Optional header: Modifying
+ Send message asynchronously and await modification if `yes`
+
+Optional header: Length
+ Length of the message
+
+Message: list of headers and header–value-pairs that qualifies
+ a message for reception, all messages qualifies if this
+ list is empty
+
+Purpose: filter received message for clients and servers
+Purpose: assigned interception order for modification of messages
+
+Compulsivity: manditory (core infrastructure)
+
+More documentation: doc/messages
+
+Reference implementation: mds-server
+
+---------------------------------------------------------------------
+
+Command: echo
+ Echo back a message
+
+Required header: Client ID
+ Your ID, provided by `ID assignment`
+ in response to `Command: assign-id`
+
+Optional header: Length
+ Length of the message
+
+Message: message to echo
+
+Purpose: debugging and testing
+Purpose: network heartbeat
+
+Compulsivity: recommended for network enabled servers
+
+Reference implementation: mds-echo
+
+---------------------------------------------------------------------
+