Accueil·Commandes du terminal

timeout

Processus et système

Syntaxe

timeout <duration> <command>

Execute une commande avec une limite de temps et la coupe au depassement, en sortant avec 124 ; le signal par defaut est TERM, qu'un programme bloque peut ignorer, ajoutez donc `-k` pour enchainer avec KILL (GNU coreutils, absent de macOS).

Options courantes

OptionSignification
30 / 5m / 1hDuration in seconds unless you add s, m, h or d.
-s <SIGNAL>Send something other than TERM when time runs out.
-k 5If the command ignores TERM, send KILL five seconds later.
--preserve-statusExit with the command's own status instead of 124.
exit code 124What timeout returns when it had to stop the command.

Exemples

timeout 30 curl -s https://example.com

Give up on a hung request after thirty seconds.

timeout -k 5 60 ./import.sh

One minute to finish politely, then five seconds before KILL.

Ce qui tourne et ce qui mange la machine. Identifier vient avant tuer.

Comment lire

  • Les crochets [ ] marquent une partie facultative.
  • Les points de suspension … signifient qu’on peut en mettre plusieurs.
  • Les options sont sensibles à la casse : sur certaines commandes, -r et -R ne font pas la même chose.

Questions fréquentes

Q. Que fait timeout ?

Execute une commande avec une limite de temps et la coupe au depassement, en sortant avec 124 ; le signal par defaut est TERM, qu'un programme bloque peut ignorer, ajoutez donc `-k` pour enchainer avec KILL (GNU coreutils, absent de macOS).

Q. Comment l’écrire ?

timeout <duration> <command> — les crochets marquent ce qui est facultatif.

Q. Combien d’options valent la peine ?

Il y en a 5 ici ; la liste complète est dans man timeout. Cette commande relève de Processus et système.

Commandes liées

page man: man timeout