*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> watch (1)              
Title
Content
Arch
Section
 

WATCH(1)

Contents


NAME    [Toc]    [Back]

       watch - execute a program periodically, showing output fullscreen

SYNOPSIS    [Toc]    [Back]

       watch   [-dhv]  [-n  <seconds>]	[--differences[=cumulative]]  [--help]
       [--interval=<seconds>] [--version] <command>

DESCRIPTION    [Toc]    [Back]

       watch runs command repeatedly, displaying its output (the first screenfull).
	This  allows you to watch the program output change over time.
       By default, the program is run every 2 seconds; use -n or --interval to
       specify a different interval.

       The  -d	or  --differences  flag will highlight the differences between
       successive  updates.   The  --cumulative  option   makes   highlighting
       "sticky",  presenting a running display of all positions that have ever
       changed.

       watch will run until interrupted.

NOTE    [Toc]    [Back]

       Note that command is given to "sh -c" which means that you may need  to
       use extra quoting to get the desired effect.

       Note  that  POSIX  option  processing  is used (i.e., option processing
       stops at the first non-option argument).  This means that  flags  after
       command don't get interpreted by watch itself.

EXAMPLES    [Toc]    [Back]

       To watch for mail, you might do

	      watch -n 60 from

       To watch the contents of a directory change, you could use

	      watch -d ls -l

       If you're only interested in files owned by user joe, you might use

	      watch -d 'ls -l | fgrep joe'

       To see the effects of quoting, try these out

	      watch echo $$

	      watch echo '$$'

	      watch echo "'"'$$'"'"

       You can watch for your administrator to install the latest kernel with

	      watch uname -r

       (Just kidding.)

BUGS    [Toc]    [Back]

       Upon  terminal resize, the screen will not be correctly repainted until
       the next scheduled update.  All --differences highlighting is  lost  on
       that update as well.

       Non-printing characters are stripped from program output.  Use "cat -v"
       as part of the command pipeline if you want to see them.

AUTHORS    [Toc]    [Back]

       The original watch was written  by  Tony  Rems  <[email protected]>  in
       1991,  with  mods  and corrections by Francois Pinard.  It was reworked
       and new features added by Mike Coleman <[email protected]> in 1999.



				  1999 Apr 3			      WATCH(1)
[ Back ]
 Similar pages
Name OS Title
execve Linux execute program
dop Tru64 Allows a user to execute a privileged program without knowing the root password. The dop command als...
log Tru64 Records input and output from a program
update Tru64 Periodically updates the file system
setAudioDevice IRIX program to set SoundScheme audio output device
tee Tru64 Displays the output of a program and copies it into a file
syncer HP-UX periodically sync for file system integrity
dlook IRIX a tool for showing memory and process placement
numa_view IRIX a tool for showing NUMA placement information
VkModifiedAttachment IRIX Attachment class for showing modified text widgets
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service