NAME
timeout - run a command with a time limitSYNOPSIS
timeout [ OPTION] DURATION COMMAND [ARG]...DESCRIPTION
Start COMMAND, and kill it if still running after DURATION. Mandatory arguments to long options are mandatory for short options too.--preserve-status
- exit with the same status as COMMAND, even when the
- command times out
--foreground
- when not running timeout directly from a shell prompt,
- allow COMMAND to read from the TTY and get TTY signals; 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
- -v, --verbose
- diagnose to stderr any signal sent upon timeout
- --help
- display this help and exit
- --version
- output version information and exit
EXIT status:
- 124
- if COMMAND times out, and --preserve-status is not specified
- 125
- if the timeout command itself fails
- 126
- if COMMAND is found but cannot be invoked
- 127
- if COMMAND cannot be found
- 137
- if COMMAND (or timeout itself) is sent the KILL (9) signal (128+9)
- -
- the exit status of COMMAND otherwise
BUGS
Some platforms don't currently support timeouts beyond the year 2038.AUTHOR
Written by Padraig Brady.REPORTING BUGS
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>COPYRIGHT
Copyright © 2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.SEE ALSO
kill(1) Full documentation <https://www.gnu.org/software/coreutils/timeout>September 2022 | GNU coreutils 9.1 |