diff options
Diffstat (limited to 'doc/protocols')
-rw-r--r-- | doc/protocols | 66 |
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 + +--------------------------------------------------------------------- + |