Museum

RNUSERS(3R-BSD)     RISC/os Reference Manual      RNUSERS(3R-BSD)



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

SYNOPSIS
     For -systype svr3 and -systype bsd43:

     #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 (-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(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);



                        Printed 11/19/92                   Page 1

RNUSERS(3R-BSD)     RISC/os Reference Manual      RNUSERS(3R-BSD)



               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


ORIGIN
     Sun Microsystems Inc.

NOTE
     These routines are not resolved by libc.a.  See intro(3R)
     for more information.























 Page 2                 Printed 11/19/92