NAME

rnusers, rusers − return information about users on remote machines

SYNOPSIS

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

DESCRIPTION

The rnusers function returns the number of users logged on to host −1 if it cannot determine that number.  The host string is either the official name of the host or an alias for it.  See hosts(4) for more information regarding host names.
 
The rusers function fills in the utmpidlearr structure with data about host and returns 0 if successful.  Note, since the utmp structures are not identical between HP-UX and Sun (or Berkeley), some information is lost.  In particular, the ut_host field does not exist on HP-UX, so outbound utmp structures have nothing in this field.  The ut_line field is limited to eight characters on Berkeley systems, so the HP-UX XDR routine truncates from 12 characters to 8.  The nonuser() macro does not exist in the HP-UX utmp.h file; therefore, HP-UX windows will appear as separate users. 

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

AUTHOR

Sun Microsystems, Inc. 

SEE ALSO

rusers(1). 

INTERNATIONAL SUPPORT

8-bit data, 16-bit data, messages

Hewlett-Packard Company  —  May 11, 2021