rpc_allow_remote_shutdown(3ncs)rpc_allow_remote_shutdown(3ncs)Namerpc_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' other‐
wise.
checkproc A pointer to a Boolean function.
status The completion status. If the completion status
returned in is equal to status_$ok , then the rou‐
tine that supplied it was successful.
Description
The routine allows or disallows remote callers to shut down a server
using
By default, servers do not allow remote shutdown via If a server calls
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 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.
FilesSee Alsointro(3ncs), rpc_shutdown(3ncs), rrpc_shutdown(3ncs)rpc_allow_remote_shutdown(3ncs)