Museum

RNUSERS(3R)                                                        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



                                                                        Page 1

RNUSERS(3R)                                                        RNUSERS(3R)



         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).

















































                                                                        Page 2