rpcwriter(3i) [debian man page]

RpcWriter(3I)						    InterViews Reference Manual 					     RpcWriter(3I)

NAME

       RpcWriter - write RPC requests to a server

SYNOPSIS

       #include <Dispatch/rpcwriter.h>

DESCRIPTION

       An  RpcWriter (actually, an instance of a class derived from RpcWriter) writes RPC requests to a server.  Derived classes should add member
       functions that send RPC requests corresponding to the RPC service's protocol.

CONSTRUCTORS

       RpcWriter(const char* path, boolean fatal, boolean binary)
       RpcWriter(const char* host, int port, boolean fatal, boolean binary)
       RpcWriter(int fd, boolean fatal, boolean binary)
       RpcWriter(rpcstream* server)
	      Open a connection to an RPC service at its registered host name and port number, or give the host name and  port	number	needed	to
	      open  a connection to the RPC service, or give the number of an already open file descriptor, or give the address of an already open
	      rpcstream (connection).  Negotiate the I/O format (binary or formatted) if opening a connection.	Terminate the  program	if  errors
	      should be fatal.

SEE ALSO

       RpcHdr(3I), RpcRegistry(3I), rpcstream(3I)

InterViews							   27 March 1991						     RpcWriter(3I)

RpcPeer(3I)						    InterViews Reference Manual 					       RpcPeer(3I)

NAME

       RpcPeer - support bi-directional RPC between two services

SYNOPSIS

       #include <Dispatch/rpcpeer.h>

DESCRIPTION

       An  RpcPeer (actually, an instance of a derived class) tries to open a connection to another RpcPeer.  If the other RpcPeer is not yet run-
       ning, the RpcPeer will create its own port and wait for the other RpcPeer to open a connection.	When either RpcPeer  opens  a  connection,
       each RpcPeer will create both a reader and a writer so each RpcPeer can send RPC requests to its opposite over the same connection.

CONSTRUCTOR

       RpcPeer(const char* lPath, int lPort = 0)
	      Store  the arguments for later use since a base constructor can't call a derived class's virtual function.  The derived class's con-
	      structor should call ``init'', described below.

       void init(const char* rPath)
	      Find the host name and port number registered by the other RpcPeer and try to open a connection to it.  If it's not running,  create
	      our own port and wait for the other RpcPeer to open a connection.

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 boolean createReaderAndWriter(const char* rHost, int rPort) = 0
       virtual void createReaderAndWriter(int fd) = 0
	      You must define both functions in a derived class in order to start reading and writing RPC requests over the connection.  Typically
	      both functions would create a writer using the given parameters and then attach a reader to the writer's rpcstream.

SEE ALSO

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

InterViews							   27 March 1991						       RpcPeer(3I)