README.qnx

   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.8.0 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 Some tests may complain under known circumstances. See
  18 below and hints/qnx.sh for more information.
  19
  20 [ Perl 5.6.0 is shipping with QNX RTP (aka QNX6, Neutrino), but
  21 the build does not appear to be straightforward. If anyone has
  22 more data in this regard, please let me know.
  23
  24 These notes were originally written for QNX4 and do not
  25 necessarily apply to Neutrino, but see hints/qnx.sh for
  26 more information. ]
  27
  28 =head2 Required Software for Compiling Perl on QNX
  29
  30 As with many unix ports, this one depends on a few "standard"
  31 unix utilities which are not necessarily standard for QNX.
  32
  33 =over 4
  34
  35 =item /bin/sh
  36
  37 This is used heavily by Configure and then by
  38 perl itself. QNX's version is fine, but Configure
  39 will choke on the 16-bit version, so if you are
  40 running QNX 4.22, link /bin/sh to /bin32/ksh
  41
  42 =item ar
  43
  44 This is the standard unix library builder.
  45 We use wlib. With Watcom 10.6, when wlib is
  46 linked as "ar", it behaves like ar and all is
  47 fine. Under 9.5, a cover is required. One is
  48 included in ../qnx
  49
  50 =item nm
  51
  52 This is used (optionally) by configure to list
  53 the contents of libraries. I will generate
  54 a cover function on the fly in the UU directory.
  55
  56 =item cpp
  57
  58 Configure and perl need a way to invoke a C
  59 preprocessor. I have created a simple cover
  60 for cc which does the right thing. Without this,
  61 Configure will create its own wrapper which works,
  62 but it doesn't handle some of the command line arguments
  63 that perl will throw at it.
  64
  65 =item make
  66
  67 You really need GNU make to compile this. GNU make
  68 ships by default with QNX 4.23, but you can get it
  69 from quics for earlier versions.
  70
  71 =back
  72
  73 =head2 Outstanding Issues with Perl on QNX
  74
  75 There is no support for dynamically linked libraries in QNX4.
  76
  77 The following tests may report errors:
  78
  79 ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
  80 the same results. cwd calls `fullpath -t`, so if you
  81 cd `fullpath -t` before running the test, it will
  82 pass.
  83
  84 lib/File/Find/taint.t will complain if '.' is in your
  85 PATH. The PATH test is triggered because cwd calls
  86 `fullpath -t`.
  87
  88 ext/IO/lib/IO/t/io_sock.t: Subtest 14 is skipped due to
  89 the fact that the functionality to read back the non-blocking
  90 status of a socket is not implemented in QNX's TCP/IP. This
  91 has been reported to QNX and it may work with later versions
  92 of TCP/IP.
  93
  94 =head2 QNX auxiliary files
  95
  96 The files in the "qnx" directory are:
  97
  98 =over 4
  99
 100 =item qnx/ar
 101
 102 A script that emulates the standard unix archive (aka library)
 103 utility.  Under Watcom 10.6, ar is linked to wlib and provides the
 104 expected interface. With Watcom 9.5, a cover function is
 105 required. This one is fairly crude but has proved adequate for
 106 compiling perl.  A more thorough version is available at:
 107
 108         http://www.fdma.com/pub/qnx/porting/ar
 109
 110 =item qnx/cpp
 111
 112 A script that provides C preprocessing functionality.  Configure can
 113 generate a similar cover, but it doesn't handle all the command-line
 114 options that perl throws at it. This might be reasonably placed in
 115 /usr/local/bin.
 116
 117 =back
 118
 119 =head1 AUTHOR
 120
 121 Norton T. Allen (allen@huarp.harvard.edu)
 122