mingw/html/pod/perlqnx.html

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>README.qnx - Perl version 5 on QNX</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:" />
   8 </head>
   9
  10 <body style="background-color: white">
  11 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  12 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  13 <big><strong><span class="block">&nbsp;README.qnx - Perl version 5 on QNX</span></strong></big>
  14 </td></tr>
  15 </table>
  16
  17 <p><a name="__index__"></a></p>
  18 <!-- INDEX BEGIN -->
  19
  20 <ul>
  21
  22         <li><a href="#name">NAME</a></li>
  23         <li><a href="#description">DESCRIPTION</a></li>
  24         <ul>
  25
  26                 <li><a href="#required_software_for_compiling_perl_on_qnx4">Required Software for Compiling Perl on QNX4</a></li>
  27                 <li><a href="#outstanding_issues_with_perl_on_qnx4">Outstanding Issues with Perl on QNX4</a></li>
  28                 <li><a href="#qnx_auxiliary_files">QNX auxiliary files</a></li>
  29                 <li><a href="#outstanding_issues_with_perl_under_qnx6">Outstanding issues with perl under QNX6</a></li>
  30         </ul>
  31
  32         <li><a href="#author">AUTHOR</a></li>
  33 </ul>
  34 <!-- INDEX END -->
  35
  36 <hr />
  37 <p>
  38 </p>
  39 <h1><a name="name">NAME</a></h1>
  40 <p>README.qnx - Perl version 5 on QNX</p>
  41 <p>
  42 </p>
  43 <hr />
  44 <h1><a name="description">DESCRIPTION</a></h1>
  45 <p>As of perl5.7.2 all tests pass under:</p>
  46 <pre>
  47   QNX 4.24G
  48   Watcom 10.6 with Beta/970211.wcc.update.tar.F
  49   socket3r.lib Nov21 1996.</pre>
  50 <p>As of perl5.8.1 there is at least one test still failing.</p>
  51 <p>Some tests may complain under known circumstances.</p>
  52 <p>See below and hints/qnx.sh for more information.</p>
  53 <p>Under QNX 6.2.0 there are still a few tests which fail.
  54 See below and hints/qnx.sh for more information.</p>
  55 <p>
  56 </p>
  57 <h2><a name="required_software_for_compiling_perl_on_qnx4">Required Software for Compiling Perl on QNX4</a></h2>
  58 <p>As with many unix ports, this one depends on a few ``standard''
  59 unix utilities which are not necessarily standard for QNX4.</p>
  60 <dl>
  61 <dt><strong><a name="item__2fbin_2fsh">/bin/sh</a></strong>
  62
  63 <dd>
  64 <p>This is used heavily by Configure and then by
  65 perl itself. QNX4's version is fine, but Configure
  66 will choke on the 16-bit version, so if you are
  67 running QNX 4.22, link /bin/sh to /bin32/ksh</p>
  68 </dd>
  69 </li>
  70 <dt><strong><a name="item_ar">ar</a></strong>
  71
  72 <dd>
  73 <p>This is the standard unix library builder.
  74 We use wlib. With Watcom 10.6, when wlib is
  75 linked as ``ar'', it behaves like ar and all is
  76 fine. Under 9.5, a cover is required. One is
  77 included in ../qnx</p>
  78 </dd>
  79 </li>
  80 <dt><strong><a name="item_nm">nm</a></strong>
  81
  82 <dd>
  83 <p>This is used (optionally) by configure to list
  84 the contents of libraries. I will generate
  85 a cover function on the fly in the UU directory.</p>
  86 </dd>
  87 </li>
  88 <dt><strong><a name="item_cpp">cpp</a></strong>
  89
  90 <dd>
  91 <p>Configure and perl need a way to invoke a C
  92 preprocessor. I have created a simple cover
  93 for cc which does the right thing. Without this,
  94 Configure will create its own wrapper which works,
  95 but it doesn't handle some of the command line arguments
  96 that perl will throw at it.</p>
  97 </dd>
  98 </li>
  99 <dt><strong><a name="item_make">make</a></strong>
 100
 101 <dd>
 102 <p>You really need GNU make to compile this. GNU make
 103 ships by default with QNX 4.23, but you can get it
 104 from quics for earlier versions.</p>
 105 </dd>
 106 </li>
 107 </dl>
 108 <p>
 109 </p>
 110 <h2><a name="outstanding_issues_with_perl_on_qnx4">Outstanding Issues with Perl on QNX4</a></h2>
 111 <p>There is no support for dynamically linked libraries in QNX4.</p>
 112 <p>If you wish to compile with the Socket extension, you need
 113 to have the TCP/IP toolkit, and you need to make sure that
 114 -lsocket locates the correct copy of socket3r.lib. Beware
 115 that the Watcom compiler ships with a stub version of
 116 socket3r.lib which has very little functionality. Also
 117 beware the order in which wlink searches directories for
 118 libraries. You may have /usr/lib/socket3r.lib pointing to
 119 the correct library, but wlink may pick up
 120 /usr/watcom/10.6/usr/lib/socket3r.lib instead. Make sure
 121 they both point to the correct library, that is,
 122 /usr/tcptk/current/usr/lib/socket3r.lib.</p>
 123 <p>The following tests may report errors under QNX4:</p>
 124 <p>ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
 125 the same results. cwd calls `fullpath -t`, so if you
 126 cd `fullpath -t` before running the test, it will
 127 pass.</p>
 128 <p>lib/File/Find/taint.t will complain if '.' is in your
 129 PATH. The PATH test is triggered because cwd calls
 130 `fullpath -t`.</p>
 131 <p>ext/IO/lib/IO/t/io_sock.t: Subtests 14 and 22 are skipped due to
 132 the fact that the functionality to read back the non-blocking
 133 status of a socket is not implemented in QNX's TCP/IP. This has
 134 been reported to QNX and it may work with later versions of
 135 TCP/IP.</p>
 136 <p>t/io/tell.t: Subtest 27 is failing. We are still investigating.</p>
 137 <p>
 138 </p>
 139 <h2><a name="qnx_auxiliary_files">QNX auxiliary files</a></h2>
 140 <p>The files in the ``qnx'' directory are:</p>
 141 <dl>
 142 <dt><strong><a name="item_qnx_2far">qnx/ar</a></strong>
 143
 144 <dd>
 145 <p>A script that emulates the standard unix archive (aka library)
 146 utility.  Under Watcom 10.6, ar is linked to wlib and provides the
 147 expected interface. With Watcom 9.5, a cover function is
 148 required. This one is fairly crude but has proved adequate for
 149 compiling perl.</p>
 150 </dd>
 151 </li>
 152 <dt><strong><a name="item_qnx_2fcpp">qnx/cpp</a></strong>
 153
 154 <dd>
 155 <p>A script that provides C preprocessing functionality.  Configure can
 156 generate a similar cover, but it doesn't handle all the command-line
 157 options that perl throws at it. This might be reasonably placed in
 158 /usr/local/bin.</p>
 159 </dd>
 160 </li>
 161 </dl>
 162 <p>
 163 </p>
 164 <h2><a name="outstanding_issues_with_perl_under_qnx6">Outstanding issues with perl under QNX6</a></h2>
 165 <p>The following tests are still failing for Perl 5.8.1 under QNX 6.2.0:</p>
 166 <pre>
 167   op/sprintf.........................FAILED at test 91
 168   lib/Benchmark......................FAILED at test 26</pre>
 169 <p>This is due to a bug in the C library's printf routine.
 170 printf(``'%e''', 0. ) produces '0.000000e+0', but ANSI requires
 171 '0.000000e+00'. QNX has acknowledged the bug.</p>
 172 <p>
 173 </p>
 174 <hr />
 175 <h1><a name="author">AUTHOR</a></h1>
 176 <p>Norton T. Allen (<a href="mailto:allen@huarp.harvard.edu">allen@huarp.harvard.edu</a>)</p>
 177 <table border="0" width="100%" cellspacing="0" cellpadding="3">
 178 <tr><td class="block" style="background-color: #cccccc" valign="middle">
 179 <big><strong><span class="block">&nbsp;README.qnx - Perl version 5 on QNX</span></strong></big>
 180 </td></tr>
 181 </table>
 182
 183 </body>
 184
 185 </html>