Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > R

rnusers(3N)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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 Information

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

WARNINGS

User applications that call this routine must be linked with /usr/lib/librpcsvc.a. For example,

cc my_source.c -lrpcsvc

AUTHOR

rnusers() was developed by Sun Microsystems, Inc.

SEE ALSO

rusers(1).

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.