rnusers.3n (2010 09)

r
rnusers(3N) rnusers(3N)
NAME
rnusers(), rusers() - return information about users on remote machines
SYNOPSIS
#include <utmp.h>
#include <rpcsvc/rusers.h>
int rnusers(char *host);
int rusers(char *host, struct utmpidlearr *up);
DESCRIPTION
rnusers() returns the number of users logged in on host or − 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.
rusers() fills in the utmpidlearr structure with data about host and returns 0 if successful.
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 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 Information
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;
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1