xref: /freebsd/usr.sbin/watch/watch.8 (revision 17ee9d00bc1ae1e598c38f25826f861e4bc6c3ce)
1.Dd Februar 17, 1995
2.Dt WATCH 8
3.Os
4.Sh NAME
5watch - tty snoop watching utility.
6
7.Sh SYNOPSIS
8
9 watch [-ciot] [<tty name>]
10
11.Sh DESCRIPTION
12 watch utility allows user to see all data coming to the tty,almost
13 the same way as user on this tty.
14 Only root can run watch.
15
16The following options are available:
17
18-c   Reconnect on close. When tty on which watching was made closed,
19     utility will automatically reattach itself to the same tty.
20     By default utility will ask user to enter new tty name if running
21     in interactive mode or exit while non-interactive.
22
23-i   Force interactive mode.Interactive mode is a default if utility
24     started from tty. If output redirected to file, you can still force
25     it into interactive mode by this option.
26
27-o   Reconnect on overflow. The behaviour of utility on overflow is same
28     as for tty close. For more info see snp(4).
29
30-t   Timestamp.Print date and time each time, tty watching started.
31
32 The <tty name> is one of following types:
33  ttyp?,ttyq?,ttyr? - pseudo tty devices.
34  ttyv? - virtual ttys (syscons).
35  tty0?,ttyd? - serial lines.
36 Each name can be preceeded by "/dev/".
37 Also recognized:
38  pty[NUM] - pseudotty's.
39  vty[NUM] - virtual ttys.
40  sio[NUM] - serial lines.
41
42 While running interactive, all user input discarded except :
43  Ctrl+C - Exit watch.
44  Ctrl+X - Change attached tty.
45  Ctrl+W - Clear screen.
46
47.Sh SEE ALSO
48snp(4),pty(4),sio(4)
49.Sh BUGS
50No terminal emulation involved,all user output comes to the screen as-is.
51.Sh HISTORY
52FreeBSD 2.1,By Ugen J.S.Antsilevich <ugen@NetVision.net.il>
53