rnusers(3N)

Requires Optional NFS Services Software

NAME

rnusers, rusers − return information about users on remote machines

SYNOPSIS

#include <utmp.h>
#include <rpcsvc/rusers.h>

int rnusers(char ∗host);

int rusers(char ∗host, struct utmpidlearr ∗up);

DESCRIPTION

rnusers returns the number of users logged in on host or −1 if it cannot determine that number. The host string is either the official name of the host or an alias for it. See hosts(4) for more information regarding host names.

rusers fills in the utmpidlearr structure with data about host and returns 0 if successful. The ut_line field is limited to eight characters on Berkeley systems, so the HP-UX XDR routine truncates from 12 characters to 8. The nonuser() macro does not exist in the HP-UX utmp.h file; therefore, HP-UX windows appear as separate users.

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:

EXTERNAL INFLUENCES

International Code Set Support

Single- and multi-byte character codes sets are supported.

AUTHOR

rnusers was developed by Sun Microsystems, Inc.

Museum

Related Articles