NetBSD/usr.bin/rwho/rwho.1

.\"	$NetBSD: rwho.1,v 1.13 2005/10/01 00:03:47 wiz Exp $
.\"
.\" Copyright (c) 1983, 1990, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     from: @(#)rwho.1	8.1 (Berkeley) 6/6/93
.\"	$NetBSD: rwho.1,v 1.13 2005/10/01 00:03:47 wiz Exp $
.\"
.Dd September 30, 2005
.Dt RWHO 1
.Os
.Sh NAME
.Nm rwho
.Nd who is logged in on local machines
.Sh SYNOPSIS
.Nm
.Op Fl aHq
.Sh DESCRIPTION
The
.Nm
command produces output similar to
.Xr who 1 ,
but for all machines on the local network.
If no report has been
received from a machine for 11 minutes then
.Nm
assumes the machine is down, and does not report the users last known
to be logged into that machine.
.Pp
If a user hasn't typed to the system for a minute or more, then
.Nm
reports this idle time.
.Bl -tag -width Fl
.It Fl a
Include all users.
By default, if a user hasn't typed to the system for an hour or
more, then the user will be omitted from the output.
.It Fl H
Write column headings above the regular output.
.It Fl q
.Dq Quick mode :
List only the names and the number of users currently logged on.
When this option is used, all other options are ignored.
.El
.Sh FILES
.Bl -tag -width /var/rwho/whod.* -compact
.It Pa /var/rwho/whod.*
information about other machines
.El
.Sh SEE ALSO
.Xr finger 1 ,
.Xr rup 1 ,
.Xr ruptime 1 ,
.Xr rusers 1 ,
.Xr who 1 ,
.Xr rwhod 8
.Sh HISTORY
The
.Nm
command
appeared in
.Bx 4.3 .
.Sh BUGS
This is unwieldy when the number of machines
on the local net is large.
Sort option descriptions. Use more macros. New sentence, new line. Add missing .El. 2005-10-01 04:03:47 +04:00			`.\" $NetBSD: rwho.1,v 1.13 2005/10/01 00:03:47 wiz Exp $`
Sync to 4.4BSD-Lite2 1997-01-09 18:33:42 +03:00			`.\"`
			`.\" Copyright (c) 1983, 1990, 1993`
			`.\" The Regents of the University of California. All rights reserved.`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.\"`
			`.\" Redistribution and use in source and binary forms, with or without`
			`.\" modification, are permitted provided that the following conditions`
			`.\" are met:`
			`.\" 1. Redistributions of source code must retain the above copyright`
			`.\" notice, this list of conditions and the following disclaimer.`
			`.\" 2. Redistributions in binary form must reproduce the above copyright`
			`.\" notice, this list of conditions and the following disclaimer in the`
			`.\" documentation and/or other materials provided with the distribution.`
Move UCB-licensed code from 4-clause to 3-clause licence. Patches provided by Joel Baker in PR 22365, verified by myself. 2003-08-07 15:13:06 +04:00			`.\" 3. Neither the name of the University nor the names of its contributors`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.\" may be used to endorse or promote products derived from this software`
			`.\" without specific prior written permission.`
			`.\"`
			.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
			`.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE`
			`.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE`
			`.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE`
			`.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL`
			`.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS`
			`.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)`
			`.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT`
			`.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY`
			`.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF`
			`.\" SUCH DAMAGE.`
			`.\"`
Sync to 4.4BSD-Lite2 1997-01-09 18:33:42 +03:00			`.\" from: @(#)rwho.1 8.1 (Berkeley) 6/6/93`
Sort option descriptions. Use more macros. New sentence, new line. Add missing .El. 2005-10-01 04:03:47 +04:00			`.\" $NetBSD: rwho.1,v 1.13 2005/10/01 00:03:47 wiz Exp $`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.\"`
Patches from Liam Foy to: - Use realloc instead of allocating 1000 structures. - Remove NUSERS nonsense. If this is kept, shouldn't who(1) comply with it too? - Be consistent with who(1). Add two identical options from who(1). These are -q and -H. - General Cleans: - Move globals into local scope - Re-write a macro to remove an uneccessary variable. - Use UT_NAMESIZE. - Remove unecessary header etc. And from me, KNF, pass lint. 2005-09-30 21:58:24 +04:00			`.Dd September 30, 2005`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.Dt RWHO 1`
More and more .Os cleanups. .Os is defined in the tmac.doc-common file, so we shouldn't override it with versions in the manpages. Many more to come. 1999-03-22 21:16:34 +03:00			`.Os`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.Sh NAME`
			`.Nm rwho`
			`.Nd who is logged in on local machines`
			`.Sh SYNOPSIS`
WARNSify, fix .Nm usage 1997-10-19 18:34:08 +04:00			`.Nm`
Patches from Liam Foy to: - Use realloc instead of allocating 1000 structures. - Remove NUSERS nonsense. If this is kept, shouldn't who(1) comply with it too? - Be consistent with who(1). Add two identical options from who(1). These are -q and -H. - General Cleans: - Move globals into local scope - Re-write a macro to remove an uneccessary variable. - Use UT_NAMESIZE. - Remove unecessary header etc. And from me, KNF, pass lint. 2005-09-30 21:58:24 +04:00			`.Op Fl aHq`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.Sh DESCRIPTION`
			`The`
WARNSify, fix .Nm usage 1997-10-19 18:34:08 +04:00			`.Nm`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`command produces output similar to`
add section to xref. 2001-04-04 13:44:08 +04:00			`.Xr who 1 ,`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`but for all machines on the local network.`
			`If no report has been`
Add "SEE ALSO" cross references. rwho was changed so a host is considered "down" if it hasn't sent a response in 11 minutes (it used to be 5) but the manpage was never updated. 1993-09-16 05:50:33 +04:00			`received from a machine for 11 minutes then`
WARNSify, fix .Nm usage 1997-10-19 18:34:08 +04:00			`.Nm`
Patches from Liam Foy to: - Use realloc instead of allocating 1000 structures. - Remove NUSERS nonsense. If this is kept, shouldn't who(1) comply with it too? - Be consistent with who(1). Add two identical options from who(1). These are -q and -H. - General Cleans: - Move globals into local scope - Re-write a macro to remove an uneccessary variable. - Use UT_NAMESIZE. - Remove unecessary header etc. And from me, KNF, pass lint. 2005-09-30 21:58:24 +04:00			`assumes the machine is down, and does not report the users last known`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`to be logged into that machine.`
			`.Pp`
Patches from Liam Foy to: - Use realloc instead of allocating 1000 structures. - Remove NUSERS nonsense. If this is kept, shouldn't who(1) comply with it too? - Be consistent with who(1). Add two identical options from who(1). These are -q and -H. - General Cleans: - Move globals into local scope - Re-write a macro to remove an uneccessary variable. - Use UT_NAMESIZE. - Remove unecessary header etc. And from me, KNF, pass lint. 2005-09-30 21:58:24 +04:00			`If a user hasn't typed to the system for a minute or more, then`
WARNSify, fix .Nm usage 1997-10-19 18:34:08 +04:00			`.Nm`
New sentence, new line. 2002-09-30 15:08:56 +04:00			`reports this idle time.`
Patches from Liam Foy to: - Use realloc instead of allocating 1000 structures. - Remove NUSERS nonsense. If this is kept, shouldn't who(1) comply with it too? - Be consistent with who(1). Add two identical options from who(1). These are -q and -H. - General Cleans: - Move globals into local scope - Re-write a macro to remove an uneccessary variable. - Use UT_NAMESIZE. - Remove unecessary header etc. And from me, KNF, pass lint. 2005-09-30 21:58:24 +04:00			`.Bl -tag -width Fl`
Sort option descriptions. Use more macros. New sentence, new line. Add missing .El. 2005-10-01 04:03:47 +04:00			`.It Fl a`
			`Include all users.`
			`By default, if a user hasn't typed to the system for an hour or`
			`more, then the user will be omitted from the output.`
Patches from Liam Foy to: - Use realloc instead of allocating 1000 structures. - Remove NUSERS nonsense. If this is kept, shouldn't who(1) comply with it too? - Be consistent with who(1). Add two identical options from who(1). These are -q and -H. - General Cleans: - Move globals into local scope - Re-write a macro to remove an uneccessary variable. - Use UT_NAMESIZE. - Remove unecessary header etc. And from me, KNF, pass lint. 2005-09-30 21:58:24 +04:00			`.It Fl H`
			`Write column headings above the regular output.`
Sort option descriptions. Use more macros. New sentence, new line. Add missing .El. 2005-10-01 04:03:47 +04:00			`.It Fl q`
			`.Dq Quick mode :`
			`List only the names and the number of users currently logged on.`
			`When this option is used, all other options are ignored.`
			`.El`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.Sh FILES`
According to rwhod(8), file names are actually /var/rwho/whod.* 2005-09-12 22:35:32 +04:00			`.Bl -tag -width /var/rwho/whod.* -compact`
			`.It Pa /var/rwho/whod.*`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`information about other machines`
			`.El`
			`.Sh SEE ALSO`
Add "SEE ALSO" cross references. rwho was changed so a host is considered "down" if it hasn't sent a response in 11 minutes (it used to be 5) but the manpage was never updated. 1993-09-16 05:50:33 +04:00			`.Xr finger 1 ,`
			`.Xr rup 1 ,`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.Xr ruptime 1 ,`
Add "SEE ALSO" cross references. rwho was changed so a host is considered "down" if it hasn't sent a response in 11 minutes (it used to be 5) but the manpage was never updated. 1993-09-16 05:50:33 +04:00			`.Xr rusers 1 ,`
			`.Xr who 1 ,`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`.Xr rwhod 8`
			`.Sh HISTORY`
			`The`
WARNSify, fix .Nm usage 1997-10-19 18:34:08 +04:00			`.Nm`
after 0.2.2 "stable" patches applied 1993-03-21 21:04:42 +03:00			`command`
			`appeared in`
			`.Bx 4.3 .`
			`.Sh BUGS`
			`This is unwieldy when the number of machines`
			`on the local net is large.`