RpcService - support RPC between a service and its clients

SYNOPSIS

       #include <Dispatch/rpcservice.h>

DESCRIPTION

       An RpcService (actually, an instance of a  derived  class)
       creates  a  port  and  listens  to it for connections from
       clients.  When a client opens a connection, the RpcService
       will  create a reader to handle RPC requests from the con-
       nection.

CONSTRUCTORS

       RpcService(int port)
       RpcService(const char* path, int port = 0)
              Start up an RPC service.  If a filename  is  given,
              record  the  RPC service's hostname and port number
              in it so  clients  can  contact  the  service.   If
              ``port'' is zero, the next free port number will be
              used.

PUBLIC OPERATIONS

       void run()
       void quitRunning()
              Read RPC  requests  continuously  until  ``quitRun-
              ning()''  terminates  the  loop.   If  you're using
              InterViews, you don't have to call ``run()''  since
              the  InterViews  event-reading  code will also read
              RPC requests.

PROTECTED OPERATIONS

       virtual void createReader(int fd) = 0
              You must define this function in a derived class in
              order  to  start  servicing RPC requests from a new
              client.  Typically all you have to do  is  to  con-
              struct  a  reader  using the passed file descriptor
              and make the reader responsible for deleting itself
              when it notices that the connection has been closed
              by the client.

SEE ALSO

       Dispatcher(3I), RpcReader(3I), RpcRegistry(3I)