* xargs/xargs.1: the existing text described the status as of 2004, we
update it to point out that those things are still the case.
---
xargs/xargs.1 | 56 ++++++++++++++++++++++++++++++++++++++++++++++++---
1 file changed, 53 insertions(+), 3 deletions(-)
diff --git a/xargs/xargs.1 b/xargs/xargs.1
index 4cbcb3d6..7f7009c1 100644
--- a/xargs/xargs.1
+++ b/xargs/xargs.1
@@ -578,10 +578,11 @@ As of GNU
version 4.2.9 (2004), the default behaviour of
.B xargs
is not to have a logical end-of-file marker.
-POSIX (IEEE Std 1003.1, 2004 Edition) allows this.
+POSIX (IEEE Std 1003.1, 2004 Edition and also later editions) allows
+this.
.P
-The \-l and \-i options appear in the 1997 version of the POSIX
-standard, but do not appear in the 2004 version of the standard.
+The \-l and \-i options appeared in the 1997 edition of the POSIX
+standard, but do not appear in the 2004 or later editions.
Therefore you should use \-L and \-I instead, respectively.
.P
The \-o option is an extension to the POSIX standard for better
@@ -609,6 +610,55 @@ to terminate even if the
.B \-P
option was not used.
.
+.P
+The POSIX standard specifies that certain kinds of problem must result
+in particular
+.B xargs
+return values.
+The table below summarizes how these requirements relate to the
+values listed in the EXIT STATUS section.
+.TS
+box,tab(|);
+CbS |CbS
+Lb Lb|Lb Lb
+Lt Nt|Nt Ltx.
+POSIX requirement|GNU xargs behavior
+Situation|Exit status|Exit status | Details
+_|_|_|_
+Utility not found|127|127|T{
+.ad l
+.BR execvp (2)
+failed with
+.B errno
+value ENOENT
+T}
+_|_|_|_
+Utility could not be invoked|126|126|T{
+.ad l
+.BR execvp (2)
+failed with any other error
+T}
+_|_|_|_
+Any other non-success case|1 \- 125|125|T{
+.ad l
+Utility killed by a fatal signal
+T}
+\^|\^|124|T{
+Utility exited with status 255
+T}
+\^|\^|123|T{
+.ad l
+Utility exited with a status other than 0 or 255
+T}
+\^|\^|2 \- 122|May be used in the future
+\^|\^|1|T{
+.ad l
+Any other kind of error (such as a usage error)
+T}
+_|_|_|_
+Successful completion|0|0|
+.TE
+.
.SH "HISTORY"
.
The
--
2.47.3
