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 | |
17 | Update June 2001: Perl 5.6.1 most probably also works just fine in QNX. |
18 | |
19 | =head2 Required Software for Compiling Perl on QNX |
20 | |
21 | As with many unix ports, this one depends on a few "standard" |
22 | unix utilities which are not necessarily standard for QNX. |
23 | |
24 | =over 4 |
25 | |
26 | =item /bin/sh |
27 | |
28 | This is used heavily by Configure and then by |
29 | perl itself. QNX's version is fine, but Configure |
30 | will choke on the 16-bit version, so if you are |
31 | running QNX 4.22, link /bin/sh to /bin32/ksh |
32 | |
33 | =item ar |
34 | |
35 | This is the standard unix library builder. |
36 | We use wlib. With Watcom 10.6, when wlib is |
37 | linked as "ar", it behaves like ar and all is |
38 | fine. Under 9.5, a cover is required. One is |
39 | included in ../qnx |
40 | |
41 | =item nm |
42 | |
43 | This is used (optionally) by configure to list |
44 | the contents of libraries. I will generate |
45 | a cover function on the fly in the UU directory. |
46 | |
47 | =item cpp |
48 | |
49 | Configure and perl need a way to invoke a C |
50 | preprocessor. I have created a simple cover |
51 | for cc which does the right thing. Without this, |
52 | Configure will create it's own wrapper which works, |
53 | but it doesn't handle some of the command line arguments |
54 | that perl will throw at it. |
55 | |
56 | =item make |
57 | |
58 | You really need GNU make to compile this. GNU make |
59 | ships by default with QNX 4.23, but you can get it |
60 | from quics for earlier versions. |
61 | |
62 | =back |
63 | |
64 | =head2 Outstanding Issues with Perl on QNX |
65 | |
66 | There is currently no support for dynamically linked libraries. |
67 | |
68 | =head2 QNX auxiliary files |
ff68c719 |
69 | |
70 | The files in the "qnx" directory are: |
71 | |
a83b6f46 |
72 | =over 4 |
73 | |
74 | =item qnx/ar |
75 | |
76 | A script that emulates the standard unix archive (aka library) |
77 | utility. Under Watcom 10.6, ar is linked to wlib and provides the |
78 | expected interface. With Watcom 9.5, a cover function is |
79 | required. This one is fairly crude but has proved adequate for |
80 | compiling perl. A more thorough version is available at: |
ff68c719 |
81 | |
82 | http://www.fdma.com/pub/qnx/porting/ar |
83 | |
a83b6f46 |
84 | =item qnx/cpp |
85 | |
86 | A script that provides C preprocessing functionality. Configure can |
87 | generate a similar cover, but it doesn't handle all the command-line |
88 | options that perl throws at it. This might be reasonably placed in |
89 | /usr/local/bin. |
90 | |
91 | =back |
92 | |
93 | =head1 AUTHOR |
ff68c719 |
94 | |
ff68c719 |
95 | Norton T. Allen (allen@huarp.harvard.edu) |
a83b6f46 |
96 | |