diff options
Diffstat (limited to 'usr.bin')
-rw-r--r-- | usr.bin/watch/watch.8 | 115 |
1 files changed, 70 insertions, 45 deletions
diff --git a/usr.bin/watch/watch.8 b/usr.bin/watch/watch.8 index a5f497d..a57a70c 100644 --- a/usr.bin/watch/watch.8 +++ b/usr.bin/watch/watch.8 @@ -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 |