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