TIMEOUT(1) | General Commands Manual | TIMEOUT(1) |
timeout
— run a
command with a time limit
timeout |
[-k time]
[-s sig]
[--foreground ]
[--preserve-status ] duration
command [args] |
The timeout
utility executes
command, with any args, and
kills it if it is still running after the specified
duration. If duration is 0, the
timeout is disabled.
The options are as follows:
-k
time,
--kill-after
=timeSIGKILL
, if the command is
still running time after the first signal was
sent.-s
sig,
--signal
=sigSIGTERM
.--foreground
--preserve-status
duration and time may contain a decimal fraction. The value defaults to seconds unless a unit suffix is given.
The supported unit suffixes are:
If the timeout was not reached or
--preserve-status
was set, the exit status of
command is returned.
If the timeout was reached and
--preserve-status
was not set, an exit status of 124
is returned.
If command exited after receiving a signal, the exit status returned is the signal number plus 128.
The timeout
utility first appeared in GNU
Coreutils 7.0 and has been available since OpenBSD
7.0.
September 4, 2021 | OpenBSD-current |