xref: /freebsd/usr.bin/rusers/rusers.1 (revision da1ff3cb8a9c6b67357d6019ce7a51509de643ba)
161ce166cSGeoff Rehmet.\" Copyright (c) 1983, 1990 The Regents of the University of California.
261ce166cSGeoff Rehmet.\" All rights reserved.
361ce166cSGeoff Rehmet.\"
461ce166cSGeoff Rehmet.\" Redistribution and use in source and binary forms, with or without
561ce166cSGeoff Rehmet.\" modification, are permitted provided that the following conditions
661ce166cSGeoff Rehmet.\" are met:
761ce166cSGeoff Rehmet.\" 1. Redistributions of source code must retain the above copyright
861ce166cSGeoff Rehmet.\"    notice, this list of conditions and the following disclaimer.
961ce166cSGeoff Rehmet.\" 2. Redistributions in binary form must reproduce the above copyright
1061ce166cSGeoff Rehmet.\"    notice, this list of conditions and the following disclaimer in the
1161ce166cSGeoff Rehmet.\"    documentation and/or other materials provided with the distribution.
1261ce166cSGeoff Rehmet.\" 3. All advertising materials mentioning features or use of this software
1361ce166cSGeoff Rehmet.\"    must display the following acknowledgement:
1461ce166cSGeoff Rehmet.\"	This product includes software developed by the University of
1561ce166cSGeoff Rehmet.\"	California, Berkeley and its contributors.
1661ce166cSGeoff Rehmet.\" 4. Neither the name of the University nor the names of its contributors
1761ce166cSGeoff Rehmet.\"    may be used to endorse or promote products derived from this software
1861ce166cSGeoff Rehmet.\"    without specific prior written permission.
1961ce166cSGeoff Rehmet.\"
2061ce166cSGeoff Rehmet.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2161ce166cSGeoff Rehmet.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2261ce166cSGeoff Rehmet.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2361ce166cSGeoff Rehmet.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2461ce166cSGeoff Rehmet.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2561ce166cSGeoff Rehmet.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2661ce166cSGeoff Rehmet.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2761ce166cSGeoff Rehmet.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2861ce166cSGeoff Rehmet.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2961ce166cSGeoff Rehmet.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3061ce166cSGeoff Rehmet.\" SUCH DAMAGE.
3161ce166cSGeoff Rehmet.\"
3261ce166cSGeoff Rehmet.\"     from: @(#)rusers.1	6.7 (Berkeley) 4/23/91
331130b656SJordan K. Hubbard.\"	$FreeBSD$
3461ce166cSGeoff Rehmet.\"
3561ce166cSGeoff Rehmet.Dd April 23, 1991
3661ce166cSGeoff Rehmet.Dt RUSERS 1
3761ce166cSGeoff Rehmet.Os BSD 4.2
3861ce166cSGeoff Rehmet.Sh NAME
3961ce166cSGeoff Rehmet.Nm rusers
4061ce166cSGeoff Rehmet.Nd who is logged in to machines on local network
4161ce166cSGeoff Rehmet.Sh SYNOPSIS
4261ce166cSGeoff Rehmet.Nm rusers
4361ce166cSGeoff Rehmet.Op Fl al
4461ce166cSGeoff Rehmet.Op Ar host ...
4561ce166cSGeoff Rehmet.Sh DESCRIPTION
4661ce166cSGeoff RehmetThe
4761ce166cSGeoff Rehmet.Nm rusers
4861ce166cSGeoff Rehmetcommand produces output similar to
4961ce166cSGeoff Rehmet.Xr who ,
5061ce166cSGeoff Rehmetbut for the list of hosts or all machines on the local
5161ce166cSGeoff Rehmetnetwork. For each host responding to the rusers query,
5261ce166cSGeoff Rehmetthe hostname with the names of the users currently logged
5361ce166cSGeoff Rehmeton is printed on each line. The rusers command will wait for
5461ce166cSGeoff Rehmetone minute to catch late responders.
5561ce166cSGeoff Rehmet.Pp
5661ce166cSGeoff RehmetThe following options are available:
5761ce166cSGeoff Rehmet.Bl -tag -width indent
5861ce166cSGeoff Rehmet.It Fl a
5961ce166cSGeoff RehmetPrint all machines responding even if no one is currently logged in.
6061ce166cSGeoff Rehmet.It Fl l
6161ce166cSGeoff RehmetPrint a long format listing. This includes the user name, host name,
6261ce166cSGeoff Rehmettty that the user is logged in to, the date and time the user
6361ce166cSGeoff Rehmetlogged in, the amount of time since the user typed on the keyboard,
6461ce166cSGeoff Rehmetand the remote host they logged in from (if applicable).
6561ce166cSGeoff Rehmet.El
6661ce166cSGeoff Rehmet.Sh DIAGNOSTICS
6761ce166cSGeoff Rehmet.Bl -tag -width indent
6861ce166cSGeoff Rehmet.It rusers: RPC: Program not registered
6961ce166cSGeoff RehmetThe
7061ce166cSGeoff Rehmet.Xr rpc.rusersd 8
7161ce166cSGeoff Rehmetdaemon has not been started on the remote host.
7261ce166cSGeoff Rehmet.It rusers: RPC: Timed out
7361ce166cSGeoff RehmetA communication error occurred.  Either the network is
7461ce166cSGeoff Rehmetexcessively congested, or the
7561ce166cSGeoff Rehmet.Xr rpc.rusersd 8
7661ce166cSGeoff Rehmetdaemon has terminated on the remote host.
7761ce166cSGeoff Rehmet.It rusers: RPC: Port mapper failure - RPC: Timed out
7861ce166cSGeoff RehmetThe remote host is not running the portmapper (see
7961ce166cSGeoff Rehmet.Xr portmap 8 ),
804a8d0283SMike Pritchardand cannot accommodate any RPC-based services.  The host may be down.
8161ce166cSGeoff Rehmet.El
8261ce166cSGeoff Rehmet.Sh SEE ALSO
8361ce166cSGeoff Rehmet.Xr who 1 ,
84da1ff3cbSWolfram Schneider.Xr portmap 8 ,
8561ce166cSGeoff Rehmet.Xr rpc.rusersd 8
8661ce166cSGeoff Rehmet.Sh HISTORY
8761ce166cSGeoff RehmetThe
8861ce166cSGeoff Rehmet.Nm rusers
8961ce166cSGeoff Rehmetcommand
9061ce166cSGeoff Rehmetappeared in
9161ce166cSGeoff Rehmet.Em Sun-OS .
9261ce166cSGeoff Rehmet.Sh BUGS
9361ce166cSGeoff RehmetThe sorting options are not implemented.
94