rpc_listen(3ncs) rpc_listen(3ncs)
Name
rpc_listen - listen for and handle remote procedure call (RPC) packets (server only)
Syntax
#include <idl/c/rpc.h>
void rpc_$listen(max_calls, status)
unsigned long max_calls;
status_$t *status;
Arguments
max_calls This value indicates the maximum number of calls that the server is allowed to process concurrently. On ULTRIX systems,
this value should be 1; any other value is ignored and defaulted to one.
status The completion status. If the completion status returned in is equal to status_$ok , then the routine that supplied it was
successful.
Description
The routine dispatches incoming remote procedure call requests to manager procedures and returns the responses to the client. You must
issue or before you use This routine normally does not return. A return from this routine indicates either an irrecoverable error, or that
an call has been issued. If is equal to status_$ok , the assumption is that has occurred.
Examples
Listen for incoming remote procedure call requests.
rpc_$listen (1, &status);
Diagnostics
This section lists status codes for errors returned by this routine in
rpc_$not_in_call An internal error.
rpc_$you_crashed This error can occur if a server has crashed and restarted. A client RPC runtime library sends the error to the server
if the client makes a remote procedure call before the server crashes, then receives a response after the server
restarts.
rpc_$proto_error An internal protocol error.
rpc_$bad_pkt The server or client has received an ill-formed packet.
Files
See Also
intro(3ncs), rpc_shutdown(3ncs)
rpc_listen(3ncs)
