rrpc_shutdown man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

rrpc_shutdown(3ncs)					   rrpc_shutdown(3ncs)

Name
       rrpc_shutdown - shut down a server

Syntax
       #include <idl/c/rrpc.h>

       void rrpc_$shutdown(handle, status)
       handle_t handle;
       status_$t *status;

Arguments
       handle A remote procedure call (RPC) handle.

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

Description
       The routine shuts down a server, if the server allows it.  A server can
       use the routine to allow or disallow remote shutdown.

Diagnostics
       This section lists status codes for errors returned by this routine in

       rrpc_$shutdown_not_allowd
	      You send an request to a server that has not issued an call.

Restrictions
       On the client side, because of the way the calls are defined and imple‐
       mented  in the run-time library you must explicitly call into the entry
       point vector table for the interface to send an request across the net‐
       work. The following is an example of a call that works as desired:
       (*rrpc_$client_epv.rrpc_$shutdown)(handle, &status);

       The  server  side  stub	routine calls the entry point on behalf of the
       client.	The results of the call are then passed back to the client.

       Before making the shutdown call, the server must have  previously  exe‐
       cuted the following call:
       rpc_$allow_remote_shutdown((unsigned long) TRUE,NULL,&status);

       If the server has not allowed remote shutdown, the call returns an sta‐
       tus code.

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

							   rrpc_shutdown(3ncs)
[top]

List of man pages available for Ultrix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net