DragonFly On-Line Manual Pages
TIMEOUT(1) DragonFly General Commands Manual TIMEOUT(1)
timeout - run a command with a time limit
timeout [-k time | --kill-after time] [-s sig | --signal sig]
[-v | --verbose] [--foreground] [--preserve-status] duration
command [args ...]
timeout starts the command with its args. If the command is still
running after duration, it is killed. By default, SIGTERM is sent. The
special duration, zero, signifies no limit. Therefore a signal is never
sent if duration is 0.
The options are as follows:
-k time, --kill-after time
Send a SIGKILL signal if command is still running after time
after the first signal was sent.
-s sig, --signal sig
Specify the signal to send on timeout. By default, SIGTERM is
Show information to stderr about any signal sent on timeout.
Do not propagate timeout to the children of command.
Exit with the same status as command, even if it times out and is
The duration and time are non-negative integer or real (decimal) numbers,
with an optional unit-specifying suffix. Values without an explicit unit
are interpreted as seconds.
Supported unit symbols are:
If the timeout was not reached, the exit status of command is returned.
If the timeout was reached and --preserve-status is set, the exit status
of command is returned. If --preserve-status is not set, an exit status
of 124 is returned.
If an invalid parameter is passed to -s or -k, the exit status returned
If command is an otherwise invalid program, the exit status returned is
If command refers to a non-existing program, the exit status returned is
If command exits after receiving a signal, the exit status returned is
the signal number plus 128.
Run sleep(1) with a time limit of 4 seconds. Since the command completes
in 2 seconds, the exit status is 0:
$ timeout 4 sleep 2
$ echo $?
Run sleep(1) for 4 seconds and terminate process after 2 seconds. 124 is
returned since no --preserve-status is used:
$ timeout 2 sleep 4
$ echo $?
Same as above but preserving status. Exit status is 128 + signal number
(15 for SIGTERM)
$ timeout --preserve-status 2 sleep 4
$ echo $?
Same as above but sending SIGALRM (signal number 14) instead of SIGTERM
$ timeout --preserve-status -s SIGALRM 2 sleep 4
$ echo $?
Try to fetch(1) the single page version of the FreeBSD Handbook. Send a
SIGTERM signal after 1 minute and send a SIGKILL signal 5 seconds later
if the process refuses to stop:
timeout -k 5s 1m fetch \
The timeout command first appeared in FreeBSD 10.3, and was imported into
The FreeBSD work is compatible with GNU timeout by Padraig Brady, from
GNU Coreutils 8.21. The timeout utility first appeared in GNU Coreutils
Baptiste Daroussin <bapt@FreeBSD.org> and
Vsevolod Stakhov <vsevolod@FreeBSD.org>
DragonFly 5.9-DEVELOPMENT January 2, 2021 DragonFly 5.9-DEVELOPMENT