Go to main content

man pages section 1: User Commands

Exit Print View

Updated: July 2017
 
 

timeout (1)

Name

timeout - run a command with a time limit

Synopsis

timeout [OPTION] DURATION COMMAND [ARG]...
timeout [OPTION]

Description

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.

       --foreground

              When not running timeout directly from  a  shell  prompt,  allow
              COMMAND  to  read from the TTY and receive 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, 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.  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

AUTHOR
       Written by Padraig Brady.

REPORTING BUGS
       Report timeout bugs to bug-coreutils@gnu.org
       GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
       General help using GNU software: <http://www.gnu.org/gethelp/>
       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  redistribute  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 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.



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/core-
       utils-8.16.tar.xz

       Further information about this software can be found on the open source
       community website at http://www.gnu.org/software/coreutils/.



GNU coreutils 8.16                March 2012                        TIMEOUT(1)