Comando timeout di Linux spiegato per principianti (con esempi)

A volte, quando esegui un comando in Linux, potresti voler eseguirlo per un tempo limitato. Esiste un’utilità da riga di comando - timeout - sviluppata specificamente per questo scopo. In questo articolo, discuteremo le basi di questo comando utilizzando alcuni esempi facili da comprendere.

Ma prima di farlo, vale la pena menzionare che tutti gli esempi in questo tutorial sono stati testati su una macchina Ubuntu 18.04 LTS.

Comando timeout di Linux

Come suggerisce il nome, il comando timeout in Linux ti consente di eseguire un comando con un limite di tempo. Di seguito è riportata la sua sintassi:

timeout [OPZIONE] DURATA COMANDO [ARG]...

Ecco come la pagina man dello strumento lo spiega:

timeout - esegui un comando con un limite di tempo  
Avvia COMANDO e termina se è ancora in esecuzione dopo DURATA

Di seguito sono riportati alcuni esempi in stile Q&A che dovrebbero darti un’idea migliore di come funziona questo strumento.

D1. Come utilizzare il comando timeout?

L’uso di base è piuttosto semplice: basta eseguire ‘timeout’ specificando in input un valore di timeout (considerato in secondi) così come il comando che desideri eseguire.

Ad esempio, se desideri interrompere un comando ping dopo 5 secondi, ecco come puoi utilizzare timeout in questo caso.

timeout 5 ping google.com

D2. Come ottenere lo stato di uscita del comando in output?

Per impostazione predefinita, se il comando timeout ha successo, restituisce 124 come stato di uscita. Di seguito è riportato un esempio:

Nel primo caso, ho lasciato eseguire con successo il comando timeout e, come puoi vedere, lo stato di uscita era 124. Tuttavia, durante la seconda esecuzione, ho terminato forzatamente il comando utilizzando Ctrl+C, e in quel caso, lo stato di uscita era 0.

Ma nel caso in cui tu voglia che timeout restituisca lo stato del comando di input anche se timeout viene eseguito con successo, dovrai utilizzare l’opzione da riga di comando –preserve-status.

Ad esempio:

timeout --preserve-status 5 ping google.com

D3. Come cambiare il segnale che timeout invia?

Non c’è bisogno di indovinare che timeout funziona inviando un segnale al comando di input in modo che quest’ultimo smetta di eseguire quando si avvicina la scadenza. Per impostazione predefinita, viene utilizzato SIGTERM dal comando.

Tuttavia, se lo desideri, puoi cambiare il segnale che viene inviato da timeout. Per questo, dovrai utilizzare l’opzione da riga di comando -s e specificare come input il segnale che desideri che timeout invii.

Ad esempio:

timeout -s SIGKILL [COMANDO]

Per ottenere un elenco dei segnali disponibili che puoi inviare, esegui il seguente comando:

kill -l

D4. Come far sì che timeout invii automaticamente il segnale KILL?

A volte, potresti incontrare un comando di input che continua a essere eseguito anche dopo che timeout ha inviato il segnale iniziale. Per casi come questi, timeout offre un’opzione ‘–kill-after’.

Ecco come la pagina man lo spiega:

-k, --kill-after=DURATA  
              invia anche un segnale KILL se il COMANDO è ancora in esecuzione  
              per questo lungo tempo dopo che è stato inviato il segnale iniziale

Quindi, come puoi vedere, devi specificare una durata per far sapere a timeout dopo quanto tempo deve essere inviato questo segnale.

Conclusione

A seconda del tipo di lavoro che fai, il comando timeout può rivelarsi uno strumento piuttosto utile. Qui, in questo tutorial, abbiamo discusso la maggior parte delle opzioni che questa utilità offre. Una volta che hai finito di esercitarti con questi, puoi saperne di più su timeout consultando la sua pagina man.