rnusers(3R)

NAME
     rnusers, rusers - return information about users on remote machines

SYNOPSIS
     #include <rpcsvc/rusers.h>

     rnusers(char *host);

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

DESCRIPTION
     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
     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
         RUSERSVERS_IDLE


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