2017-10-04 21:28:37 +01:00
|
|
|
# timeout
|
|
|
|
|
|
|
|
|
|
> Run a command with a time limit.
|
2021-04-01 16:54:26 +01:00
|
|
|
> More information: <https://www.gnu.org/software/coreutils/timeout>.
|
2017-10-04 21:28:37 +01:00
|
|
|
|
2024-02-09 13:55:36 +00:00
|
|
|
- Run `sleep 10` and terminate it after 3 seconds:
|
2017-10-04 21:28:37 +01:00
|
|
|
|
2024-02-09 13:55:36 +00:00
|
|
|
`timeout 3s sleep 10`
|
2017-10-04 21:28:37 +01:00
|
|
|
|
2024-08-01 09:48:51 +01:00
|
|
|
- Send a [s]ignal to the command after the time limit expires (`TERM` by default, `kill -l` to list all signals):
|
2017-10-04 21:28:37 +01:00
|
|
|
|
2024-08-01 09:48:51 +01:00
|
|
|
`timeout --signal {{INT|HUP|KILL|...}} {{5s}} {{sleep 10}}`
|
|
|
|
|
|
|
|
|
|
- Send [v]erbose output to `stderr` showing signal sent upon timeout:
|
|
|
|
|
|
|
|
|
|
`timeout --verbose {{0.5s|1m|1h|1d|...}} {{command}}`
|
|
|
|
|
|
|
|
|
|
- Preserve the exit status of the command regardless of timing out:
|
|
|
|
|
|
|
|
|
|
`timeout --preserve-status {{1s|1m|1h|1d|...}} {{command}}`
|
|
|
|
|
|
|
|
|
|
- Send a forceful `KILL` signal after certain duration if the command ignores initial signal upon timeout:
|
|
|
|
|
|
|
|
|
|
`timeout --kill-after={{5m}} {{30s}} {{command}}`
|
