rpc(n)								 Tnm Tcl Extension							    rpc(n)

__________________________________________________________________________________________________________________________________________________

NAME

       rpc - A simple RPC protocol for Tcl applications.
_________________________________________________________________

DESCRIPTION

RPC COMMAND

       rpc server port
	      Set  up  an  RPC	server	listening  an port port. This command returns a rpc handle that be used to register Tcl procs that will be
	      exported by a trivial RPC protocol on top of TCP. This RPC mechanism allows us to write cooperating scripts  without  worrying  much
	      about the communication protocol.

       rpc client host port
	      Connect  to the RPC server running on host with port port.  The returned client handle can be used to invoke an exported proc on the
	      server host.

       rpc delete handle
	      Delete a server or a client RPC handle. All connections associated with the handle will be closed.

       rpc register rpchandle proc
	      Export proc as an RPC callable proc using the server handle rpchandle. Only registered procs can be called by RPC clients.

       rpc unregister rpchandle proc
	      Remove proc from the list of exported procs on server handle rpchandle.

       rpc info [rpchandle]
	      Calling rpc info without any arguments returns a list of all rpc handles that have been created using the rpc server and rpc  client
	      command.	 Info about a specific rpc file handle rpchandle is returned by using the optional argument. The result is a list contain-
	      ing the tcp file handle used for the communication and the list of registered commands for a rpc handle and a list of all files that
	      represent connections to an rpc server. This list is empty if rpchandle belongs to a rpc client.

       rpc# [-async] proc arg1 arg2 ...
	      To  invoke  a remote procedure proc, use the same syntax as used with a local invocation preceeded by a client rpchandle. The result
	      of the remote procedure call will be returned or an error if the underlying communication channel signals errors. The -async options
	      can be used to invoke proc without waiting for it to complete. The async option will never return a result.

SEE ALSO

       scotty(1), Tcl(n)

AUTHORS

       Juergen Schoenwaelder <schoenw@cs.utwente.nl>

Tnm																	    rpc(n)