Rewrite manual page to use mandoc correctly and fix english grammar.
This commit is contained in:
Paul Traina
parent
95344a43ed
commit
16ae87aed1
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=6645
@ -1,52 +1,77 @@
|
||||
.Dd Februar 17, 1995
|
||||
.\"
|
||||
.\" @(#)watch.8 1.1 (FreeBSD) 2/17/95
|
||||
.\"
|
||||
.Dd February 17, 1995
|
||||
.Dt WATCH 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
watch - tty snoop watching utility.
|
||||
|
||||
.Sh SYNOPSIS
|
||||
|
||||
watch [-ciot] [<tty name>]
|
||||
|
||||
.Nm watch
|
||||
.Nd snoop on another tty line
|
||||
.Sh SYNOPSYS
|
||||
.Nm watch
|
||||
.Op Fl ciot
|
||||
.Ar tty
|
||||
.\" watch [-ciot] [<tty name>]
|
||||
.Sh DESCRIPTION
|
||||
watch utility allows user to see all data coming to the tty,almost
|
||||
the same way as user on this tty.
|
||||
Only root can run watch.
|
||||
|
||||
The following options are available:
|
||||
|
||||
-c Reconnect on close. When tty on which watching was made closed,
|
||||
utility will automatically reattach itself to the same tty.
|
||||
By default utility will ask user to enter new tty name if running
|
||||
in interactive mode or exit while non-interactive.
|
||||
|
||||
-i Force interactive mode.Interactive mode is a default if utility
|
||||
started from tty. If output redirected to file, you can still force
|
||||
it into interactive mode by this option.
|
||||
|
||||
-o Reconnect on overflow. The behaviour of utility on overflow is same
|
||||
as for tty close. For more info see snp(4).
|
||||
|
||||
-t Timestamp.Print date and time each time, tty watching started.
|
||||
|
||||
The <tty name> is one of following types:
|
||||
ttyp?,ttyq?,ttyr? - pseudo tty devices.
|
||||
ttyv? - virtual ttys (syscons).
|
||||
tty0?,ttyd? - serial lines.
|
||||
Each name can be preceeded by "/dev/".
|
||||
Also recognized:
|
||||
pty[NUM] - pseudotty's.
|
||||
vty[NUM] - virtual ttys.
|
||||
sio[NUM] - serial lines.
|
||||
|
||||
While running interactive, all user input discarded except :
|
||||
Ctrl+C - Exit watch.
|
||||
Ctrl+X - Change attached tty.
|
||||
Ctrl+W - Clear screen.
|
||||
|
||||
.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 behaviour 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.
|
||||
.It Ar tty
|
||||
Tty may be specified as a remote pseudo tty device, a virtual console, or
|
||||
a serial line.
|
||||
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-C>"
|
||||
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 .
|
||||
.Sh SEE ALSO
|
||||
snp(4),pty(4),sio(4)
|
||||
.Xr snpl4 ,
|
||||
.Xr pty 4 ,
|
||||
.Xr sio 4 .
|
||||
.Sh BUGS
|
||||
No terminal emulation involved,all user output comes to the screen as-is.
|
||||
No terminal emulation is performed.
|
||||
All user output is reproduced as-is.
|
||||
.Sh AUTHOR
|
||||
Ugen J.S. Antsilevich <ugen@NetVision.net.il>
|
||||
.Sh HISTORY
|
||||
FreeBSD 2.1,By Ugen J.S.Antsilevich <ugen@NetVision.net.il>
|
||||
.Nm Watch
|
||||
first appeared in FreeBSD 2.1
|
||||
|
||||
@ -1,52 +1,77 @@
|
||||
.Dd Februar 17, 1995
|
||||
.\"
|
||||
.\" @(#)watch.8 1.1 (FreeBSD) 2/17/95
|
||||
.\"
|
||||
.Dd February 17, 1995
|
||||
.Dt WATCH 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
watch - tty snoop watching utility.
|
||||
|
||||
.Sh SYNOPSIS
|
||||
|
||||
watch [-ciot] [<tty name>]
|
||||
|
||||
.Nm watch
|
||||
.Nd snoop on another tty line
|
||||
.Sh SYNOPSYS
|
||||
.Nm watch
|
||||
.Op Fl ciot
|
||||
.Ar tty
|
||||
.\" watch [-ciot] [<tty name>]
|
||||
.Sh DESCRIPTION
|
||||
watch utility allows user to see all data coming to the tty,almost
|
||||
the same way as user on this tty.
|
||||
Only root can run watch.
|
||||
|
||||
The following options are available:
|
||||
|
||||
-c Reconnect on close. When tty on which watching was made closed,
|
||||
utility will automatically reattach itself to the same tty.
|
||||
By default utility will ask user to enter new tty name if running
|
||||
in interactive mode or exit while non-interactive.
|
||||
|
||||
-i Force interactive mode.Interactive mode is a default if utility
|
||||
started from tty. If output redirected to file, you can still force
|
||||
it into interactive mode by this option.
|
||||
|
||||
-o Reconnect on overflow. The behaviour of utility on overflow is same
|
||||
as for tty close. For more info see snp(4).
|
||||
|
||||
-t Timestamp.Print date and time each time, tty watching started.
|
||||
|
||||
The <tty name> is one of following types:
|
||||
ttyp?,ttyq?,ttyr? - pseudo tty devices.
|
||||
ttyv? - virtual ttys (syscons).
|
||||
tty0?,ttyd? - serial lines.
|
||||
Each name can be preceeded by "/dev/".
|
||||
Also recognized:
|
||||
pty[NUM] - pseudotty's.
|
||||
vty[NUM] - virtual ttys.
|
||||
sio[NUM] - serial lines.
|
||||
|
||||
While running interactive, all user input discarded except :
|
||||
Ctrl+C - Exit watch.
|
||||
Ctrl+X - Change attached tty.
|
||||
Ctrl+W - Clear screen.
|
||||
|
||||
.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 behaviour 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.
|
||||
.It Ar tty
|
||||
Tty may be specified as a remote pseudo tty device, a virtual console, or
|
||||
a serial line.
|
||||
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-C>"
|
||||
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 .
|
||||
.Sh SEE ALSO
|
||||
snp(4),pty(4),sio(4)
|
||||
.Xr snpl4 ,
|
||||
.Xr pty 4 ,
|
||||
.Xr sio 4 .
|
||||
.Sh BUGS
|
||||
No terminal emulation involved,all user output comes to the screen as-is.
|
||||
No terminal emulation is performed.
|
||||
All user output is reproduced as-is.
|
||||
.Sh AUTHOR
|
||||
Ugen J.S. Antsilevich <ugen@NetVision.net.il>
|
||||
.Sh HISTORY
|
||||
FreeBSD 2.1,By Ugen J.S.Antsilevich <ugen@NetVision.net.il>
|
||||
.Nm Watch
|
||||
first appeared in FreeBSD 2.1
|
||||
|
||||
Loading…
Reference in New Issue
Block a user