timeout
Options
--foreground
,-f
-
timeout-help-foreground
--kill-after
,-k
-
timeout-help-kill-after
--preserve-status
,-p
-
timeout-help-preserve-status
--signal=<SIGNAL>
,-s <SIGNAL>
-
timeout-help-signal
--verbose
,-v
-
timeout-help-verbose
Examples
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.