.\" $Id: uwatch.1,v 1.2 2002/06/13 22:49:27 howardjp Exp $
.\"
.\" Copyright (c) 1999
.\"      Arbornet, Inc.  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. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"      This product includes software developed by Arbornet, Inc., and
.\"      its contributors.
.\" 4. Neither the name of Arbornet, Inc. 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 ARBORNET, INC. 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 ARBORNET, INC. 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.
.\"
.\" Manual page for uwatch(1).  Formatted for BSD.  Dear I hope this
.\" works.
.Dd May 6, 1997
.Dt UWATCH 1 URM
.Sh NAME
.Nm uwatch
.Nd notifies users of user login and logouts
.Sh SYNOPSIS
.Nm uwatch
.Op Fl f Ar file
.Op Fl lprqtw
.Op Ar login
.Op Ar ...
.Sh DESCRIPTION
The 
.Nm uwatch
utility notifies the user of user login and logouts.  When 
.Nm uwatch
is started, it gives a list of all people logged in.  Afterwards, it
remains resident and informs of subsequent logins and logouts.
.Pp
Options supported by
.Nm uwatch :
.Bl -tag -width 8n
.It Fl f Ar file
Use 
.Ar file
as the uwatch response file.
.It Fl l
List full email address on notification.
.It Fl p
List tty on notification.
.It Fl q
Run in ``quick'' mode.  List only logins and terminate.
.It Fl r
Use the uwatch response file.  Defaults to 
.Ar ~/.uwatchrc .
.It Fl t
List time on notification.
.It Fl w
List calling host on notification.
.\" .It Ar login
.\" Watch this/these user names only.
.Sh RESPONSE FILE
The 
.Nm uwatch
response file is a file with one user name per line.  
.Sh SEE ALSO
.Xr finger 1 ,
.Xr last 1 ,
.Xr users 1 ,
.Xr w 1 ,
.Xr who 1 ,
.Xr utmp 5 ,
.Sh HISTORY
This program first appeared on a BBS called M-Net (m-net.arbornet.org).  It
was originally written for SYSIII then updated for BSD/OS.  This current
version has been entirely rewritten and ported to FreeBSD.
.Sh BUGS
Lots of them, it likes to walk over its own memory.  But other than that,
it seems to run correctly... :)