Name

rpc_shutdown − shut down a server (server only)

Syntax

#include <idl/c/rpc.h>
 void rpc_$shutdown(status)
status_$t *status;

Arguments

status The completion status.  If the completion status returned in status.all is equal to status_$ok , then the routine that supplied it was successful. 

Description

The rpc_$shutdown routine shuts down a server. When this routine is executed, the server stops processing incoming calls and rpc_$listen returns.

If rpc_$shutdown is called from within a remote procedure, that procedure completes, and the server shuts down after replying to the caller.

Diagnostics

This section lists status codes for errors returned by this rpc_$ routine in status.all.

rpc_$comm_failure
The call could not be completed due to a communication problem.

rpc_$not_in_call An internal error. 

rpc_$proto_error An internal protocol error. 

Files

/usr/include/idl/c/rpc.h
/usr/include/idl/rpc.idl

See Also

intro(3ncs), rpc_allow_remote_shutdown(3ncs), rpc_listen(3ncs), rrpc_shutdown(3ncs)