diff options
author | Laurent Bercot <ska-skaware@skarnet.org> | 2021-02-02 16:59:14 +0000 |
---|---|---|
committer | Laurent Bercot <ska-skaware@skarnet.org> | 2021-02-02 16:59:14 +0000 |
commit | f9b855a56b13708e2224efa54060b90539406383 (patch) | |
tree | 5d1b8d20bc152e5d76521fe5eaf455233045f3fa /doc/if.html | |
parent | 631f809ce4a14ec6f1af5118b99adc514be7db60 (diff) | |
download | execline-f9b855a56b13708e2224efa54060b90539406383.tar.xz |
Make if propagate failure code
Diffstat (limited to 'doc/if.html')
-rw-r--r-- | doc/if.html | 17 |
1 files changed, 10 insertions, 7 deletions
diff --git a/doc/if.html b/doc/if.html index 700ee59..99be53e 100644 --- a/doc/if.html +++ b/doc/if.html @@ -38,19 +38,22 @@ then waits for it to complete. </li> <li> If <em>prog1</em> crashes, <tt>if</tt> prints an error message then exits 128 plus the number of the signal that killed <em>prog1</em>. </li> - <li> If <em>prog1</em> exits a non-zero status, -<tt>if</tt> exits 1.</li> + <li> If <em>prog1</em> exits with a non-zero code, <tt>if</tt> exits with an +<a href="exitcodes.html">approximation</a> of that code. </li> <li> Else <tt>if</tt> execs into <em>prog2</em>. </li> </ul> <h2> Options </h2> <ul> - <li> <tt>-X</tt> : treat a crash of <em>prog1</em> as a non-zero ("false") exit. - <li> <tt>-n</tt> : negate the test (exit on true, exec into <em>prog2</em> on false) </li> - <li> <tt>-x</tt> <em>exitcode</em> : exit <em>exitcode</em> instead of 1 if the test fails. </li> - <li> <tt>-t</tt> : exit 0 instead of 1 if the test fails. -This is equivalent to <tt>-x 0</tt>. </li> + <li> <tt>-X</tt> : treat a crash of <em>prog1</em> as a non-zero ("false") exit. This +is mostly useful in combination with <tt>-n</tt>. </li> + <li> <tt>-n</tt> : negate the test. If <em>prog1</em> exits true, then <tt>if</tt> will +exit 1; else it will exec into <em>prog2</em>. </li> + <li> <tt>-x</tt> <em>exitcode</em> : if <tt>if</tt> needs to exit, it will exit <em>exitcode</em> +instead of whatever else it would have exited. </li> + <li> <tt>-t</tt> : if <tt>if</tt> needs to exit, it will exit 0. This is equivalent +to <tt>-x 0</tt>. </li> </ul> <h2> Notes </h2> |