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

121 lines
2.5 KiB
Groff
Raw Normal View History

.\"
1999-08-28 01:35:59 +00:00
.\" $FreeBSD$
.\"
.Dd November 24, 2001
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
.Op Fl cinotW
.Op Fl f Ar snpdev
1999-10-30 14:52:24 +00:00
.Op Ar tty
1995-02-17 16:40:32 +00:00
.Sh DESCRIPTION
2002-07-14 14:47:15 +00:00
The
.Nm
utility allows the user to examine all data coming through a specified tty
using the
.Xr snp 4
device.
If the
.Xr snp 4
device is not available,
.Nm
will attempt to load the module
.Pq Nm snp .
2002-07-14 14:47:15 +00:00
The
.Nm
utility writes to standard output.
.Pp
The options are as follows:
1997-10-27 12:21:10 +00:00
.Bl -tag -width indent
.It Fl c
Reconnect on close.
If the tty observed by
1997-10-27 12:21:10 +00:00
.Nm
is closed, automatically reattach to the same tty.
If this option is not specified,
1997-10-27 12:21:10 +00:00
.Nm
will request a new tty if running in interactive mode or exit if running
without a controlling tty.
.It Fl f Ar snpdev
If this option is specified,
.Nm
will use
.Ar snpdev
as the
.Xr snp 4
device.
Without this option,
.Nm
will attempt to find the next available
.Xr snp 4
device.
.It Fl i
Force interactive mode.
Interactive mode is a default if
1997-10-27 12:21:10 +00:00
.Nm
is started from a tty.
If output is redirected to a file, interactive mode can still be requested
by specifying this option.
.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,
.Nm
will exit.
The reconnect flags are unaffected by
this option.
When this flag is used, <control-X> is passed through to the terminal.
.It Fl o
Reconnect on overflow.
The behavior of
1997-10-27 12:21:10 +00:00
.Nm
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
Tty may be specified as a tty-style device, such as a pseudo tty device,
1995-02-25 20:14:31 +00:00
a virtual console, or a serial line, etc.
2000-01-23 20:27:32 +00:00
Names may be preceded by
.Pa /dev/ .
.El
.Sh OPERATION
While running in interactive mode, all user input is discarded except for:
.Pp
.Bl -tag -width "XXXX" -compact
.It Sy "<control-G>"
Exit
.Nm .
.It Sy "<control-W>"
Clear screen.
.It Sy "<control-X>"
Change attached tty, unless this feature is disabled, in which case
control-X is passed to the terminal as with other control characters.
2000-01-23 20:27:32 +00:00
.El
1995-02-17 16:40:32 +00:00
.Sh SEE ALSO
.Xr pty 4 ,
1997-01-20 00:03:00 +00:00
.Xr sio 4 ,
.Xr snp 4 ,
.Xr kldload 8
1995-02-17 16:40:32 +00:00
.Sh BUGS
No terminal emulation is performed.
All user output is reproduced as-is.
.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
2002-07-14 14:47:15 +00:00
The
.Nm
utility first appeared in
1996-08-23 00:57:08 +00:00
.Fx 2.1 .