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