timeout: add the --kill-after option
commitc403c31e8806b732e1164ef4a206b0eab71bca95
authorPádraig Brady <P@draigBrady.com>
Mon, 15 Mar 2010 23:03:30 +0000 (15 23:03 +0000)
committerPádraig Brady <P@draigBrady.com>
Tue, 16 Mar 2010 23:10:15 +0000 (16 23:10 +0000)
treec593bccff037db3c5f332810aec7dfbc33a30683
parent4edb86215deec3ad7478eb4eca54d563bd3b95c0
timeout: add the --kill-after option

Based on a report from Kim Hansen who wanted to
send a KILL signal to the monitored command
when `timeout` itself received a termination signal.
Rather than changing such a signal into a KILL,
we provide the more general mechanism of sending
the KILL after the specified grace period.

* src/timeout.c (cleanup): If a non zero kill delay
is specified, (re)set the alarm to that delay, after
which a KILL signal will be sent to the process group.
(usage): Mention the new option.  Separate the description
of DURATION since it's now specified in 2 places.
Clarify that the duration is an integer.
(parse_duration): A new function refactored from main(),
since this logic is now called for two parameters.
(main): Parse the -k option.
* doc/coreutils.texi (timeout invocation): Describe the
new --kill-after option and use @display rather than
@table to show the duration suffixes.  Clarify that
a duration of 0 disables the associated timeout.
* tests/misc/timeout-parameters: Check invalid --kill-after.
* tests/misc/timeout: Check a valid --kill-after works.
* NEWS: Mention the new feature.
NEWS
doc/coreutils.texi
src/timeout.c
tests/misc/timeout
tests/misc/timeout-parameters