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;
intuta_cnt
};
struct utmpidle {
struct utmpui_utmp;
unsignedui_idle;
};
struct utmpidlearr {/∗ RUSERSVERS_IDLE ∗/
struct utmpidle∗∗uia_arr;
intuia_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)

4BSD