timeout
(1)
Name
timeout - run a command with a time limit
Synopsis
timeout [OPTION] DURATION COMMAND [ARG]...
timeout [OPTION]
Description
User Commands TIMEOUT(1)
NAME
timeout - run a command with a time limit
SYNOPSIS
timeout [OPTION] DURATION COMMAND [ARG]...
timeout [OPTION]
DESCRIPTION
Start COMMAND, and kill it if still running after DURATION.
Mandatory arguments to long options are mandatory for short
options too.
--foreground
When not running timeout directly from a shell prompt,
allow COMMAND to read from the TTY and receive TTY sig-
nals. In this mode, children of COMMAND will not be
timed out.
-k, --kill-after=DURATION
also send a KILL signal if COMMAND is still running
this long after the initial signal was sent.
-s, --signal=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
--help
display this help and exit
--version
output version information and exit
DURATION is a floating point number with an optional suffix:
's' for seconds (the default), 'm' for minutes, 'h' for
hours or 'd' for days.
If the command times out, then exit with status 124. Other-
wise, exit with the status of COMMAND. If no signal is
specified, send the TERM signal upon timeout. The TERM sig-
nal kills any process that does not block or catch that sig-
nal. For other processes, it may be necessary to use the
KILL (9) signal, since this signal cannot be caught. If the
KILL (9) signal is sent, the exit status is 128+9 rather
than 124.
BUGS
Some platforms don't curently support timeouts beyond 2038
GNU coreutils 8.16 Last change: March 2012 1
User Commands TIMEOUT(1)
AUTHOR
Written by Padraig Brady.
REPORTING BUGS
Report timeout bugs to bug-coreutils@gnu.org
GNU coreutils home page: <http://www.gnu.org/software/core-
utils/>
General help using GNU software: <http://www.gnu.org/geth-
elp/>
Report timeout translation bugs to <http://translationpro-
ject.org/team/>
COPYRIGHT
Copyright (C) 2012 Free Software Foundation, Inc. License
GPLv3+: GNU GPL version 3 or later
<http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redis-
tribute it. There is NO WARRANTY, to the extent permitted
by law.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+--------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------+
|Availability | file/gnu-coreutils |
+---------------+--------------------+
|Stability | Uncommitted |
+---------------+--------------------+
SEE ALSO
kill(1)
The full documentation for timeout is maintained as a Tex-
info manual. If the info and timeout programs are properly
installed at your site, the command
info coreutils 'timeout invocation'
should give you access to the complete manual.
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz
Further information about this software can be found on the
GNU coreutils 8.16 Last change: March 2012 2
User Commands TIMEOUT(1)
open source community website at http://www.gnu.org/soft-
ware/coreutils/.
GNU coreutils 8.16 Last change: March 2012 3