Commande timeout Linux expliquée pour les débutants (avec des exemples)

Parfois, lorsque vous exécutez une commande sous Linux, vous pourriez vouloir l’exécuter pendant une durée déterminée. Il existe un utilitaire en ligne de commande - timeout - qui a été spécialement développé à cet effet. Dans cet article, nous allons discuter des bases de cette commande à l’aide d’exemples faciles à comprendre.

Mais avant cela, il convient de mentionner que tous les exemples de ce tutoriel ont été testés sur une machine Ubuntu 18.04 LTS.

Commande timeout Linux

Comme son nom l’indique, la commande timeout sous Linux vous permet d’exécuter une commande avec une limite de temps. Voici sa syntaxe :

timeout [OPTION] DURATION COMMAND [ARG]...

Et voici comment la page de manuel de l’outil l’explique :

timeout - exécute une commande avec une limite de temps  
Démarre COMMAND, et l'arrête si elle est toujours en cours d'exécution après DURATION

Voici quelques exemples sous forme de questions-réponses qui devraient vous donner une meilleure idée de la façon dont cet outil fonctionne.

Q1. Comment utiliser la commande timeout ?

L’utilisation de base est assez simple - il suffit d’exécuter ‘timeout’ en spécifiant en entrée une valeur de timeout (considérée en secondes) ainsi que la commande que vous souhaitez exécuter.

Par exemple, si vous souhaitez arrêter une commande ping après 5 secondes, voici comment vous pouvez utiliser timeout dans ce cas.

timeout 5 ping google.com

Q2. Comment obtenir le statut de sortie de la commande en sortie ?

Par défaut, si la commande timeout réussit, elle renvoie 124 comme statut de sortie. Voici un exemple :

Dans le premier cas, j’ai laissé la commande timeout s’exécuter avec succès, et comme vous pouvez le voir, le statut de sortie était 124. Cependant, lors de la deuxième exécution, j’ai tué la commande de force en utilisant Ctrl+C, et dans ce cas, le statut de sortie était 0.

Mais si vous souhaitez que timeout renvoie le statut de la commande d’entrée même si timeout s’exécute avec succès, vous devrez utiliser l’option de ligne de commande –preserve-status.

Par exemple :

timeout --preserve-status 5 ping google.com

Q3. Comment changer le signal envoyé par timeout ?

Pas besoin de deviner que timeout fonctionne en envoyant un signal à la commande d’entrée afin que cette dernière cesse de s’exécuter lorsque la date limite approche. Par défaut, SIGTERM est utilisé par la commande.

Cependant, si vous le souhaitez, vous pouvez changer le signal qui est envoyé par timeout. Pour cela, vous devrez utiliser l’option de ligne de commande -s et spécifier en entrée le signal que vous souhaitez que timeout envoie.

Par exemple :

timeout -s SIGKILL [COMMAND]

Pour obtenir une liste des signaux disponibles que vous pouvez envoyer, exécutez la commande suivante :

kill -l

Q4. Comment faire en sorte que timeout envoie automatiquement le signal KILL ?

Parfois, vous pouvez rencontrer une commande d’entrée qui continue de s’exécuter même après que timeout a envoyé le signal initial. Pour des cas comme ceux-ci, timeout offre une option ‘–kill-after’.

Voici comment la page de manuel l’explique :

-k, --kill-after=DURATION  
              envoie également un signal KILL si COMMAND est toujours en cours d'exécution  
              aussi longtemps après que le signal initial a été envoyé

Donc, comme vous pouvez le voir, vous devez spécifier une durée pour faire savoir à timeout après combien de temps ce signal doit être envoyé.

Conclusion

En fonction du type de travail que vous effectuez, la commande timeout peut s’avérer être un outil très pratique. Ici, dans ce tutoriel, nous avons discuté de la majorité des options que cet utilitaire offre. Une fois que vous aurez terminé de pratiquer ces exemples, vous pourrez en apprendre davantage sur timeout en consultant sa page de manuel.