rnusers(3rpc) [opensolaris man page]

rusers(3RPC)						       RPC Library Functions						      rusers(3RPC)

NAME

       rusers, rnusers - return information about users on remote machines

SYNOPSIS

       cc [ flag ... ] file ... -lrpcsvc [ library ... ]
       #include <rpc/rpc.h>
       #include <rpcsvc/rusers.h>

       enum clnt_stat rusers(char *host, struct utmpidlearr *up);

       int rnusers(char *host);

PROTOCOL

       /usr/include/rpcsvc/rusers.x

DESCRIPTION

       These  routines	require  that  the rpc.rusersd(1M) daemon be configured and available on the remote system indicated by host. The rusers()
       protocol is used to retrieve information about users logged in on the remote system.

       rusers() fills the utmpidlearr structure with data about host, and returns 0 if successful. up  must  point  to	an  allocated  utmpidlearr
       structure.  If  rusers()  returns  successful  it  will	have allocated data structures within the up structure, which should be freed with
       xdr_free(3NSL) when you no longer need them:

	 xdr_free(xdr_utimpidlearr, up);

       On error, the returned value can be interpreted as an  enum clnt_stat and can be displayed with clnt_perror(3NSL) or  clnt_sperrno(3NSL).

       See the header  <rpcsvc/rusers.h> for a definition of struct  utmpidlearr.

       rnusers() returns the number of users logged on to host (-1 if it cannot determine that number).

       The following  XDR routines are available in librpcsvc:

	 xdr_utmpidlearr

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       rusers(1), rpc.rusersd(1M), rpc_clnt_calls(3NSL), xdr_free(3NSL), attributes(5)

SunOS 5.11							    30 Dec 1996 						      rusers(3RPC)

xdr(3NSL)					       Networking Services Library Functions						 xdr(3NSL)

NAME

       xdr - library routines for external data representation

DESCRIPTION

       XDR  routines  allow  C programmers to describe arbitrary data structures in a machine-independent fashion. Data for remote procedure calls
       (RPC) are transmitted using these routines.

   Index to Routines
       The following table lists XDR routines and the manual reference pages on which they are described:

       XDR Routine			Manual Reference Page

       xdr_array		       xdr_complex(3NSL)

       xdr_bool 		       xdr_simple(3NSL)

       xdr_bytes		       xdr_complex(3NSL)

       xdr_char 		       xdr_simple(3NSL)

       xdr_control		       xdr_admin(3NSL)

       xdr_destroy		       xdr_create(3NSL)

       xdr_double		       xdr_simple(3NSL)

       xdr_enum 		       xdr_simple(3NSL)

       xdr_float		       xdr_simple(3NSL)

       xdr_free 		       xdr_simple(3NSL)

       xdr_getpos		       xdr_admin(3NSL)

       xdr_hyper		       xdr_simple(3NSL)

       xdr_inline		       xdr_admin(3NSL)

       xdr_int			       xdr_simple(3NSL)

       xdr_long 		       xdr_simple(3NSL)

       xdr_longlong_t		       xdr_simple(3NSL)

       xdr_opaque		       xdr_complex(3NSL)

       xdr_pointer		       xdr_complex(3NSL)

       xdr_quadruple		       xdr_simple(3NSL)

       xdr_reference		       xdr_complex(3NSL)

       xdr_setpos		       xdr_admin(3NSL)

       xdr_short		       xdr_simple(3NSL)

       xdr_sizeof		       xdr_admin(3NSL)

       xdr_string		       xdr_complex(3NSL)

       xdr_u_char		       xdr_simple(3NSL)

       xdr_u_hyper		       xdr_simple(3NSL)

       xdr_u_int		       xdr_simple(3NSL)

       xdr_u_long		       xdr_simple(3NSL)

       xdr_u_longlong_t 	       xdr_simple(3NSL)

       xdr_u_short		       xdr_simple(3NSL)

       xdr_union		       xdr_complex(3NSL)

       xdr_vector		       xdr_complex(3NSL)

       xdr_void 		       xdr_simple(3NSL)

       xdr_wrapstring		       xdr_complex(3NSL)

       xdrmem_create		       xdr_create(3NSL)

       xdrrec_create		       xdr_create(3NSL)

       xdrrec_endofrecord	       xdr_admin(3NSL)

       xdrrec_eof		       xdr_admin(3NSL)

       xdrrec_readbytes 	       xdr_admin(3NSL)

       xdrrec_skiprecord	       xdr_admin(3NSL)

       xdrstdio_create		       xdr_create(3NSL)

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       rpc(3NSL), xdr_admin(3NSL), xdr_complex(3NSL), xdr_create(3NSL), xdr_simple(3NSL), attributes(5)

SunOS 5.10							    30 Dec 1996 							 xdr(3NSL)