[noctool-cvs] CVS source/docs

[imattsson]

Update of /project/noctool/cvsroot/source/docs
In directory clnet:/tmp/cvs-serv1391/docs

Added Files:
	noctool-protocol.txt 
Log Message:
IM

Ooops, forgot to shift one doc file at initial check-in.



--- /project/noctool/cvsroot/source/docs/noctool-protocol.txt	2008/06/06 06:18:33	NONE
+++ /project/noctool/cvsroot/source/docs/noctool-protocol.txt	2008/06/06 06:18:33	1.1
NOCTOOL inter-node protocol

* Status messages
** Message Encapsulation
  All messages are sent in a "message" container, as follows:
  (message <protocol message> <digest>)

  The digest is a HMAC-SHA1, keyed by the secret for that connection.
  
** General error

  (protocol-error)


*Session control
**Session initialisation
  (iam <nodename>)  
**Session termination
  Either party sends:
  (session-terminate)

  Both ends close down the TCP connection

*Proxy objects
**Requesting proxy objects
  (request-proxy-class <class name>)
  (request-proxy-equipment <object identifier>)
  (request-proxy-graph <monitor identifier>)

**Proxy wire protocol
  (proxy-equipment
    (id <id>)
    (classes <class> ...)
    (name "<string>")
    [(monitors
      (monitor (id <id>)
               (type <monitor-type>)
	       (alert-level <number>)))])
  (proxy-update
    (id <id>)
    (alert-level <number>))
  (proxy-graph
    (id <id>)
    (type <graph type>)
    (values <vector of svalues> <vector of mvalues> <vector of lvalues>))
   (graph-update
     (id <id>)
     (measure <value>))
   (class-list
     (proxy-equipment ...))

**Deleting proxies
  (delete-proxy <id>)