Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rnusers(3rpc) [sunos man page]

rusers(3RPC)						       RPC Library Functions						      rusers(3RPC)

NAME
rusers, rnusers - return information about users on remote machines SYNOPSIS
cc [ flag ... ] file ... -lrpcsvc [ library ... ] #include <rpc/rpc.h> #include <rpcsvc/rusers.h> enum clnt_stat rusers(char *host, struct utmpidlearr *up); int rnusers(char *host); PROTOCOL
/usr/include/rpcsvc/rusers.x DESCRIPTION
These routines require that the rpc.rusersd(1M) daemon be configured and available on the remote system indicated by host. The rusers() protocol is used to retrieve information about users logged in on the remote system. rusers() fills the utmpidlearr structure with data about host, and returns 0 if successful. up must point to an allocated utmpidlearr structure. If rusers() returns successful it will have allocated data structures within the up structure, which should be freed with xdr_free(3NSL) when you no longer need them: xdr_free(xdr_utimpidlearr, up); On error, the returned value can be interpreted as an enum clnt_stat and can be displayed with clnt_perror(3NSL) or clnt_sperrno(3NSL). See the header <rpcsvc/rusers.h> for a definition of struct utmpidlearr. rnusers() returns the number of users logged on to host (-1 if it cannot determine that number). The following XDR routines are available in librpcsvc: xdr_utmpidlearr ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
rusers(1), rpc.rusersd(1M), rpc_clnt_calls(3NSL), xdr_free(3NSL), attributes(5) SunOS 5.10 30 Dec 1996 rusers(3RPC)

Check Out this Related Man Page

rnusers(3N)															       rnusers(3N)

NAME
rnusers(), rusers() - return information about users on remote machines SYNOPSIS
DESCRIPTION
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. fills in the structure with data about host and returns 0 if successful. The field is limited to eight characters on Berkeley systems, so the HP-UX XDR routine truncates from 12 characters to 8. The macro does not exist in the HP-UX 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: 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: No arguments, returns number of users as an No arguments, returns or depending on version number. No arguments, returns or depending on version number. Returns listing even for entries satisfying in Versions: WARNINGS
User applications that call this routine must be linked with For example, AUTHOR
was developed by Sun Microsystems, Inc. SEE ALSO
rusers(1). rnusers(3N)
Man Page