.\"
.\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
.\" Translated Tue Nov 14 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated & Modified Fri Jul 15 02:40:41 JST 2005
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\" Updated Wed Aug 10 15:51:58 JST 2011
.\"         by TACHIBANA Akira <tati@kc5.so-net.ne.jp>
.\" Updated Thu Sep 15 19:00:32 JST 2011
.\"         by TACHIBANA Akira <tati@kc5.so-net.ne.jp>
.\"
.TH WATCH 1 "1999 Apr 3" " " "Linux User's Manual"
.SH 名前
watch \- プログラムを定期的に実行し、出力をフルスクリーンで表示する
.SH 書式
.B watch
.I [\-dhvt] [\-n <seconds>] [\-\-differences[=cumulative]] [\-\-help] [\-\-interval=<seconds>] [\-\-no\-title] [\-\-version] <command>
.SH 説明
.B watch
は
.I command
を繰り返し実行し、その出力を表示する (一画面に収まる一杯まで)。
.B watch
を用いると、プログラムの出力の経時変化を監視できる。
デフォルトでは、プログラムは 2 秒おきに実行される。
時間の間隔を変えたい場合は、
.IR -n " または " --interval
を用いる。
.PP
.IR -d " または " --differences
このフラグを指定すると、更新が行われたとき、
前回と異なっている部分をハイライト表示する。
.I cumulative
オプションをつけると、ハイライトが "sticky" になる。
すなわち、
実行が開始されてから変更があった全ての部分をハイライトで表示する。
.IR -t " または " --no-title
このオプションを指定すると、画面の先頭行の
時間間隔・コマンド名・現在時刻を示すヘッダと、
その後の空行が表示されなくなる。
.PP
.B watch
は中断されるまで実行を続ける。
.SH 注意
.I command
は "sh -c" に与えられる。したがって
.I command
を望みの通りに動作させるには、クォートを余分に用いる必要があるかもしれない。
.PP
POSIX のオプション処理が用いられる
(つまり、オプション処理は最初にオプション以外の引数が現れた時点で終了する)
ことに注意して欲しい。
つまり、
.I command
以降のフラグを
.B watch
は解釈しない。
.SH 例
.PP
メールを監視する:
.IP
watch \-n 60 from
.PP
ディレクトリの中身の変化を監視する:
.IP
watch \-d ls \-l
.PP
ユーザー joe の所有するファイルのみを監視する:
.IP
watch \-d 'ls \-l | fgrep joe'
.PP
クォートの効果を見てみたい場合:
.IP
watch echo $$
.IP
watch echo '$$'
.IP
watch echo "'"'$$'"'"
.PP
管理者による最新のカーネルのインストール状況を監視する:
.IP
watch uname -r
.PP
(ただの冗談です)
.SH バグ
端末のリサイズ時に、スクリーンは正しく再描画されない。
次の更新スケジュールを待たなければならない。
.I --differences
によるハイライト表示は、その更新の際に全て失われる。
.PP
非印字文字はプログラム出力から取り除かれる。
これらをみたい場合は、コマンドのパイプラインのどこかで
"cat -v" を用いること。
.SH 作者
もともとの
.B watch
は Tony Rems <rembo@unisoft.com> が 1991 年に書いた。
Francois Pinard が修正・変更を行った。
Mike Coleman <mkc@acm.org> が 1999 年に書き直し、
新しい機能を追加した。