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
 

FILES

/usr/lib/librpcsvc.aRPC services library
/usr/lib/libsun.aRPC protocol library

NOTE

To compile and link a program that calls any of these routines, use a compile command of the form:

cc −I/usr/include/sun −I/usr/include/bsd prog.c −lrpcsvc −lsun −lbsd

Version 3.6  —  December 20, 1987