Penguin
Recent Changes
Annotated edit history of watch(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 WATCH
2 !!!WATCH
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 NOTE
7 EXAMPLES
8 BUGS
9 AUTHORS
10 ----
11 !!NAME
12
13
14 watch - execute a program periodically, showing output fullscreen
15 !!SYNOPSIS
16
17
18 __watch__ ''[[-dhv] [[-n
19 ''
20 !!DESCRIPTION
21
22
23 __watch__ runs ''command'' repeatedly, displaying its
24 output (the first screenfull). This allows you to watch the
25 program output change over time. By default, the program is
26 run every 2 seconds; use ''-n'' or ''--interval'' to
27 specify a different interval.
28
29
30 The ''-d'' or ''--differences'' flag will highlight
31 the differences between successive updates. The
32 ''--cumulative'' option makes highlighting
33 ''
34
35
36 __watch__ will run until interrupted.
37 !!NOTE
38
39
40 Note that ''command'' is given to
41 ''
42
43
44 Note that POSIX option processing is used (i.e., option
45 processing stops at the first non-option argument). This
46 means that flags after ''command'' don't get interpreted
47 by __watch__ itself.
48 !!EXAMPLES
49
50
51 To watch for mail, you might do
52
53
54 watch -n 60 from
55
56
57 To watch the contents of a directory change, you could
58 use
59
60
61 watch -d ls -l
62
63
64 If you're only interested in files owned by user joe, you
65 might use
66
67
68 watch -d 'ls -l | fgrep joe'
69
70
71 To see the effects of quoting, try these out
72
73
74 watch echo $$
75
76
77 watch echo '$$'
78
79
80 watch echo
81
82
83 You can watch for your administrator to install the latest
84 kernel with
85
86
87 watch uname -r
88
89
90 (Just kidding.)
91 !!BUGS
92
93
94 Upon terminal resize, the screen will not be correctly
95 repainted until the next scheduled update. All
96 ''--differences'' highlighting is lost on that update as
97 well.
98
99
100 Non-printing characters are stripped from program output.
101 Use
102 !!AUTHORS
103
104
105 The original __watch__ was written by Tony Rems
106 __
107 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.