Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

timeout

v0.13.0
timeout [OPTION] DURÉE COMMANDE...

Démarrer COMMANDE, et la tuer si elle fonctionne encore après DURÉE.

Options

--foreground, -f

when not running timeout directly from a shell prompt, allow COMMAND to read from the TTY and get TTY signals; in this mode, children of COMMAND will not be timed out

--kill-after, -k

also send a KILL signal if COMMAND is still running this long after the initial signal was sent

--preserve-status, -p

exit with the same status as COMMAND, even when the command times out

--signal=<SIGNAL>, -s <SIGNAL>

specify the signal to be sent on timeout; SIGNAL may be a name like ‘HUP’ or a number; see ‘kill -l’ for a list of signals

--verbose, -v

diagnose to stderr any signal sent upon timeout

a floating point number with an optional suffix: ‘s’ for seconds (the default), ‘m’ for minutes, ‘h’ for hours or ‘d’ for days ; a duration of 0 disables the associated timeout

a command to execute with optional arguments

À l’expiration du délai, le signal TERM est envoyé à COMMANDE, si aucun autre SIGNAL n’est spécifié. Le signal TERM tue tout processus qui ne bloque pas ou n’intercepte pas ce signal. Il peut être nécessaire d’utiliser le signal KILL, puisque ce signal ne peut pas être intercepté.

Statut de sortie : 124 si COMMANDE expire et que –preserve-status n’est pas spécifié 125 si la commande timeout elle-même échoue 126 si COMMANDE est trouvé mais ne peut être invoqué 127 si COMMANDE est introuvable 137 si COMMANDE (ou timeout lui-même) reçoit le signal KILL (9) (128+9)

  • sinon, le statut de sortie de COMMANDE

Examples

The examples have not been translated yet and are shown in English. You can help by translating them on tldr-pages.

Run sleep 10 and terminate it after 3 seconds:

timeout 3s sleep 10

Send a signal to the command after the time limit expires (TERM by default, kill -l to list all signals):

timeout {{[-s|--signal]}} {{INT|HUP|KILL|...}} {{5s}} {{sleep 10}}

Send verbose output to stderr showing signal sent upon timeout:

timeout {{[-v|--verbose]}} {{0.5s|1m|1h|1d|...}} {{command}}

Preserve the exit status of the command regardless of timing out:

timeout {{[-p|--preserve-status]}} {{1s|1m|1h|1d|...}} {{command}}

Send a forceful KILL signal after certain duration if the command ignores initial signal upon timeout:

timeout {{[-k|--kill-after]}} {{5m}} {{30s}} {{command}}

The examples are provided by the tldr-pages project under the CC BY 4.0 License.

Please note that, as uutils is a work in progress, some examples might fail.