RNUSERS(3R)RNUSERS(3R)NAME
rnusers, rusers - return information about users on remote machines
SYNOPSIS
#include <rpcsvc/rusers.h>
rnusers(host)
char *host
rusers(host, up)
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(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:
SEE ALSOrusers(1C)
10 August 1985 RNUSERS(3R)