aboutsummaryrefslogtreecommitdiff
path: root/watch.1
blob: 0a7d0a7295cedc07d01d5d8c2608808afd55efde (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
.\"	$Id$
.Dd December 25, 2004
.Dt WATCH 1
.Os
.Sh NAME
.Nm watch
.Nd execute program periodically, showing output fullscreen
.Sh SYNOPSIS
.Nm watch
.Op Fl tv
.Op Fl n Ar time
.Op Ar command
.Sh DESCRIPTION
The
.Nm
utility runs a
.Ar command
repeatedly and displays its output fullscreen.
This allow you to watch an output of the
.Ar command
as it changes.
If the
.Ar command
is absent,
.Nm
will prompt for it.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl n Ar time
Set delay between screen updates in seconds.
The default value is 2 seconds.
.It Fl t
Disable output of the title bar.
.It Fl h
Display usage and terminate.
.El
.Pp
.Nm Watch
will terminate with the keyboard interrupt
.Pq Sq ^C
.Pp
.Sh EXAMPLE
.Nm
-n 1 ps
.Pp
.Sh HISTORY
The original
.Nm
was written by Tony Rems <rembo@unisoft.com> in 1991,
with mods and corrections by Francois Pinard.
It was rewritten completly from scratch by Dimitri Sokolyuk
<demon@dim13.org> in 2003.