138 lines
4.0 KiB
HTML
138 lines
4.0 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of TIMEOUT</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>TIMEOUT</H1>
|
|
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
timeout - run a command with a time limit
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>timeout</B>
|
|
|
|
[<I>,OPTION/</I>] <I>,DURATION COMMAND /</I>[<I>,ARG/</I>]...
|
|
<BR>
|
|
|
|
<B>timeout</B>
|
|
|
|
[<I>,OPTION/</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
<P>
|
|
|
|
Start COMMAND, and kill it if still running after DURATION.
|
|
<P>
|
|
|
|
Mandatory arguments to long options are mandatory for short options too.
|
|
<DL COMPACT>
|
|
<DT id="1">
|
|
<B>--preserve-status</B>
|
|
<DT id="2"><DD>
|
|
<DD>exit with the same status as COMMAND, even when the
|
|
<DT id="3"><DD>
|
|
command times out
|
|
<DT id="4">
|
|
<B>--foreground</B>
|
|
<DT id="5"><DD>
|
|
<DD>when not running timeout directly from a shell prompt,
|
|
<DT id="6"><DD>
|
|
allow COMMAND to read from the TTY and get TTY signals;
|
|
in this mode, children of COMMAND will not be timed out
|
|
<DT id="7">
|
|
<B>-k</B>, <B>--kill-after</B>=<I>,DURATION/</I>
|
|
<DT id="8"><DD>
|
|
<DD>also send a KILL signal if COMMAND is still running
|
|
<DT id="9"><DD>
|
|
this long after the initial signal was sent
|
|
<DT id="10">
|
|
<B>-s</B>, <B>--signal</B>=<I>,SIGNAL/</I>
|
|
<DT id="11"><DD>
|
|
<DD>specify the signal to be sent on timeout;
|
|
<DT id="12"><DD>
|
|
SIGNAL may be a name like 'HUP' or a number;
|
|
see 'kill <B>-l</B>' for a list of signals
|
|
<DT id="13"><B>-v</B>, <B>--verbose</B><DD>
|
|
diagnose to stderr any signal sent upon timeout
|
|
<DT id="14"><B>--help</B><DD>
|
|
display this help and exit
|
|
<DT id="15"><B>--version</B><DD>
|
|
output version information and exit
|
|
</DL>
|
|
<P>
|
|
|
|
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.
|
|
A duration of 0 disables the associated timeout.
|
|
<P>
|
|
|
|
If the command times out, and <B>--preserve-status</B> 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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Some platforms don't currently support timeouts beyond the year 2038.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Written by Padraig Brady.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>REPORTING BUGS</H2>
|
|
|
|
GNU coreutils online help: <<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>>
|
|
<BR>
|
|
|
|
Report timeout translation bugs to <<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © 2018 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>>.
|
|
<BR>
|
|
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+kill">kill</A>(1)
|
|
<P>
|
|
|
|
<BR>
|
|
|
|
Full documentation at: <<A HREF="https://www.gnu.org/software/coreutils/timeout">https://www.gnu.org/software/coreutils/timeout</A>>
|
|
<BR>
|
|
|
|
or available locally via: info '(coreutils) timeout invocation'
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="16"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="17"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="18"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="19"><A HREF="#lbAE">BUGS</A><DD>
|
|
<DT id="20"><A HREF="#lbAF">AUTHOR</A><DD>
|
|
<DT id="21"><A HREF="#lbAG">REPORTING BUGS</A><DD>
|
|
<DT id="22"><A HREF="#lbAH">COPYRIGHT</A><DD>
|
|
<DT id="23"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:28 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|