freebsd-dev/usr.sbin/watch/watch.8

81 lines
1.8 KiB
Groff
Raw Normal View History

.\"
.\" @(#)watch.8 1.1 (FreeBSD) 2/17/95
.\"
.Dd February 17, 1995
1995-02-17 16:40:32 +00:00
.Dt WATCH 8
.Os
.Sh NAME
.Nm watch
.Nd snoop on another tty line
.Sh SYNOPSIS
.Nm watch
1995-02-27 19:48:19 +00:00
.Op Fl ciotW
.Ar tty
1995-02-27 19:48:19 +00:00
.\" watch [-ciotW] [<tty name>]
1995-02-17 16:40:32 +00:00
.Sh DESCRIPTION
.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:
.Bl -tag -width "-l nul "
.It Fl c
Reconnect on close. If the tty observed by
.Nm watch
is closed, automatically reattach to the same tty.
If this option is not specified,
.Nm watch
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
.Nm watch
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.
The behavior of
.Nm watch
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.
1995-02-27 19:48:19 +00:00
.It Fl W
Allow write access to observed tty.
.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.
Names may be preceded by "/dev/".
.Sh OPERATION
While running in interactive mode, all user input is discarded except for:
.Pp
.Bl -tag -width "XXXX" -compact
.It Sy "<control-Q>"
Exit
.Nm watch .
.It Sy "<control-W>"
Clear screen.
.It Sy "<control-X>"
Change attached tty.
.Sh RESTRICTIONS
Only the superuser can run
.Nm watch .
1995-02-17 16:40:32 +00:00
.Sh SEE ALSO
1995-02-23 11:18:35 +00:00
.Xr snp 4 ,
.Xr pty 4 ,
.Xr sio 4 .
1995-02-17 16:40:32 +00:00
.Sh BUGS
No terminal emulation is performed.
All user output is reproduced as-is.
.Sh AUTHOR
Ugen J.S. Antsilevich <ugen@NetVision.net.il>
1995-02-17 16:40:32 +00:00
.Sh HISTORY
.Nm Watch
1996-08-23 00:57:08 +00:00
first appeared in
.Fx 2.1 .