HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
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 rou-
tine 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;
Section 3−−778 − 1 − HP-UX Release 11i: December 2000
___
___