[Summary view] [Print] [Text view]

   1  If you read this file _as_is_, just ignore the funny characters you see.
   2  It is written in the POD format (see pod/perlpod.pod) which is specially
   3  designed to be readable as is.
   4  
   5  =head1 NAME
   6  
   7  README.qnx - Perl version 5 on QNX
   8  
   9  =head1 DESCRIPTION
  10  
  11  As of perl5.7.2 all tests pass under:
  12  
  13    QNX 4.24G
  14    Watcom 10.6 with Beta/970211.wcc.update.tar.F
  15    socket3r.lib Nov21 1996.
  16  
  17  As of perl5.8.1 there is at least one test still failing.
  18  
  19  Some tests may complain under known circumstances.
  20  
  21  See below and hints/qnx.sh for more information.
  22  
  23  Under QNX 6.2.0 there are still a few tests which fail.
  24  See below and hints/qnx.sh for more information.
  25  
  26  =head2 Required Software for Compiling Perl on QNX4
  27  
  28  As with many unix ports, this one depends on a few "standard"
  29  unix utilities which are not necessarily standard for QNX4.
  30  
  31  =over 4
  32  
  33  =item /bin/sh
  34  
  35  This is used heavily by Configure and then by
  36  perl itself. QNX4's version is fine, but Configure
  37  will choke on the 16-bit version, so if you are
  38  running QNX 4.22, link /bin/sh to /bin32/ksh
  39  
  40  =item ar
  41  
  42  This is the standard unix library builder.
  43  We use wlib. With Watcom 10.6, when wlib is
  44  linked as "ar", it behaves like ar and all is
  45  fine. Under 9.5, a cover is required. One is
  46  included in ../qnx
  47  
  48  =item nm
  49  
  50  This is used (optionally) by configure to list
  51  the contents of libraries. I will generate
  52  a cover function on the fly in the UU directory.
  53  
  54  =item cpp
  55  
  56  Configure and perl need a way to invoke a C
  57  preprocessor. I have created a simple cover
  58  for cc which does the right thing. Without this,
  59  Configure will create its own wrapper which works,
  60  but it doesn't handle some of the command line arguments
  61  that perl will throw at it.
  62  
  63  =item make
  64  
  65  You really need GNU make to compile this. GNU make
  66  ships by default with QNX 4.23, but you can get it
  67  from quics for earlier versions.
  68  
  69  =back
  70  
  71  =head2 Outstanding Issues with Perl on QNX4
  72  
  73  There is no support for dynamically linked libraries in QNX4.
  74  
  75  If you wish to compile with the Socket extension, you need
  76  to have the TCP/IP toolkit, and you need to make sure that
  77  -lsocket locates the correct copy of socket3r.lib. Beware
  78  that the Watcom compiler ships with a stub version of
  79  socket3r.lib which has very little functionality. Also
  80  beware the order in which wlink searches directories for
  81  libraries. You may have /usr/lib/socket3r.lib pointing to
  82  the correct library, but wlink may pick up
  83  /usr/watcom/10.6/usr/lib/socket3r.lib instead. Make sure
  84  they both point to the correct library, that is,
  85  /usr/tcptk/current/usr/lib/socket3r.lib.
  86  
  87  The following tests may report errors under QNX4:
  88  
  89  ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
  90  the same results. cwd calls `fullpath -t`, so if you
  91  cd `fullpath -t` before running the test, it will
  92  pass.
  93  
  94  lib/File/Find/taint.t will complain if '.' is in your
  95  PATH. The PATH test is triggered because cwd calls
  96  `fullpath -t`.
  97  
  98  ext/IO/lib/IO/t/io_sock.t: Subtests 14 and 22 are skipped due to
  99  the fact that the functionality to read back the non-blocking
 100  status of a socket is not implemented in QNX's TCP/IP. This has
 101  been reported to QNX and it may work with later versions of
 102  TCP/IP.
 103  
 104  t/io/tell.t: Subtest 27 is failing. We are still investigating.
 105  
 106  =head2 QNX auxiliary files
 107  
 108  The files in the "qnx" directory are:
 109  
 110  =over 4
 111  
 112  =item qnx/ar
 113  
 114  A script that emulates the standard unix archive (aka library)
 115  utility.  Under Watcom 10.6, ar is linked to wlib and provides the
 116  expected interface. With Watcom 9.5, a cover function is
 117  required. This one is fairly crude but has proved adequate for
 118  compiling perl.
 119  
 120  =item qnx/cpp
 121  
 122  A script that provides C preprocessing functionality.  Configure can
 123  generate a similar cover, but it doesn't handle all the command-line
 124  options that perl throws at it. This might be reasonably placed in
 125  /usr/local/bin.
 126  
 127  =back
 128  
 129  =head2 Outstanding issues with perl under QNX6
 130  
 131  The following tests are still failing for Perl 5.8.1 under QNX 6.2.0:
 132  
 133    op/sprintf.........................FAILED at test 91
 134    lib/Benchmark......................FAILED at test 26
 135  
 136  This is due to a bug in the C library's printf routine.
 137  printf("'%e'", 0. ) produces '0.000000e+0', but ANSI requires
 138  '0.000000e+00'. QNX has acknowledged the bug.
 139  
 140  =head1 AUTHOR
 141  
 142  Norton T. Allen (allen@huarp.harvard.edu)
 143