X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/af23fe4d694e2dc86e1c1ab453afdcd423752bcb..84ecb73f7fb419c725f32c0159a3c8048a2bd246:/README.qnx

diff --git a/README.qnx b/README.qnx
index c841bd6..a1c2e92 100644
--- a/README.qnx
+++ b/README.qnx
@@ -4,38 +4,36 @@ designed to be readable as is.
 
 =head1 NAME
 
-README.qnx - Perl version 5 on QNX
+perlqnx - Perl version 5 on QNX
 
 =head1 DESCRIPTION
 
-As of perl5.004_04, all tests pass under:
+As of perl5.7.2 all tests pass under:
 
-  QNX 4.23A
+  QNX 4.24G
   Watcom 10.6 with Beta/970211.wcc.update.tar.F
   socket3r.lib Nov21 1996.
 
-Update June 2001: Perl 5.6.1 works fine in QNX4 with
-a few 'known' failures in the test suite.
+As of perl5.8.1 there is at least one test still failing.
 
-[ Perl 5.6.0 is shipping with QNX RTP (aka QNX6, Neutrino), but
-the build does not appear to be straightforward. If anyone has
-more data in this regard, please let me know.
+Some tests may complain under known circumstances.
 
-These notes were originally written for QNX4 and do not
-necessarily apply to Neutrino, but see hints/qnx.sh for
-more information. ] 
+See below and hints/qnx.sh for more information.
 
-=head2 Required Software for Compiling Perl on QNX
+Under QNX 6.2.0 there are still a few tests which fail.
+See below and hints/qnx.sh for more information.
+
+=head2 Required Software for Compiling Perl on QNX4
 
 As with many unix ports, this one depends on a few "standard"
-unix utilities which are not necessarily standard for QNX.
+unix utilities which are not necessarily standard for QNX4.
 
 =over 4
 
 =item /bin/sh
 
 This is used heavily by Configure and then by
-perl itself. QNX's version is fine, but Configure
+perl itself. QNX4's version is fine, but Configure
 will choke on the 16-bit version, so if you are
 running QNX 4.22, link /bin/sh to /bin32/ksh
 
@@ -70,13 +68,25 @@ from quics for earlier versions.
 
 =back
 
-=head2 Outstanding Issues with Perl on QNX
+=head2 Outstanding Issues with Perl on QNX4
 
 There is no support for dynamically linked libraries in QNX4.
 
-The following tests may report errors:
-
-ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
+If you wish to compile with the Socket extension, you need
+to have the TCP/IP toolkit, and you need to make sure that
+-lsocket locates the correct copy of socket3r.lib. Beware
+that the Watcom compiler ships with a stub version of
+socket3r.lib which has very little functionality. Also
+beware the order in which wlink searches directories for
+libraries. You may have /usr/lib/socket3r.lib pointing to
+the correct library, but wlink may pick up
+/usr/watcom/10.6/usr/lib/socket3r.lib instead. Make sure
+they both point to the correct library, that is,
+/usr/tcptk/current/usr/lib/socket3r.lib.
+
+The following tests may report errors under QNX4:
+
+dist/Cwd/Cwd.t will complain if `pwd` and cwd don't give
 the same results. cwd calls `fullpath -t`, so if you
 cd `fullpath -t` before running the test, it will
 pass.
@@ -85,8 +95,13 @@ lib/File/Find/taint.t will complain if '.' is in your
 PATH. The PATH test is triggered because cwd calls
 `fullpath -t`.
 
-ext/IO/lib/IO/t/io_sock.t Still investigating
-ext/POSIX/sigaction.t Still investigating
+ext/IO/lib/IO/t/io_sock.t: Subtests 14 and 22 are skipped due to
+the fact that the functionality to read back the non-blocking
+status of a socket is not implemented in QNX's TCP/IP. This has
+been reported to QNX and it may work with later versions of
+TCP/IP.
+
+t/io/tell.t: Subtest 27 is failing. We are still investigating.
 
 =head2 QNX auxiliary files
 
@@ -100,9 +115,7 @@ A script that emulates the standard unix archive (aka library)
 utility.  Under Watcom 10.6, ar is linked to wlib and provides the
 expected interface. With Watcom 9.5, a cover function is
 required. This one is fairly crude but has proved adequate for
-compiling perl.  A more thorough version is available at:
-
-	http://www.fdma.com/pub/qnx/porting/ar
+compiling perl.
 
 =item qnx/cpp
 
@@ -113,6 +126,17 @@ options that perl throws at it. This might be reasonably placed in
 
 =back
 
+=head2 Outstanding issues with perl under QNX6
+
+The following tests are still failing for Perl 5.8.1 under QNX 6.2.0:
+
+  op/sprintf.........................FAILED at test 91
+  lib/Benchmark......................FAILED at test 26
+
+This is due to a bug in the C library's printf routine.
+printf("'%e'", 0. ) produces '0.000000e+0', but ANSI requires
+'0.000000e+00'. QNX has acknowledged the bug.
+
 =head1 AUTHOR
 
 Norton T. Allen (allen@huarp.harvard.edu)