1995-02-22 23:47:51 +00:00
|
|
|
.\"
|
|
|
|
|
.\" @(#)watch.8 1.1 (FreeBSD) 2/17/95
|
1999-08-28 01:35:59 +00:00
|
|
|
.\" $FreeBSD$
|
1995-02-22 23:47:51 +00:00
|
|
|
.\"
|
|
|
|
|
.Dd February 17, 1995
|
1995-02-17 16:40:32 +00:00
|
|
|
.Dt WATCH 8
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
1995-02-22 23:47:51 +00:00
|
|
|
.Nm watch
|
|
|
|
|
.Nd snoop on another tty line
|
1996-01-30 13:52:50 +00:00
|
|
|
.Sh SYNOPSIS
|
1995-02-22 23:47:51 +00:00
|
|
|
.Nm watch
|
1996-12-02 16:21:20 +00:00
|
|
|
.Op Fl ciotnW
|
1999-10-30 14:52:24 +00:00
|
|
|
.Op Ar tty
|
1996-12-02 12:32:46 +00:00
|
|
|
.\" watch [-ciotnW] [<tty name>]
|
1995-02-17 16:40:32 +00:00
|
|
|
.Sh DESCRIPTION
|
1995-02-22 23:47:51 +00:00
|
|
|
.Nm Watch
|
|
|
|
|
allows the superuser to examine all data coming through a specified tty.
|
|
|
|
|
.Nm Watch
|
|
|
|
|
writes to standard output.
|
|
|
|
|
.Pp
|
|
|
|
|
The options are as follows:
|
1997-10-27 12:21:10 +00:00
|
|
|
.Bl -tag -width indent
|
1995-02-22 23:47:51 +00:00
|
|
|
.It Fl c
|
|
|
|
|
Reconnect on close. If the tty observed by
|
1997-10-27 12:21:10 +00:00
|
|
|
.Nm
|
1995-02-22 23:47:51 +00:00
|
|
|
is closed, automatically reattach to the same tty.
|
|
|
|
|
If this option is not specified,
|
1997-10-27 12:21:10 +00:00
|
|
|
.Nm
|
1995-02-22 23:47:51 +00:00
|
|
|
will request a new tty if running in interactive mode or exit if running
|
|
|
|
|
without a controlling tty.
|
|
|
|
|
.It Fl i
|
|
|
|
|
Force interactive mode.
|
|
|
|
|
Interactive mode is a default if
|
1997-10-27 12:21:10 +00:00
|
|
|
.Nm
|
1995-02-22 23:47:51 +00:00
|
|
|
is started from a tty.
|
|
|
|
|
If output is redirected to a file, interactive mode can still be requested
|
|
|
|
|
by specifying this option.
|
|
|
|
|
.It Fl o
|
|
|
|
|
Reconnect on overflow.
|
1996-01-30 13:52:50 +00:00
|
|
|
The behavior of
|
1997-10-27 12:21:10 +00:00
|
|
|
.Nm
|
1995-02-22 23:47:51 +00:00
|
|
|
if the observed tty overflows is similar to the behavior if the observed tty
|
|
|
|
|
is closed.
|
|
|
|
|
For more info see
|
|
|
|
|
.Xr snp 4 .
|
|
|
|
|
.It Fl t
|
|
|
|
|
Print the date and time when observation of a given tty is started.
|
1996-12-02 12:32:46 +00:00
|
|
|
.It Fl n
|
|
|
|
|
Disable the ability to switch the watched tty interactively. This disables
|
|
|
|
|
both change requests made with <control-X> as well as automatic prompting
|
|
|
|
|
when the current tty is closed or overflows. In all cases where a prompt
|
|
|
|
|
would be displayed, watch will exit. The reconnect flags are unaffected by
|
|
|
|
|
this option.
|
1995-02-27 19:48:19 +00:00
|
|
|
.It Fl W
|
|
|
|
|
Allow write access to observed tty.
|
1995-02-22 23:47:51 +00:00
|
|
|
.It Ar tty
|
1995-02-25 20:14:31 +00:00
|
|
|
Tty may be specified as an tty-style device, such as a pseudo tty device,
|
|
|
|
|
a virtual console, or a serial line, etc.
|
2000-01-23 20:27:32 +00:00
|
|
|
Names may be preceded by
|
|
|
|
|
.Pa /dev/ .
|
|
|
|
|
.El
|
1995-02-22 23:47:51 +00:00
|
|
|
.Sh OPERATION
|
|
|
|
|
While running in interactive mode, all user input is discarded except for:
|
|
|
|
|
.Pp
|
|
|
|
|
.Bl -tag -width "XXXX" -compact
|
1996-12-30 09:01:50 +00:00
|
|
|
.It Sy "<control-G>"
|
1995-02-22 23:47:51 +00:00
|
|
|
Exit
|
1997-10-27 12:21:10 +00:00
|
|
|
.Nm Ns .
|
1995-02-22 23:47:51 +00:00
|
|
|
.It Sy "<control-W>"
|
|
|
|
|
Clear screen.
|
|
|
|
|
.It Sy "<control-X>"
|
|
|
|
|
Change attached tty.
|
2000-01-23 20:27:32 +00:00
|
|
|
.El
|
1995-02-22 23:47:51 +00:00
|
|
|
.Sh RESTRICTIONS
|
|
|
|
|
Only the superuser can run
|
1997-10-27 12:21:10 +00:00
|
|
|
.Nm Ns .
|
1995-02-17 16:40:32 +00:00
|
|
|
.Sh SEE ALSO
|
1995-02-22 23:47:51 +00:00
|
|
|
.Xr pty 4 ,
|
1997-01-20 00:03:00 +00:00
|
|
|
.Xr sio 4 ,
|
|
|
|
|
.Xr snp 4
|
1995-02-17 16:40:32 +00:00
|
|
|
.Sh BUGS
|
1995-02-22 23:47:51 +00:00
|
|
|
No terminal emulation is performed.
|
|
|
|
|
All user output is reproduced as-is.
|
1998-03-23 08:31:20 +00:00
|
|
|
.Sh AUTHORS
|
1997-10-27 12:21:10 +00:00
|
|
|
.An Ugen J.S. Antsilevich Aq ugen@NetVision.net.il
|
1995-02-17 16:40:32 +00:00
|
|
|
.Sh HISTORY
|
1995-02-22 23:47:51 +00:00
|
|
|
.Nm Watch
|
1996-08-23 00:57:08 +00:00
|
|
|
first appeared in
|
|
|
|
|
.Fx 2.1 .
|
