remote server

rpc_allow_remote_shutdown(3ncs) 										   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 is equal to status_$ok , then the routine 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.

Files
See Also
       intro(3ncs), rpc_shutdown(3ncs), rrpc_shutdown(3ncs)

														   rpc_allow_remote_shutdown(3ncs)