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.
RUSERPROC_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:
(Refer to the DESCRIPTION section.)

SEE ALSO
rusers(1), rusersd(8c)