RNUSERS(3R)             COMMAND REFERENCE             RNUSERS(3R)



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
     The command rnusers returns the number of users logged on to
     host and returns -1 if it cannot determine that number.  The
     rusers command fills the utmpidlearr structure with data
     about host, and returns 0 if successful.  The relevant
     structures are listed here.



          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;



Printed 5/12/88                                                 1

RNUSERS(3R)             COMMAND REFERENCE             RNUSERS(3R)



                    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 entries
                          satisfying nonuser() in utmp.h.
          versions:
               RUSERSVERS_ORIG
               RUSERSVERS_IDLE
          structures:


SEE ALSO
     rusers(1c).





























Printed 5/12/88                                                 2

%%index%%
na:336,124;
sy:460,1159;
de:1619,1550;3577,1067;
se:4644,138;
%%index%%000000000095