utility displays information about local and remote system users.
By default, the following information is displayed about each user
currently logged-in to the local host:
user's full name
associated terminal name
Idle time is in minutes if it is a single integer, hours and minutes
is present, or days if a
Login time is displayed as the day name if less than six days,
else month, day, hours and minutes, unless
more than six months ago, in which case the year is displayed rather
than the hours and minutes.
The names of terminals for which write permission is denied (see
are prepended with an asterisk
Unknown devices as well as nonexistent idle and login times are
displayed as single asterisks.
The options are as follows:
option is also specified, the name of the remote host is displayed instead of
the office location and office phone.
Produces a multi-line format displaying all of the information available from
option as well as the user's home directory, home phone number, login
shell, mail status, and the contents of the
files from the user's home directory.
If idle time is at least a minute and less than a day, it is
presented in the form
Idle times greater than a day are presented as
Phone numbers specified as eleven digits are printed as
Numbers specified as ten or seven digits are printed as the appropriate
subset of that string.
Numbers specified as five digits are printed as
Numbers specified as four digits are printed as
If write permission is denied to the device, the phrase
is appended to the line containing the device name.
One entry per user is displayed with the
option; if a user is logged on multiple times, terminal information
is repeated once per login.
Mail status is shown as
if there is no mail at all,
Mail last read DDD MMM ## HH:MM YYYY (TZ)
if the person has looked
at their mailbox since new mail arriving, or
New mail received...,
if they have new mail.
Enable matching of
This is disabled by default on systems running YP or with large
Prevent matching of
is usually a login name; however, matching will also be done on the
users' real names, unless the
option is supplied.
All name matching performed by
is case insensitive.
option is also specified, the office location and office phone is displayed
instead of the name of the remote host.
from displaying the contents of the
Short format (default).
The information as described above is displayed in a columnar fashion.
If no options are specified,
defaults to the
style output if operands are provided, otherwise to the
Note that some fields may be missing, in either format, if information
is not available for them.
may be used to look up users on a remote machine.
The format is to specify a
where the default output
format for the former is the
style, and the default output format for the latter is the
option is the only option that may be passed to a remote machine.