rpc_allow_remote_shutdown(3ncs)
Name
rpc_allow_remote_shutdown − allow or disallow remote shutdown of a server (server only)
Syntax
#include <idl/c/rpc.h>
void rpc_$allow_remote_shutdown(allow, checkproc, status)
unsigned long allow;
rpc_$shut_check_fn_t checkproc;
status_$t *status;
Arguments
allow A value indicating ‘false’ if zero, ‘true’ otherwise.
checkproc A pointer to a Boolean function.
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_$allow_remote_shutdown routine allows or disallows remote callers to shut down a server using rrpc_$shutdown.
By default, servers do not allow remote shutdown via rrpc_$shutdown. If a server calls rpc_$allow_remote_shutdown with allow true (not zero) and checkproc nil, then remote shutdown will be allowed. If allow is true and checkproc is not nil, then when a remote shutdown request arrives, the function denoted by checkproc is called and the shutdown is allowed if the function returns true. If allow is false (zero), remote shutdown is disallowed.
Diagnostics
This section lists status codes for errors returned by this rpc_$ routine in status.all.
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.
Files
/usr/include/idl/c/rpc.h
/usr/include/idl/rpc.idl