rusers(1) [opensolaris man page]

rusers(1)							   User Commands							 rusers(1)

NAME

       rusers - who is logged in on remote machines

SYNOPSIS

       rusers [-ahilu] host...

DESCRIPTION

       The rusers command produces output similar to who(1), but for remote machines. The listing is in the order that responses are received, but
       this order can be changed by specifying one of the options listed below.

       The default is to print out the names of the users logged in. When the -l flag is given, additional information is printed for each user:

	 userid hostname:terminal login_date login_time idle_time login_host

       If hostname and login host are the same value, the login_host field is not displayed. Likewise, if hostname is not idle, the  idle_time	is
       not displayed.

       A remote host will only respond if it is running the rusersd daemon, which may be started up from inetd(1M) or listen(1M).

       In the absence of a name service, such as LDAP or NIS, rusers displays host names as numeric IP addresses.

OPTIONS

       -a    Give a report for a machine even if no users are logged on.

       -h    Sort alphabetically by host name.

       -i    Sort by idle time.

       -l    Give a longer listing in the style of who(1).

       -u    Sort by number of users.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWrcmdc 		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       who(1), inetd(1M), listen(1M), pmadm(1M), sacadm(1M), attributes(5)

SunOS 5.11							    7 Mar 2003								 rusers(1)

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)