This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Get rid of one Cygwin warning by introducing a prototype
[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
3ed0a8dd
NA
72If you wish to compile with the Socket extension, you need
73to have the TCP/IP toolkit, and you need to make sure that
74-lsocket locates the correct copy of socket3r.lib. Beware
75that the Watcom compiler ships with a stub version of
76socket3r.lib which has very little functionality. Also
77beware the order in which wlink searches directories for
78libraries. You may have /usr/lib/socket3r.lib pointing to
79the correct library, but wlink may pick up
80/usr/watcom/10.6/usr/lib/socket3r.lib instead. Make sure
81they both point to the correct library, that is,
82/usr/tcptk/current/usr/lib/socket3r.lib.
83
ecd6d377 84The following tests may report errors under QNX4:
af23fe4d
NA
85
86ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
87the same results. cwd calls `fullpath -t`, so if you
88cd `fullpath -t` before running the test, it will
89pass.
90
91lib/File/Find/taint.t will complain if '.' is in your
92PATH. The PATH test is triggered because cwd calls
93`fullpath -t`.
94
a181ddb7
NA
95ext/IO/lib/IO/t/io_sock.t: Subtest 14 is skipped due to
96the fact that the functionality to read back the non-blocking
97status of a socket is not implemented in QNX's TCP/IP. This
98has been reported to QNX and it may work with later versions
99of TCP/IP.
a83b6f46
JH
100
101=head2 QNX auxiliary files
ff68c719
PP
102
103The files in the "qnx" directory are:
104
a83b6f46
JH
105=over 4
106
107=item qnx/ar
108
109A script that emulates the standard unix archive (aka library)
110utility. Under Watcom 10.6, ar is linked to wlib and provides the
111expected interface. With Watcom 9.5, a cover function is
112required. This one is fairly crude but has proved adequate for
37a78d01 113compiling perl.
ff68c719 114
a83b6f46
JH
115=item qnx/cpp
116
117A script that provides C preprocessing functionality. Configure can
118generate a similar cover, but it doesn't handle all the command-line
119options that perl throws at it. This might be reasonably placed in
120/usr/local/bin.
121
210b36aa
AMS
122=back
123
ecd6d377
NA
124=head2 Outstanding issues with perl under QNX6
125
3ed0a8dd 126The following tests are still failing for Perl 5.7.3 under QNX 6.1.0:
ecd6d377
NA
127
128 op/sprintf.........................FAILED at test 91
3ed0a8dd
NA
129 lib/Benchmark......................FAILED at test 26
130
131This is due to a bug in the C library's printf routine.
132printf("'%e'", 0. ) produces '0.000000e+0', but ANSI requires
133'0.000000e+00'. QNX has acknowledged the bug and it should be
134fixed in 6.2.0.
ecd6d377 135
a83b6f46 136=head1 AUTHOR
ff68c719 137
ff68c719 138Norton T. Allen (allen@huarp.harvard.edu)
a83b6f46 139