Comando timeout de Linux explicado para principiantes (con ejemplos)

A veces, cuando ejecutas un comando en Linux, puede que quieras ejecutarlo por un tiempo determinado. Existe una utilidad de línea de comandos - timeout - que ha sido desarrollada específicamente para este propósito. En este artículo, discutiremos los conceptos básicos de este comando utilizando algunos ejemplos fáciles de entender.

Pero antes de hacer eso, vale la pena mencionar que todos los ejemplos en este tutorial han sido probados en una máquina Ubuntu 18.04 LTS.

Comando timeout de Linux

Como su nombre indica, el comando timeout en Linux te permite ejecutar un comando con un límite de tiempo. A continuación se muestra su sintaxis:

timeout [OPCIÓN] DURACIÓN COMANDO [ARG]...

Y así es como la página del manual de la herramienta lo explica:

timeout - ejecutar un comando con un límite de tiempo  
Iniciar COMANDO, y matarlo si sigue en ejecución después de DURACIÓN

A continuación se presentan algunos ejemplos en formato de preguntas y respuestas que deberían darte una mejor idea de cómo funciona esta herramienta.

P1. ¿Cómo usar el comando timeout?

El uso básico es bastante fácil: solo ejecuta ‘timeout’ especificando en la entrada un valor de timeout (considerado en segundos) así como el comando que deseas ejecutar.

Por ejemplo, si deseas que un comando ping se detenga después de 5 segundos, así es como puedes usar timeout en este caso.

timeout 5 ping google.com

P2. ¿Cómo obtener el estado de salida del comando en la salida?

Por defecto, si el comando timeout es exitoso, devuelve 124 como estado de salida. A continuación se muestra un ejemplo:

En el primer caso, dejé que el comando timeout se ejecutara con éxito, y como puedes ver, el estado de salida fue 124. Sin embargo, durante la segunda ejecución, maté forzosamente el comando usando Ctrl+C, y en ese caso, el estado de salida fue 0.

Pero en caso de que desees que timeout devuelva el estado del comando de entrada incluso si timeout se ejecuta con éxito, tendrás que usar la opción de línea de comandos –preserve-status.

Por ejemplo:

timeout --preserve-status 5 ping google.com

P3. ¿Cómo cambiar la señal que envía timeout?

No hay que adivinar que timeout funciona enviando una señal al comando de entrada para que este último deje de ejecutarse cuando se acerca la fecha límite. Por defecto, SIGTERM es utilizado por el comando.

Sin embargo, si lo deseas, puedes cambiar la señal que se envía por timeout. Para esto, tendrás que usar la opción de línea de comandos -s y especificar como entrada la señal que deseas que timeout envíe.

Por ejemplo:

timeout -s SIGKILL [COMANDO]

Para obtener una lista de señales disponibles que puedes enviar, ejecuta el siguiente comando:

kill -l

P4. ¿Cómo hacer que timeout envíe automáticamente la señal KILL?

A veces, puedes encontrar un comando de entrada que continúa ejecutándose incluso después de que timeout envía la señal inicial. Para casos como estos, timeout ofrece una opción ‘–kill-after’.

Así es como la página del manual lo explica:

-k, --kill-after=DURACIÓN  
              también enviar una señal KILL si el COMANDO sigue en ejecución  
              este tiempo después de que se envió la señal inicial

Así que como puedes ver, necesitas especificar una duración para que timeout sepa después de cuánto tiempo se debe enviar esta señal.

Conclusión

Dependiendo del tipo de trabajo que realices, el comando timeout puede resultar ser una herramienta bastante útil. Aquí, en este tutorial, hemos discutido la mayoría de las opciones que esta utilidad ofrece. Una vez que hayas terminado de practicar estos, puedes aprender más sobre timeout dirigiéndote a su página de manual.