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 ALSO

rusers(1C)

7th Edition  —  10 August 1985