1.\" $OpenBSD: rusers.1,v 1.17 2016/03/17 07:18:34 jmc Exp $ 2.\" 3.\" Copyright (c) 1983, 1990 The Regents of the University of California. 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. Neither the name of the University nor the names of its contributors 15.\" may be used to endorse or promote products derived from this software 16.\" without specific prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" 30.\" from: @(#)rusers.1 6.7 (Berkeley) 4/23/91 31.\" 32.Dd $Mdocdate: March 17 2016 $ 33.Dt RUSERS 1 34.Os 35.Sh NAME 36.Nm rusers 37.Nd who is logged in to machines on local network 38.Sh SYNOPSIS 39.Nm rusers 40.Op Fl al 41.Op Fl h | Fl i | Fl u 42.Op Ar hosts ... 43.Sh DESCRIPTION 44The 45.Nm 46command produces output similar to 47.Xr who 1 , 48but for the list of hosts or all machines on the local network. 49For each host responding to the rusers query, 50the hostname with the names of the users currently logged 51on is printed on each line. 52The 53.Nm 54command will wait for 30 seconds to catch late responders. 55.Pp 56The options are as follows: 57.Bl -tag -width Ds 58.It Fl a 59Print all machines responding even if no one is currently logged in. 60.It Fl h 61Sort alphabetically by hostname. 62.It Fl i 63Sort by idle time in ascending order. 64Unlike other implementations, when the 65.Fl i 66and 67.Fl l 68flags are mixed the output is sorted by the idle time of each individual user. 69If the 70.Fl l 71flag is not specified, the idle time for a machine is considered to be 72the lowest idle time of a user on that host. 73.It Fl l 74Print a long format listing. 75This includes the user name, host name, 76tty that the user is logged in to, the date and time the user 77logged in, the amount of time since the user typed on the keyboard, 78and the remote host they logged in from (if applicable). 79.It Fl u 80Sort by number of users logged in. 81.El 82.Sh ENVIRONMENT 83.Bl -tag -width COLUMNS 84.It Ev COLUMNS 85If set to a positive integer, 86output is formatted to the given width in columns. 87Otherwise, 88.Nm 89defaults to the terminal width, or 80 columns if the output is not a terminal. 90.El 91.Sh DIAGNOSTICS 92.Bl -tag -width indent 93.It rusers: RPC: Program not registered 94The 95.Xr rpc.rusersd 8 96daemon has not been started on the remote host. 97.It rusers: RPC: Timed out 98A communication error occurred. 99Either the network is excessively congested, or the 100.Xr rpc.rusersd 8 101daemon has terminated on the remote host. 102.It rusers: RPC: Port mapper failure - RPC: Timed out 103The remote host is not running the portmapper (see 104.Xr portmap 8 ) , 105and cannot accommodate any RPC-based services. 106The host may be down. 107.El 108.Sh SEE ALSO 109.Xr users 1 , 110.Xr who 1 , 111.Xr portmap 8 , 112.Xr rpc.rusersd 8 113.Sh HISTORY 114The 115.Nm 116command appeared in 117.Tn SunOS . 118