doc: timeout: document the exit status when run with "-s KILL"

* src/timeout.c (usage): Document the exit status for this case,
in --help and thus in the man page.  Word so that it covers
both the -s9 and -k options.
* doc/coreutils.texi (timeout invocation): Document the exit
status for this case.

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 0d252fc..4a4cadb 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -15940,6 +15940,7 @@ Exit status:
 125 if @command{timeout} itself fails
 126 if @var{command} is found but cannot be invoked
 127 if @var{command} cannot be found
+137 if @var{command} is sent the KILL(9) signal (128+9)
 the exit status of @var{command} otherwise
 @end display
 

diff --git a/src/timeout.c b/src/timeout.c
index 73367c4..c0a2527 100644 (file)
--- a/src/timeout.c
+++ b/src/timeout.c
@@ -236,7 +236,8 @@ If the command times out, then exit with status 124.  Otherwise, exit\n\
 with the status of COMMAND.  If no signal is specified, send the TERM\n\
 signal upon timeout.  The TERM signal kills any process that does not\n\
 block or catch that signal.  For other processes, it may be necessary to\n\
-use the KILL (9) signal, since this signal cannot be caught.\n"), stdout);
+use the KILL (9) signal, since this signal cannot be caught.  If the\n\
+KILL (9) signal is sent, the exit status is 128+9 rather than 124.\n"), stdout);
       emit_ancillary_info ();
     }
   exit (status);