NOM
watch - Exécuter un programme périodiquement en affichant le résultat à l’écran
SYNOPSIS
watch [options] commande
DESCRIPTION
watch exécute la commande périodiquement et affiche le résultat et les erreurs (en plein écran). Cela permet d’observer les changements de résultats du programme au fil du temps. Par défaut, command est exécuté toutes les deux secondes et watch fonctionnera jusqu’à être interrompu.
OPTIONS
-b, --beep
Émettre un bip lorsque le code de retour de la commande est non nul.
-c, --color
Interpréter les suites et style de couleur ANSI.
-C, --no-color
Do not interpret ANSI color and style sequences.
-d, --differences[=permanent]
Highlight the differences between successive updates. If the optional permanent argument is specified then watch will show all changes since the first iteration.
-e, --errexit
Geler les mises à jour en cas d’erreur de la commande et quitter après avoir appuyé sur une touche.
-g, --chgexit
Terminer quand la sortie de commande est modifiée.
-n, --interval intervalle
Specify update interval. The command will not allow quicker than 0.1 second interval, in which the smaller values are converted. Both ’.’ and ’,’ work for any locales. The WATCH_INTERVAL environment can be used to persistently set a non-default interval (following the same rules and formatting).
-p, --precise
Make watch attempt to run command every --interval seconds. Try it with ntptime (if present) and notice how the fractional seconds stays (nearly) the same, as opposed to normal mode where they continuously increase.
-q, --equexit <cycles>
Exit when output of command does not change for the given number of cycles.
-r, --no-rerun
Do not run the program on terminal resize, the output of the program will re-appear at the next regular run time.
-t, --no-title
Cacher l’en-tête contenant l’intervalle, la commande et la date actuelle en haut de l’affichage, ainsi que la ligne blanche qui suit.
-w, --no-wrap
Turn off line wrapping. Long lines will be truncated instead of wrapped to the next line.
-x, --exec
Passer command à exec(2) au lieu de sh -c réduit le nombre d’échappements pour obtenir le même résultat.
-h, --help
Afficher l’aide et quitter.
-v, --version
Afficher la version du logiciel et quitter.
CODES DE RETOUR
|
0 |
Réussite. | ||
|
1 |
Erreurs diverses. | ||
|
2 |
Échec lors du dédoublement (« fork ») du processus à observer. | ||
|
3 |
Échec de remplacement de la sortie standard du processus fils par une écriture vers le tube. | ||
|
4 |
Échec d’exécution de la commande. | ||
|
5 |
Échec de la fermeture d’écriture vers le tube du processus fils. | ||
|
7 |
Échec de la création du tube IPC. | ||
|
8 |
Le processus fils n’a pas pu renvoyer une valeur avec waitpid(2) ou la commande s’est terminée en erreur. | ||
|
autre |
L’observation propagera l’état du code de retour en tant que code de retour du fils. |
ENVIRONNEMENT
The behavior of watch is
affected by the following environment variables.
WATCH_INTERVAL
Update interval, follows the same rules as the --interval command line option.
NOTES
Remarquez que la reconnaissance des options suit la norme POSIX (le traitement des options s’arrête dès le premier paramètre qui n’est pas une option). Cela signifie que les options se trouvant après la commande ne seront pas interprétées par watch.
BOGUES
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. When using the --no-rerun option, no output of will be visible.
Les caractères non imprimables de la sortie du programme sont ignorés. Utilisez cat -v pour les afficher.
La combinaison de caractères supposés s’afficher en dernière colonne de l’écran risque de s’afficher dans la colonne précédente ou pas du tout.
Les combinaisons de caractères ne sont jamais considérées différentes en mode --differences. Seul le caractère de base est considéré.
Les lignes blanches qui suivent directement une ligne s’arrêtant en dernière colonne ne sont pas affichées
--precise mode doesn’t yet have advanced temporal distortion technology to compensate for a command that takes more than --interval seconds to execute. watch also can get into a state where it rapid-fires as many executions of command as it can to catch up from a previous executions running longer than --interval (for example, netstat(8) taking ages on a DNS lookup).
EXEMPLES
Pour vérifier les courriels :
watch -n 60 from
Pour afficher les changements dans le contenu d’un répertoire :
watch -d ls -l
Pour n’afficher que les fichiers appartenant à arthur :
watch -d ’ls -l | fgrep arthur’
Pour vérifier l’effet des guillemets :
watch echo $$
watch echo ’$$’
watch echo
"’"’$$’"’"
Pour vérifier l’effet du temps de maintien de la précision, essayez en ajoutant -p à
watch -n 10 sleep 1
Pour vérifier que l’administrateur a installé le dernier noyau avec
watch uname -r
(Note that -p isn’t guaranteed to work across reboots, especially in the face of ntpdate (if present) or other bootup time-changing mechanisms)
BOGUES
Signalez les bogues à <procps [AT] freelists.org>