.TH RU L "Apr 1989" local 
.UC
.SH NAME
ru \- compact lists of users on all "visible" systems
.SH SYNOPSIS
ru [-abcdmnrsuw] [-D domain] [-h host ... | -l user ...]
.SH DESCRIPTION
.I Ru
lists the login names of the users currently on all visible systems.
.SH Options
.IP -a
list all users, regardless of their login idle time (\fIrwho(1)\fP-inspired).
.IP -b
use the other byte-order (eg. rwho spool nfs-mounted from Sun to BSDi).
.IP -c
show a count for multiply-logged users.
.\"When combined with -s, include a count of hosts in each domain.
.IP -d
list hosts alphabetically, regardless of their sub-domains
.\"group hosts within their sub-domains
(forces -s option).
.IP -m
show multiple logins (overrides -c option).
.\"squeeze (ignore) multiple logins.
.IP -n
sort logins numerically instead of alphabetically.
.IP -r
produce \fIrwho(1)\fP-style output (forces -s option).
.IP -s
list users host-by-host instead of domain-by-domain.
.\"list users domain-by-domain instead of host-by-host.
.IP -u
display uptimes (see \fIruptime(1)\fP) (forces -s option).
Uptimes shown with a '*' inidcates that the information given is over
5 minutes old (the default rwho update period). A system is assumed
to be down only if the rwho update is over 1 hour overdue.
.IP -w
break lines before they wrap around the screen.
.\"allow lines to wrap around (ie. single line per heading).
.IP "-D domain"
list only users logged on hosts in the given domain.
.IP "-S spool"
use a different rwho spool directory
(default spool is /var/spool/rwho).
.IP "-p period"
use a different update period
(default period is 300 secs).
.IP "-i idle"
change idle cut-off to <idle> minutes (default cut-off is 1 hour).
.IP "-h host ..."
list only users logged on to the specified host(s).
.IP "-l user ..."
list only hosts with the given user(s) (forces -s option).
.PP
The -h and -l options are mutually exclusive since they
both use the remaining arguments as a search list.
Either option should be followed by at least one name.
.PP
Any system for which data can be found in the
.I rwhod(8c)
spooling directory is considered to be a "visible system".
.SH FILES
/var/spool/rwho/whod.*
.SH SEE ALSO
users(1), rwho(1C), rwhod(8C), ruptime(1C)
.SH HISTORY
Originally created by splicing pieces of
.I rwho(1)
source into
.I users(1)
source.
Rewritten to try to clean up the hacked code
and to make it easier to add (or delete) options.
.PP
Bug fixes, help and enhancements provided by
 nispa at hutcs.hut.fi <Tapani Lindgren>,
 kusalik at damask.uucp,
 pkh%cs.nott.ac.uk at nss.cs.ucl.ac.uk <Kevin Hopkins>,
 lamy at ai.toronto.edu <Jean-Francois Lamy>,
 moraes at ai.toronto.edu <Mark Moraes>,
 utashiro%sra.junet at kddlabs.uunet.uu.net <Kazumasa Utashiro>
.SH BUGS
With the -h option,
.I ru
doesn't care if a host's spool file hasn't
been updated within the last 5 minutes.
.sp
This might be considered a good example of option overkill.
.SH CONTACT
pkern at utgpu.uucp, pkern at gpu.utcs.toronto.edu or pkern at gpu.utcs.utoronto.ca