IWATCH(1)

NAME
iwatch - watch the command output with interval timer

SYNOPSIS
iwatch [-rewpx] [-i interval] [-s start_line] [-c start_column] command [argument ...]

DESCRIPTION
iwatch displays the output of the command with argument and update the output periodically. The changes of outputs can be highlighted by reversing the text. Note that shell escaping needed at the command and arguments since they are given to sh -c. -x option changes this behavour.

The options are as follows:

-r  Reverse the changed chacter to highlight.

-e  Reverse the changed line to highlight.

-w  Reverse the changed word to highlight.

-p  Start with pausing the update.

-x  Pass the command and arguments to exec(2) as it is. In default behaviour, shell escaping is required at the command and argument because iwatch uses sh -c for handing them. Use this option not to do unnecessary shell escaping.

-i interval
    Set the initial interval second of the periodically update to interval. The default value is 2.

-s start_line
    Set the line number on the output where iwatch is to start display.

-c start_column
    Set the column number on the output where iwatch is to start display.

Certain characters cause immediate action by iwatch. These are:

k - Scroll up 1 line.

j <RETURN>
    Scroll down 1 line.

l   Scroll right 1 column.

h   Scroll left 1 column.

u ^U
    Scroll up half of the screen size.

d ^D
    Scroll down half of the screen size.

L   Scroll right half of the screen size.

H   Scroll left half of the screen size.

b ^B
    Scroll up one of the screen size.

f F Scroll down one of the screen size.

>   Scroll right one of the screen size.

<   Scroll left one of the screen size.

[   Scroll right 8 columns.

]   Scroll left 8 columns.

g   Goto the top or the prefix nubmer of lines on the output.

<SPACE>
    Update the buffer by executing the command.

^L  Refresh the screen without executing the command.

r   Toggle reversing the changing characters.

e   Toggle reversing the changing lines.

w   Toggle reversing the changing words.

t   Toggle current reversing mode.

i   Set the interval to the prefix number seconds.

i   Toggle the pausing update output.

?   Show help message.

q   Quit the program.

SEE ALSO
sh(1) exec(2)

HISTORY
The iwatch program is slightly derived from iwatch command come with BSD/OS 3.1 by BSDI, Inc., which originally came from some free distribution.