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:
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
WARNINGS
User applications that call this routine must be linked with
/usr/lib/librpcsvc.a.
For example,
AUTHOR
rnusers()
was developed by Sun Microsystems, Inc.