summaryrefslogtreecommitdiff
path: root/pod/perlvar.pod
diff options
context:
space:
mode:
authorGisle Aas <gisle@aas.no>2005-05-18 01:35:47 -0700
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2005-05-18 16:08:30 +0000
commite5218da503dbb4980410e0018f4cc5dcba3ea666 (patch)
tree896f8cf586a22fa6f98384571dea2ba73b133df3 /pod/perlvar.pod
parent6b09c1601036c61459334bdedef5d7e29e07fcaf (diff)
downloadperl-e5218da503dbb4980410e0018f4cc5dcba3ea666.tar.gz
Well defined $? and introduction of ${^CHILD_ERROR_NATIVE} [PATCH]
Message-ID: <lr8y2cim24.fsf_-_@caliper.activestate.com> p4raw-id: //depot/perl@24501
Diffstat (limited to 'pod/perlvar.pod')
-rw-r--r--pod/perlvar.pod13
1 files changed, 12 insertions, 1 deletions
diff --git a/pod/perlvar.pod b/pod/perlvar.pod
index 53fe6c92c8..a9bbdaea57 100644
--- a/pod/perlvar.pod
+++ b/pod/perlvar.pod
@@ -617,7 +617,7 @@ L<perlfunc/formline()>.
The status returned by the last pipe close, backtick (C<``>) command,
successful call to wait() or waitpid(), or from the system()
operator. This is just the 16-bit status word returned by the
-wait() system call (or else is made up to look like it). Thus, the
+traditional Unix wait() system call (or else is made up to look like it). Thus, the
exit value of the subprocess is really (C<<< $? >> 8 >>>), and
C<$? & 127> gives which signal, if any, the process died from, and
C<$? & 128> reports whether there was a core dump. (Mnemonic:
@@ -643,6 +643,17 @@ status; see L<perlvms/$?> for details.
Also see L<Error Indicators>.
+=item ${^CHILD_ERROR_NATIVE}
+
+The native status returned by the last pipe close, backtick (C<``>)
+command, successful call to wait() or waitpid(), or from the system()
+operator. On POSIX-like systems this value can be decoded with the
+WIFEXITED, WEXITSTATUS, WIFSIGNALED, WTERMSIG, WIFSTOPPED, WSTOPSIG
+and WIFCONTINUED functions provided by the L<POSIX> module.
+
+Under VMS this reflects the actual VMS exit status; i.e. it is the same
+as $? when the pragma C<use vmsish 'status'> is in effect.
+
=item ${^ENCODING}
The I<object reference> to the Encode object that is used to convert