diff options
| author | Laurent Bercot <ska-skaware@skarnet.org> | 2017-08-22 15:10:36 +0000 |
|---|---|---|
| committer | Laurent Bercot <ska-skaware@skarnet.org> | 2017-08-22 15:10:36 +0000 |
| commit | 523036ef1e6e4bd7047ec21a6e68b7508569db91 (patch) | |
| tree | 2612ec7431849a5b5d2b8b926dc8479a0f02e9e4 /doc | |
| parent | 6ead33f5fe46f38a63532daa95ec96bd39ecbfd8 (diff) | |
| download | execline-523036ef1e6e4bd7047ec21a6e68b7508569db91.tar.xz | |
More conversion to xpathexec, make exit code change consistent across binaries
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/exitcodes.html | 11 | ||||
| -rw-r--r-- | doc/index.html | 5 | ||||
| -rw-r--r-- | doc/upgrade.html | 2 |
3 files changed, 17 insertions, 1 deletions
diff --git a/doc/exitcodes.html b/doc/exitcodes.html index 7463bd1..51902f1 100644 --- a/doc/exitcodes.html +++ b/doc/exitcodes.html @@ -94,5 +94,16 @@ a scion of <em>C</em> had problems. </li> <li> Exact information is reported in the common case. </li> </ul> +<h2> Summary of common exit codes for execline programs </h2> + +<ul> + <li> 0: success. This code is rarely encountered, because most execline +programs chainload into something else when they succeed, instead of exiting 0. </li> + <li> 100: wrong usage </li> + <li> 111: system call failed </li> + <li> 126: unable to chainload into another program (any other error than ENOENT) </li> + <li> 127: unable to chainload into another program (executable not found) </li> +</ul> + </body> </html> diff --git a/doc/index.html b/doc/index.html index d39e3bd..929dbab 100644 --- a/doc/index.html +++ b/doc/index.html @@ -110,8 +110,11 @@ to your installation: the shebang lines for your system might be something like <p> All these commands exit 111 if they encounter a temporary error, and -100 if they encounter a permanent error - such as a misuse. +100 if they encounter a permanent error - such as a misuse. They exit +127 if they're trying to execute into a program and cannot find it, and +126 if they fail to execute into a program for another reason. </p> + <p> (Script parser / launcher) </p> diff --git a/doc/upgrade.html b/doc/upgrade.html index a954d63..d64d75d 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -22,6 +22,8 @@ <ul> <li> skalibs dependency bumped to 2.6.0.0 </li> + <li> Commands now exit 127 (not found) or 126 (other error) if +they cannot exec into a program they're supposed to. </li> <li> The <a href="import.html">import</a> command will likely disappear <em>very soon</em>. Please switch to <a href="importas.html">importas</a> as soon as possible! </li> |