RNUSERS(3R)							   RNUSERS(3R)

NAME    [Toc]    [Back]

     rnusers, rusers - return information about	users on remote	machines

SYNOPSIS    [Toc]    [Back]

     #include <rpcsvc/rusers.h>

     rnusers(char *host);

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

DESCRIPTION    [Toc]    [Back]

     Rnusers returns the number	of users logged	on to host (-1 if it cannot
     determine that number).  Rusers fills the utmpidlearr structure with data
     about host, and returns 0 if successful.  The relevant structures are:

     struct utmparr {		   /* RUSERSVERS_ORIG */
	  struct utmp **uta_arr;
	  int uta_cnt
     };

     struct utmpidle {
	  struct utmp ui_utmp;
	  unsigned ui_idle;
     };
     struct utmpidlearr	{	   /* RUSERSVERS_IDLE */
	  struct utmpidle **uia_arr;
	  int uia_cnt
     };

RPC INFO    [Toc]    [Back]

     program number:
	  RUSERSPROG

     xdr routines:
	  int xdr_utmp(XDR *xdrs, struct utmp *up);
	  int xdr_utmpidle(XDR *xdrs, struct utmpidle *ui);
	  int xdr_utmpptr(XDR *xdrs, struct utmp **up);
	  int xdr_utmpidleptr(XDR *xdrs, struct	utmpidle **up);
	  int xdr_utmparr(XDR *xdrs, struct utmparr *up);
	  int xdr_utmpidlearr(XDR *xdrs, struct	utmpidlearr *up);
     procs:
	  RUSERSPROC_NUM
	    No arguments, returns number of users as an	unsigned long.
	  RUSERSPROC_NAMES
	    No arguments, returns utmparr or
	    utmpidlearr, depending on version number.
	  RUSERSPROC_ALLNAMES
	    No arguments, returns utmparr or
	    utmpidlearr, depending on version number.
	    Returns listing even for utmp entries satisfying nonuser() in utmp.h.
     versions:
	  RUSERSVERS_ORIG



									Page 1






RNUSERS(3R)							   RNUSERS(3R)



	 RUSERSVERS_IDLE

NOTE    [Toc]    [Back]

     To	compile	and link a program that	calls these routines, follow the
     procedures	for section (3R) routines as described in intro	(3).


									PPPPaaaaggggeeee 2222