RNUSERS(3R)RNUSERS(3R)NAME
rnusers, rusers - return information about users on remote machines
SYNOPSIS
#include <rpcsvc/rusers.h>
rnusers(char *host);
rusers(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(XDR *xdrs, struct utmp *up);
int xdr_utmpidle(XDR *xdrs, struct utmpidle *ui);
int xdr_utmpptr(XDR *xdrs, struct utmp **up);
int xdr_utmpidleptr(XDR *xdrs, struct utmpidle **up);
int xdr_utmparr(XDR *xdrs, struct utmparr *up);
int xdr_utmpidlearr(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
Page 1
RNUSERS(3R)RNUSERS(3R)
RUSERSVERS_IDLE
NOTE
To compile and link a program that calls these routines, follow the
procedures for section (3R) routines as described in intro (3).
Page 2
