Encode tweaks for VMS
[perl.git] / README.qnx
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.
4
5 =head1 NAME
6
7 README.qnx - Perl version 5 on QNX
8
9 =head1 DESCRIPTION
10
11 As of perl5.7.2 all tests pass under:
12
13   QNX 4.24G
14   Watcom 10.6 with Beta/970211.wcc.update.tar.F
15   socket3r.lib Nov21 1996.
16
17 Some tests may complain under known circumstances. See
18 below and hints/qnx.sh for more information.
19
20 Under QNX 6.1.0 there are still a few tests which fail.
21 See below and hints/qnx.sh for more information.
22
23 =head2 Required Software for Compiling Perl on QNX4
24
25 As with many unix ports, this one depends on a few "standard"
26 unix utilities which are not necessarily standard for QNX4.
27
28 =over 4
29
30 =item /bin/sh
31
32 This is used heavily by Configure and then by
33 perl itself. QNX4's version is fine, but Configure
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,
56 Configure will create its own wrapper which works,
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
68 =head2 Outstanding Issues with Perl on QNX4
69
70 There is no support for dynamically linked libraries in QNX4.
71
72 The following tests may report errors under QNX4:
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
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.
88
89 =head2 QNX auxiliary files
90
91 The files in the "qnx" directory are:
92
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.
102
103 =item qnx/cpp
104
105 A script that provides C preprocessing functionality.  Configure can
106 generate a similar cover, but it doesn't handle all the command-line
107 options that perl throws at it. This might be reasonably placed in
108 /usr/local/bin.
109
110 =back
111
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
121 =head1 AUTHOR
122
123 Norton T. Allen (allen@huarp.harvard.edu)
124