summary refs log tree commit diff
path: root/doc/wait.html
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2016-10-15 20:35:23 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2016-10-15 20:35:23 +0000
commitff4ac0ca4b41deba5e3cb100bee23431c694963f (patch)
treeee3a1f9f0b76a8e6aa8201d93ebda12ae48a9f36 /doc/wait.html
parent86ae96a366603fdf6795692a9f089272bea424aa (diff)
downloadexecline-ff4ac0ca4b41deba5e3cb100bee23431c694963f.tar.gz
execline-ff4ac0ca4b41deba5e3cb100bee23431c694963f.tar.xz
execline-ff4ac0ca4b41deba5e3cb100bee23431c694963f.zip
Implement a timeout in wait
Diffstat (limited to 'doc/wait.html')
-rw-r--r--doc/wait.html18
1 files changed, 14 insertions, 4 deletions
diff --git a/doc/wait.html b/doc/wait.html
index 94587a1..913e17c 100644
--- a/doc/wait.html
+++ b/doc/wait.html
@@ -29,7 +29,7 @@
 </p>
 
 <pre>
-     wait [ -r ] { [ <em>pids...</em> ] } <em>prog...</em>
+     wait [ -I | -i ] [ -r | -t <em>timeout</em> ] { [ <em>pids...</em> ] } <em>prog...</em>
 </pre>
 
 <ul>
@@ -45,9 +45,19 @@ empty list, it waits for every child process it has. </li>
 <h2> Options </h2>
 
 <ul>
- <li> <tt>-r</tt>&nbsp;: reap mode. Do not pause until a child has
-exited; only reap all pending zombies. The read block must be empty
-for that option to be effective. </li>
+ <li> <tt>-r</tt>&nbsp;: equivalent to <tt>-t&nbsp;0</tt>. Do not
+pause: only reap processes that are already dead when <tt>wait</tt>
+is invoked. </li>
+ <li> <tt>-t</tt>&nbsp;<em>timeout</em>&nbsp;: wait for a maximum
+of <em>timeout</em> milliseconds. If there still are living processes
+among <em>pids...</em> (or among <tt>wait</tt>'s children if
+<em>pids...</em> is an empty list), after <em>timeout</em>
+milliseconds, they will not be reaped. </li>
+ <li> <tt>-I</tt>&nbsp;: loose. If <tt>wait</tt> times out while
+waiting for children to die, it will still
+exec into <em>prog...</em>. This is the default. </li>
+ <li> <tt>-i</tt>&nbsp;: strict. If <tt>wait</tt> times out, it
+will print an error message and exit 1. </li>
 </ul>
 
 </body>