Commit | Line | Data |
a83b6f46 |
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 |
5 | =head1 NAME |
6 | |
7 | README.qnx - Perl version 5 on QNX |
8 | |
9 | =head1 DESCRIPTION |
10 | |
11 | As of perl5.004_04, all tests pass under: |
12 | |
13 | QNX 4.23A |
14 | Watcom 10.6 with Beta/970211.wcc.update.tar.F |
15 | socket3r.lib Nov21 1996. |
16 | |
af23fe4d |
17 | Update June 2001: Perl 5.6.1 works fine in QNX4 with |
18 | a few 'known' failures in the test suite. |
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. ] |
a83b6f46 |
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, |
022735b4 |
61 | Configure will create its own wrapper which works, |
a83b6f46 |
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 | |
af23fe4d |
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 Still investigating |
89 | ext/POSIX/sigaction.t Still investigating |
a83b6f46 |
90 | |
91 | =head2 QNX auxiliary files |
ff68c719 |
92 | |
93 | The files in the "qnx" directory are: |
94 | |
a83b6f46 |
95 | =over 4 |
96 | |
97 | =item qnx/ar |
98 | |
99 | A script that emulates the standard unix archive (aka library) |
100 | utility. Under Watcom 10.6, ar is linked to wlib and provides the |
101 | expected interface. With Watcom 9.5, a cover function is |
102 | required. This one is fairly crude but has proved adequate for |
103 | compiling perl. A more thorough version is available at: |
ff68c719 |
104 | |
105 | http://www.fdma.com/pub/qnx/porting/ar |
106 | |
a83b6f46 |
107 | =item qnx/cpp |
108 | |
109 | A script that provides C preprocessing functionality. Configure can |
110 | generate a similar cover, but it doesn't handle all the command-line |
111 | options that perl throws at it. This might be reasonably placed in |
112 | /usr/local/bin. |
113 | |
114 | =back |
115 | |
116 | =head1 AUTHOR |
ff68c719 |
117 | |
ff68c719 |
118 | Norton T. Allen (allen@huarp.harvard.edu) |
a83b6f46 |
119 | |