timeout(1) [freebsd man page]
TIMEOUT(1) BSD General Commands Manual TIMEOUT(1) NAME
timeout -- run a command with a time limit SYNOPSIS
timeout [--signal sig | -s sig] [--preserve-status] [--kill-after time | -k time] [--foreground] <duration> <command> <args ...> DESCRIPTION
timeout starts the command with its args. If command is still running after duration, it is killed. By default, SIGTERM. is sent. --preserve-status Always exits with the same status as command even if it times out. --foreground Do not propagate timeout to the command children. -s sig, --signal sig Specify the signal to send on timeout. By default, SIGTERM. is sent. -k time, --kill-after time Send a second kill signal if command is still running after time after the first signal was sent. DURATION FORMAT
duration and time can be integer or decimal numbers. Values without unit symbols are interpreted as seconds. Supported unit symbols are: s seconds m minutes h hours d days EXIT STATUS
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 command exits after receiving a signal, the exit status returned is the signal number plus 128. If command is an invalid command, the exit status returned is 126. If command is a non existing command, the exit status returned is 127. If an invalid parameter is passed to -s or -k, the exit status return is 125. SEE ALSO
kill(1), signal(3) BSD
Oct 28, 2014 BSD
Check Out this Related Man Page
TIMEOUT(1) 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. --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 --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, and --preserve-status is not set, then exit with status 124. Otherwise, exit with the status of COMMAND. If no signal is specified, send the TERM signal upon timeout. The TERM signal kills any process that does not block or catch that signal. It may be necessary to use the KILL (9) signal, since this signal cannot be caught, in which case the exit status is 128+9 rather than 124. GNU coreutils online help: <http://www.gnu.org/software/coreutils/> Report timeout translation bugs to <http://translationpro- ject.org/team/> BUGS
Some platforms don't curently support timeouts beyond 2038 AUTHOR
Written by Padraig Brady. COPYRIGHT
Copyright (C) 2013 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 redistribute it. There is NO WARRANTY, to the extent permitted by law. SEE ALSO
kill(1) The full documentation for timeout is maintained as a Texinfo 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. GNU coreutils 8.22 June 2014 TIMEOUT(1)