Cómo usar el comando timeout en Linux

Laptop con Linux que muestra un indicador de bash
Fatmawati Achmad Zaenuri / Shutterstock.com

Bien, ya es suficiente tiempo en la computadora. Puede dar a los procesos límites de tiempo, estableciendo un tiempo máximo durante el que pueden ejecutarse con el timeoutcomando. Aquí hay un tutorial para poner límites a la ejecución de programas con este comando.

¿Qué le aporta el tiempo de espera?

El   timeoutcomando le permite establecer un límite en el tiempo que se ejecutará un programa. Pero, ¿por qué querrías hacer eso?

Un caso es cuando sabe exactamente cuánto tiempo desea que se ejecute un proceso. Un caso de uso común es tener el timeout control de un programa de registro o captura de datos para que los archivos de registro no consuman implacablemente el espacio de su disco duro.

Otro caso es cuando no sabe cuánto tiempo desea que se ejecute un proceso, pero sí sabe que no desea que se ejecute indefinidamente. Es posible que tenga el hábito de configurar procesos en ejecución, minimizar la ventana de terminal y olvidarse de ellos.

Algunos programas, incluso utilidades simples, pueden generar tráfico de red a niveles que pueden impedir el rendimiento de su red. O pueden inmovilizar los recursos en un dispositivo de destino, lo que ralentiza su rendimiento. ( ping, Te estoy mirando.) Dejar este tipo de programas ejecutándose durante períodos prolongados mientras no estás en tu computadora es una mala práctica.

timeoutes parte de GNU Core Utils,  por lo que Linux y los sistemas operativos similares a Unix, como macOS, tienen el tiempo de espera integrado. No hay nada que instalar; puede usarlo nada más sacarlo de la caja.

Comenzando con el tiempo de espera

He aquí un ejemplo sencillo. Por ejemplo, con sus opciones de línea de comandos predeterminadas, el pingcomando se ejecutará hasta que lo detenga presionando Ctrl + C. Si no lo interrumpe, continuará.

ping 192.168.4.28

ping 192.168.4.28 en una ventana de terminal

Al usarlo timeout, podemos asegurarnos de pingque no se ejecute de forma intermitente, consumiendo el ancho de banda de la red y molestando a cualquier dispositivo al que se le haga ping.

Relacionado:  Cómo mostrar la fecha y la hora en la terminal de Linux (y usarla en scripts Bash)

Este próximo comando se usa timeout para limitar el tiempo  ping. Estamos permitiendo 15 segundos de tiempo de ejecución para  ping.

tiempo de espera 15 ping 192.168.4.28

tiempo de espera 15 ping 192.168.4.28 en una ventana de terminal

Después de 15 segundos timeouttermina la pingsesión y regresamos a la línea de comandos.

sesión de ping terminada en una ventana de terminal

Uso del tiempo de espera con otras unidades de tiempo

Tenga en cuenta que no tuvimos que agregar una «s» detrás de 15. se timeoutsupone que el valor está en segundos. Puede agregar una «s», pero realmente no hace ninguna diferencia.

Para usar un valor de tiempo medido en minutos, horas o días, agregue una «m», una «h» o una «d».

Para que el ping se ejecute durante tres minutos, utilice el siguiente comando:

tiempo de espera 3m ping 192.168.4.28

tiempo de espera 3m ping 192.168.4.28 en una ventana de terminal

pingse ejecutará durante tres minutos antes de  timeout que entre y detenga la pingsesión.

sesión de ping que se ejecuta en una terminal viuda

Limitar la captura de datos con tiempo de espera

Algunos archivos de captura de datos pueden crecer muy rápidamente. Para evitar que dichos archivos se vuelvan difíciles de manejar o incluso de tamaño problemático, limite la cantidad de tiempo que el programa de captura puede ejecutarse.

En este ejemplo, estamos usando tcpdumpuna herramienta de captura de tráfico de red . En las máquinas de prueba en las que se investigó este artículo, tcpdumpya estaba instalado en Ubuntu Linux y Fedora Linux. Había que instalarlo en Manjaro Linux y Arch Linux, con el siguiente comando:

sudo pacman -Syu tcpdump

sudo pacman -Syu tcpdump en una ventana de terminal

Podemos ejecutar tcpdump durante 10 segundos sus opciones predeterminadas y redirigir su salida a un archivo llamado capture.txt con el siguiente comando:

tiempo de espera 10 sudo tcpdump> capture.txt

timeout 10 sudo tcpdump> capture.txt en una ventana de terminal

( tcpdumptiene sus propias opciones para guardar el tráfico de red capturado en un archivo. Este es un truco rápido porque estamos discutiendo timeout, no tcpdump).

tcpdumpcomienza a capturar el tráfico de la red y esperamos 10 segundos. Y 10 segundos van y vienen y tcpdumptodavía se están ejecutando, y capture.txt sigue creciendo en tamaño. Se necesitará un rápido Ctrl + C para detenerse tcpdump.

Verificar el tamaño de capture.txt con lsmuestra que creció a 209K en cuestión de segundos. ¡Ese archivo estaba creciendo rápidamente!

ls -lh capture.txt

ls -lh capture.txt en una ventana de terminal

¿Que pasó? ¿Por qué no se timeoutdetuvo tcpdump?

Todo tiene que ver con las señales.

Relacionado:  Cómo usar at y batch en Linux para programar comandos

Enviar la señal correcta

Cuando timeoutquiere detener un programa envía la señal SIGTERM . Esto pide cortésmente que el programa termine. Algunos programas pueden optar por ignorar la señal SIGTERM. Cuando eso suceda, debemos decir timeoutque debemos ser un poco más enérgicos.

Podemos hacer eso pidiendo timeoutenviar la señal SIGKILL en su lugar.

La señal SIGKILL no puede ser “capturada, bloqueada o ignorada”, siempre se transmite. SIGKILL no pide cortésmente al programa que se detenga. SIGKILL se esconde a la vuelta de la esquina con un cronómetro y un cosh.

Podemos usar la -sopción (señal) para decirle timeoutque envíe la señal SIGKILL.

tiempo de espera -s SIGKILL 10 sudo tcpdump> capture.txt

timeout -s SIGKILL 10 sudo tcpdump> capture.txt en una ventana de terminal

Este tiempo, tan pronto como hayan transcurrido 10 segundos, tcpdumpse detiene.

tcpdump muerto en una ventana de terminal

Preguntar educadamente primero

Podemos pedir timeoutque intentemos detener el programa usando SIGTERM, y solo enviar SIGKILL si SIGTERM no funcionó.

Para hacer esto, usamos la -kopción (matar después). La -kopción requiere un valor de tiempo como parámetro.

En este comando, pedimos timeoutque lo dejemos dmesgcorrer durante 30 segundos y luego lo terminemos con la señal SIGTERM. Si dmesgtodavía está funcionando después de 40 segundos, significa que el diplomático SIGTERM fue ignorado y  timeoutdebe enviar SIGKILL para terminar el trabajo.

dmesges una utilidad que puede monitorear los mensajes del búfer de anillo del kernel y mostrarlos en una ventana de terminal.

tiempo de espera -k 40 30 dmseg -w

timeout -k 40 30 dmseg -w en una ventana de terminal

dmesg funciona durante 30 segundos y se detiene cuando recibe la señal SIGTERM.

Salida de dmesg en una ventana de terminal

Sabemos que no fue SIGKILL quien se detuvo dmesgporque SIGKILL siempre deja un obituario de una palabra en la ventana de la terminal: «Asesinado». Eso no sucedió en este caso.

Recuperar el código de salida del programa

Los programas que se comportan bien devuelven un valor al shell cuando terminan. Esto se conoce como código de salida. Normalmente, esto se utiliza para decirle al shell, o cualquier proceso que haya iniciado el programa, si el programa encontró problemas mientras se ejecutaba.

timeoutproporciona su propio código de salida, pero es posible que eso no nos importe. Probablemente estemos más interesados ​​en el código de salida del proceso que timeoutestá controlando.

Relacionado:  Cómo utilizar los comandos cat y tac de Linux

Este comando se pingejecuta durante cinco segundos. Está haciendo ping a una computadora llamada Nostromo, que está en la red de prueba que se usó para investigar este artículo.

tiempo de espera 5 ping Nostromo.local

timeout 5 ping Nostromo.local en una ventana de terminal

El comando se ejecuta durante cinco segundos y lo timeoutfinaliza. Luego podemos verificar el código de salida usando este comando:

echo $?

salida de ping y echo $?  en una ventana de terminal

El código de salida es 124. Este es el valor que se timeoutusa para indicar que el programa se terminó usando SIGTERM. Si SIGKILL termina el programa, el código de salida es 137.

Si interrumpimos el programa con Ctrl + C el código de salida de timeoutes cero.

tiempo de espera 5 ping Nostromo.local
echo $?

timeout 5 ping Nostromo.local en una ventana de terminal usando Ctrl + C

Si la ejecución del programa termina antes de que lo timeout termine, timeoutpuede pasar el código de salida del programa al shell.

Para que esto suceda el programa debe llegar a su fin por sí misma (en otras palabras, es no terminado por timeout), y hay que utilizar la --preserve-statusopción.

Si usamos la -copción (contar) con un valor de cinco ping, solo dispararemos cinco solicitudes. Si le damos timeout una duración de un minuto, pingdefinitivamente habrá terminado por sí solo. Luego podemos verificar el valor de salida usando echo.

tiempo de espera - preservar-estado 1m ping -c 5 Nostromo.local
echo $?

timeout --preserve-status 1m ping -c 5 Nostromo.local en una ventana de terminal

pingcompleta sus cinco solicitudes de ping y termina. El código de salida es cero.

Para verificar que el código de salida proviene ping, fuercemos  pinga generar un código de salida diferente. Si intentamos enviar solicitudes de ping a una dirección IP inexistente, pingfallará con un código de salida de error. Luego, podemos usar echopara verificar que el código de salida no sea cero.

timeout --preserve-status 1m ping -c 5 NotHere.local
echo $?

timeout --preserve-status 1m ping -c 5 NotHere.local en una ventana de terminal

El pingcomando obviamente no puede alcanzar el dispositivo inexistente, por lo que informa del error y se cierra. El código de salida es dos. Este es el código de salida que se ping utiliza para errores generales.

Establecer reglas básicas

timeoutse trata de proporcionar algunos límites a los programas en ejecución. Si existe el peligro de que los archivos de registro invadan su disco duro o que olvide que dejó una herramienta de red en ejecución, envuélvalos timeouty deje que su computadora se autorregule.