Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rrpc_inq_stats(3ncs) [ultrix man page]

rrpc_inq_stats(3ncs)													      rrpc_inq_stats(3ncs)

Name
       rrpc_inq_stats - obtain statistics about a server

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

       void rrpc_$inq_stats(handle, max_stats, stats, l_stat, status)
       handle_t handle;
       unsigned long max_stats;
       rrpc_$stat_vec_t stats;
       unsigned long *l_stat;
       status_$t *status;

Arguments
       handle	 A remote procedure call (RPC) handle .

       max_stats The maximum number of elements in the array of statistics.

       stats	 An  array  of 32-bit integers representing statistics about the server.  A set of rrpc_$sv constants defines indices for the ele-
		 ments in this array.  The following list describes the statistic indexed by each rrpc_$sv constant:

		   rrpc_$sv_calls_in
			     The number of calls processed by the server.

		   rrpc_$sv_rcvd
			     The number of packets received by the server.

		   rrpc_$sv_sent
			     The number of packets sent by the server.

		   rrpc_$sv_calls_out
			     The number of calls made by the server.

		   rrpc_$sv_frag_resends
			     The number of fragments sent by the server that duplicated previous sends.

		   rrpc_$sv_dup_frags_rcvd
			     The number of duplicate fragments received by the server.

       l_stat	 The index of the last element in the returned array.

       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 returns an array of integer statistics about a server.

Restrictions
       On  the	client	side,  because	of the way the calls are defined and implemented in the run-time library you must explicitly call into the
       entry point vector table for the interface to send an request across the network. The following is an example  of  a  call  that  works	as
       desired:
       (*rrpc_$client_epv.rrpc_$inq_stats)(handle,
	       (unsigned long) max_stats, stats, &l_stat ,&status);

       The server sidestub routine calls the entry oint on behalf of the client.  The results of the call are then passed back to the client.

Files
See Also
       intro(3ncs)

															      rrpc_inq_stats(3ncs)

Check Out this Related Man Page

rpc_listen(3ncs)														  rpc_listen(3ncs)

Name
       rpc_listen - listen for and handle remote procedure call (RPC) packets (server only)

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

       void rpc_$listen(max_calls, status)
       unsigned long max_calls;
       status_$t *status;

Arguments
       max_calls      This  value  indicates  the  maximum number of calls that the server is allowed to process concurrently.	On ULTRIX systems,
		      this value should be 1; any other value is ignored and defaulted to one.

       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  dispatches  incoming  remote procedure call requests to manager procedures and returns the responses to the client.  You must
       issue or before you use This routine normally does not return.  A return from this routine indicates either an irrecoverable error, or that
       an call has been issued.  If is equal to status_$ok , the assumption is that has occurred.

Examples
       Listen for incoming remote procedure call requests.
       rpc_$listen (1, &status);

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.

       rpc_$bad_pkt	   The server or client has received an ill-formed packet.

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

																  rpc_listen(3ncs)
Man Page