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