rnusers(3N)                                           rnusers(3N)



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

     SYNOPSIS
          #include <rpcsvc/rusers.h>

          rnusers(host)
          char *host;

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

     DESCRIPTION
          rnusers returns the number of users logged on to host (or -1
          if it cannot determine that number).  rusers fills the
          structure utmpidlearr 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(xdrs, up)
                XDR *xdrs;
                struct utmp *up;
             int xdr_utmpidle(xdrs, ui);
                XDR *xdrs;
                struct utmpidle *ui;
             int xdr_utmpptr(xdrs, up);
                XDR *xdrs;
                struct utmp **up;
             int xdr_utmpidleptr(xdrs, up);
                XDR *xdrs;



     April, 1990                                                     1

     rnusers(3N)                                           rnusers(3N)



                struct utmpidle **up;
             int xdr_utmparr(xdrs, up);
                XDR *xdrs;
                struct utmparr *up;
             int xdr_utmpidlearr(xdrs, up);
                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 en-
               tries satisfying nonuser() in utmp.h.

          Versions:
          RUSERSVERS_ORIG, RUSERSVERS_IDLE

     SEE ALSO
          rusers(1), rusersd(1M).



























     2                                                     April, 1990