rpc_listen(3ncs)rpc_listen(3ncs)Namerpc_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 man‐
ager 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 assump‐
tion 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.
FilesSee Alsointro(3ncs), rpc_shutdown(3ncs)rpc_listen(3ncs)