WATCH

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@freelists.org>

This document was created by man2html, using the manual pages.
Time: 05:05:59 GMT, September 19, 2025