4.3BSD-UWisc/man/cat3/rnusers.3r

RNUSERS(3R)         UNIX Programmer's Manual          RNUSERS(3R)



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

SYNOPSIS
     #include <rpcsvc/rusers.h>
9     rnusers(host)
          char *host
9     rusers(host, up)
          char *host
          struct utmpidlearr *up;

DESCRIPTION
     _R_n_u_s_e_r_s returns the number of users logged on to _h_o_s_t (-1 if
     it cannot determine that number).  _R_u_s_e_r_s fills the
     _u_t_m_p_i_d_l_e_a_r_r structure with data about _h_o_s_t, and returns 0 if
     successful.  The relevant structures are:

     struct utmparr {              /* RUSERSVERS_ORIG */
          struct utmp **uta_arr;
          int uta_cnt
     };
9     struct utmpidle {
          struct utmp ui_utmp;
          unsigned ui_idle;
     };
9     struct utmpidlearr {          /* RUSERSVERS_IDLE */
          struct utmpidle **uia_arr;
          int uia_cnt
     };

RPC INFO
     program number:
          RUSERSPROG
9     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;
               struct utmpidle **up;
          int xdr_utmparr(xdrs, up);
               XDR *xdrs;
               struct utmparr *up;



Printed 12/27/86         10 August 1985                         1


9


RNUSERS(3R)         UNIX Programmer's Manual          RNUSERS(3R)



          int xdr_utmpidlearr(xdrs, up);
               XDR *xdrs;
               struct utmpidlearr *up;
9     procs:
          RUSERSPROC_NUM
               No arguments, returns number of users as an _u_n_s_i_g_n_e_d _l_o_n_g.
          RUSERSPROC_NAMES
               No arguments, returns _u_t_m_p_a_r_r or _u_t_m_p_i_d_l_e_a_r_r, depending on version number.
          RUSERSPROC_ALLNAMES
               No arguments, returns _u_t_m_p_a_r_r or _u_t_m_p_i_d_l_e_a_r_r, depending on version number.
               Returns listing even for _u_t_m_p entries satisfying _n_o_n_u_s_e_r() in _u_t_m_p._h.
     versions:
          RUSERSVERS_ORIG
          RUSERSVERS_IDLE

     structures:

SEE ALSO
     rusers(1), rusersd(8c)
































9


Printed 12/27/86         10 August 1985                         2