NAME

       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 connection.

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  ``quitRunning()''  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  construct  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)