PERLQNX(1)       Perl Programmers Reference Guide      PERLQNX(1)



NAME
       README.qnx - Perl version 5 on QNX

DESCRIPTION
       As of perl5.7.2 all tests pass under:

         QNX 4.24G
         Watcom 10.6 with Beta/970211.wcc.update.tar.F
         socket3r.lib Nov21 1996.

       As of perl5.8.1 there is at least one test still failing.

       Some tests may complain under known circumstances.

       See below and hints/qnx.sh for more information.

       Under QNX 6.2.0 there are still a few tests which fail.
       See below and hints/qnx.sh for more information.

       Required Software for Compiling Perl on QNX4

       As with many unix ports, this one depends on a few "stan-
       dard" unix utilities which are not necessarily standard
       for QNX4.

       /bin/sh
           This is used heavily by Configure and then by 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

       ar  This is the standard unix library builder.  We use
           wlib. With Watcom 10.6, when wlib is linked as "ar",
           it behaves like ar and all is fine. Under 9.5, a cover
           is required. One is included in ../qnx

       nm  This is used (optionally) by configure to list the
           contents of libraries. I will generate a cover func-
           tion on the fly in the UU directory.

       cpp Configure and perl need a way to invoke a C preproces-
           sor. I have created a simple cover for cc which does
           the right thing. Without this, Configure will create
           its own wrapper which works, but it doesn't handle
           some of the command line arguments that perl will
           throw at it.

       make
           You really need GNU make to compile this. GNU make
           ships by default with QNX 4.23, but you can get it
           from quics for earlier versions.

       Outstanding Issues with Perl on QNX4

       There is no support for dynamically linked libraries in
       QNX4.

       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/wat-
       com/10.6/usr/lib/socket3r.lib instead. Make sure they both
       point to the correct library, that is, /usr/tcptk/cur-
       rent/usr/lib/socket3r.lib.

       The following tests may report errors under QNX4:

       ext/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.

       lib/File/Find/taint.t will complain if '.' is in your
       PATH. The PATH test is triggered because cwd calls `full-
       path -t`.

       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 investi-
       gating.

       QNX auxiliary files

       The files in the "qnx" directory are:

       qnx/ar
           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.

       qnx/cpp
           A script that provides C preprocessing functionality.
           Configure can generate a similar cover, but it doesn't
           handle all the command-line options that perl throws
           at it. This might be reasonably placed in
           /usr/local/bin.

       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.

AUTHOR
       Norton T. Allen (allen@huarp.harvard.edu)



perl v5.8.8                 2006-01-07                 PERLQNX(1)