Scroll to navigation

RpcService(3I) InterViews Reference Manual RpcService(3I)

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

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

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

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)

27 March 1991 InterViews